Iş Ortağı Merkezi API 'Lerini kullanarak Microsoft Müşteri sözleşmesinin müşteri kabulünü onaylama

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

İş ortağı merkezi şu anda Microsoft Müşteri sözleşmesinin yalnızca Microsoft genel bulutundaki müşteri kabulünün onayını desteklemektedir.

Bu makalede, Microsoft Müşteri sözleşmesinin müşteri kabulünü onaylama veya yeniden onaylama işlemlerinin nasıl yapılacağı açıklanı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 .

• Müşteri Microsoft Müşteri anlaşmasını kabul ettiğinde Tarih (kabul edildi).

• Müşteri kuruluşundan, Microsoft Müşteri anlaşmasını kabul eden kullanıcı hakkında bilgiler. Şunları içerir:

  • Ad
  • Soyadı
  • E-posta adresi
  • Telefon numarası (isteğe bağlı)

• bir müşteri için aşağıdaki değerler değişiyorsa, iş ortağı merkezi bu müşteri için başka bir sözleşmenin oluşturulmasını sağlayacaktır: ad adı soyadı e-posta adresi Telefon numarası aksi takdirde iş ortakları, oluşturulan yinelenen bir müşteri nedeniyle aşağıdaki hata kodunu alır

{
"code": 600061,
"message": "A partner confirmed agreement already exists for the customer.",
"description": "A partner confirmed agreement already exists for the customer.",
"errorName": "PartnerConfirmedAgreementAlreadyExists",
"isRetryable": false,
"parameters": {},
"errorMessageExtended": "InternalErrorCode=600061"
}

.NET

Microsoft Müşteri sözleşmesinin müşteri kabulünü onaylamak veya yeniden doğrulamak için:

1. Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini alın. Microsoft Müşteri sözleşmesinin TemplateId 'sini edinmeniz gerekir. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini edinme.

   // IAggregatePartner partnerOperations;
   
   string agreementType = "MicrosoftCustomerAgreement";
   
   var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
   

2. Onayın ayrıntılarını içeren yeni bir anlaşma nesnesi oluşturun.

3. Iagreggatepartner. Customers koleksiyonunu kullanın ve belirtilen Müşteri Kiracı kimliğiile byıd yöntemini çağırın.

4. , Ardından Create veya createasyncçağrısı yaparak anlaşmalar özelliğini kullanın.

   // string selectedCustomerId;
   
   var agreementToCreate = new Agreement
   {
       DateAgreed = DateTime.UtcNow,
       TemplateId = microsoftCustomerAgreementDetails.TemplateId,
       PrimaryContact = new Contact
       {
           FirstName = "Tania",
           LastName = "Carr",
           Email = "someone@example.com",
           PhoneNumber = "1234567890"
       }
   };
   
   Agreement agreement = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Create(agreementToCreate);
   

Konsol test uygulaması projesinden createcustomeragreement sınıfında bir bütün örnek bulunabilir.

REST isteği

Microsoft Müşteri sözleşmesinin müşteri kabulünü onaylamak veya yeniden doğrulamak için:

1. Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini alın. Microsoft Müşteri sözleşmesinin TemplateId 'sini edinmeniz gerekir. Daha fazla bilgi için bkz. Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini edinme.

2. Müşterinin Microsoft Müşteri anlaşmasını kabul ettiğini onaylamak için yeni bir anlaşma kaynağı oluşturun. Aşağıdaki rest istek sözdiziminikullanın.

İstek sözdizimi

URI parametresi

Onayladığınız müşteriyi belirtmek için aşağıdaki sorgu parametresini kullanın.

İstek üst bilgileri

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

İstek gövdesi

Bu tabloda, REST istek gövdesinde gereken özellikler açıklanmaktadır.

Sözleşme

Bu tablo, bir anlaşma kaynağıoluşturmak için gereken en düşük alanları açıklar.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}

REST yanıtı

Başarılı olursa, bu yöntem bir anlaşma kaynağı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 201 Created
Content-Length: 261
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "userId": "3d6f2c09-eb40-48ca-a4b3-d24c9c007531",
    "primaryContact": {
        "firstName": "Tania",
        "lastName": "Carr",
        "email": "someone@example.com",
        "phoneNumber": "1234567890"
    },
    "templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
    "dateAgreed": "2018-06-14T00:00:00.000Z",
    "type": "MicrosoftCustomerAgreement"
}