Microsoft Müşteri Sözleşmesinin müşteri kabulünün onayını alma

  • Makale
  • Okumak için 2 dakika

Uygulama hedefi: Iş Ortağı Merkezi

Şu şekilde geçerlidir: 21Vianet tarafından çalıştırılan Iş Ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi | Microsoft Cloud for US Government için iş ortağı Merkezi

Sözleşme kaynağı şu anda yalnızca Microsoft genel bulutundaki Iş Ortağı Merkezi tarafından desteklenmektedir.

Bu makalede, bir müşterinin Microsoft Müşteri Sözleşmesi 'nin kabul edilmesine ilişkin onay (ler) i nasıl alabileceğiniz açıklanmaktadır.

Önkoşullar

  • Iş ortağı merkezi .NET SDK kullanıyorsanız sürüm 1,14 veya daha yeni bir sürümü gereklidir.

  • Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama + kullanıcı kimlik doğrulamasını destekler.

  • Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. Müşterinin hesap sayfasında, müşteri hesabı bilgileri bölümünde Microsoft kimliği ' ni arayın. Microsoft KIMLIĞI, müşteri KIMLIĞI () ile aynıdır customer-tenant-id .

.NET

Daha önce sağlanmış olan müşteri kabulünün onayını almak için:

  • Belirtilen müşteri tanımlayıcısıyla ıaggregatepartner. Customers koleksiyonunu ve Call byıd metodunu kullanın.

  • Byagreementtype metodunu çağırarak anlaşmalar özelliğini getirin ve sonuçları Microsoft Müşteri sözleşmesine filtreleyin.

  • Get veya GetAsync metodunu çağırın.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Tüm örnek, konsol test uygulaması projesinden getcustomersözleşmeleri sınıfında bulunabilir.

REST isteği

Daha önce sağlanmış olan müşteri kabulünün onayını almak için:

  1. Müşterinin anlaşmalar koleksiyonunu almak IÇIN bir rest isteği oluşturun.

  2. Sonuçların kapsamını yalnızca Microsoft Müşteri anlaşmasıyla sınırlamak için agreementType sorgu parametresini kullanın.

İstek sözdizimi

Aşağıdaki istek sözdizimini kullanın:

Yöntem İstek URI'si
GET {BaseUrl}/v1/Customers/{Customer-Tenant-ID}/sözleşmeleri? agreementType = {Agreement-Type} http/1.1

URI parametreleri

İsteğinizle birlikte aşağıdaki URI parametrelerini kullanabilirsiniz:

Ad Tür Gerekli Açıklama
Müşteri-Kiracı kimliği GUID Yes Değer, bir müşteriyi belirtmenizi sağlayan bir GUID biçimli Customertenantıd 'dir.
anlaşma türü dize No Bu parametre tüm anlaşma meta verilerini döndürür. Sorgu yanıtının belirli anlaşma türüne kapsamını atamak için bu parametreyi kullanın. Desteklenen değerler şunlardır:

Microsoftcloudagreement yalnızca microsoftcloudagreementtürünün anlaşma meta verilerini içerir.

Microsoftcustomeragreement yalnızca microsoftcustomeragreementtüründe anlaşma meta verilerini içerir.

* Bu, tüm anlaşma meta verilerini döndürür. ( * Kodunuz, beklenmeyen anlaşma türlerini işlemek için gerekli mantığa sahip değilse kullanmayın.)

Note: URI parametresi belirtilmemişse, sorgu geri uyumluluk için varsayılan olarak Microsoftcloudagreement olur. Microsoft, Sözleşme meta verilerini dilediğiniz zaman yeni anlaşma türleriyle ortaya çıkarabilir.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde anlaşma kaynaklarının bir koleksiyonunu döndürür.

Yanıt başarısı ve hata kodları

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir.

Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Iş ortağı MERKEZI Rest hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}