Aracılığıyla paylaş

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

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi

Geçerli değildir: 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

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

Önkoşullar

  • İş Ortağı Merkezi .NET SDK'sını kullanıyorsanız, sürüm 1.9 veya üzeri gereklidir.

    Önemli

    Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

    İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

  • İş Ortağı Merkezi Java SDK'sını kullanıyorsanız sürüm 1.8 veya üzeri gereklidir.

  • İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama + kullanıcı kimlik doğrulamayı destekler.

  • Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. 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ğiyle (customer-tenant-id) aynıdır.

.NET (sürüm 1.4 veya üzeri)

Daha önce sağlanan müşteri kabulü onaylarını almak için:

  • IAggregatePartner.Customers koleksiyonunu kullanın ve belirtilen müşteri tanımlayıcısıyla ById yöntemini çağırın.

  • Sözleşmeler özelliğini getirin ve ByAgreementType yöntemini çağırarak sonuçları Microsoft Bulut Sözleşmesi'ne filtreleyin.

  • Get veya GetAsync yöntemini çağır.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

Konsol test uygulaması projesinden GetCustomerAgreements sınıfında eksiksiz bir örnek bulunabilir.

.NET (sürüm 1.9 - 1.13)

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

IAggregatePartner.Customers koleksiyonunu kullanın ve belirtilen müşterinin tanımlayıcısıyla ById yöntemini çağırın. Ardından Agreements özelliğini alın ve ardından Get veya GetAsync yöntemlerini çağırın.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

Java

İş Ortağı Merkezi Java SDK'sı, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.

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

IAggregatePartner.getCustomers işlevini kullanın ve belirtilen müşterinin tanımlayıcısıyla byId işlevini çağırın. Ardından getAgreements işlevini alın ve ardından get işlevini çağırın.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

Konsol test uygulaması projesinden GetCustomerAgreements sınıfında eksiksiz bir örnek bulunabilir.

PowerShell

İş Ortağı Merkezi PowerShell modülü, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.

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

Get-PartnerCustomerAgreement komutunu kullanın.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

REST isteği

Daha önce sağlanan müşteri kabulünün onayını almak için aşağıdaki yönergelere bakın.

İlgili sertifikasyon bilgileriyle yeni bir Sözleşme kaynağı oluşturun.

İstek söz dizimi

Metot İstek URI'si
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI parametresi

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

Adı Tür Zorunlu Açıklama
CustomerTenantId GUID Y Değer, müşteri belirtmenize olanak tanıyan GUID biçimli customerTenantId değeridir.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements 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 Sözleşme kaynaklarının bir koleksiyonunu döndürür.

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

Her yanıt, başarılı veya başarısız olduğunu ve diğer hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş 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@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        }
    ]
}