Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini alma
Ş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
Microsoft Müşteri Sözleşmesi için sözleşme meta verileri şu anda yalnızca Microsoft genel bulutunda İş Ortağı Merkezi tarafından desteklenmektedir.
Aşağıdakileri yapabilirsiniz önce Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini almanız gerekir:
- Müşterinin Microsoft Müşteri Sözleşmesi kabul edildiğini onaylayın
- Microsoft Müşteri Sözleşmesi şablonu için indirme bağlantısı alma
Önkoşullar
İş Ortağı Merkezi .NET SDK'sını kullanıyorsanız, sürüm 1.14 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 kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik doğrulamalarını destekler.
.NET (sürüm 1.14 veya üzeri)
Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini almak için:
İlk olarak, IAggregatePartner.AgreementDetails koleksiyonunu alın.
Koleksiyonu Microsoft Müşteri Sözleşmesi olarak filtrelemek için ByAgreementType yöntemini çağırın.
Son olarak Get veya GetAsync yöntemini çağır.
// IAggregatePartner partnerOperations;
string agreementType = "MicrosoftCustomerAgreement";
var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
Konsol test uygulaması projesinden GetAgreementDetails sınıfında eksiksiz bir örnek bulunabilir.
REST isteği
Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini almak için:
AgreementMetaData koleksiyonunu almak için bir REST isteği oluşturun.
Sonucu yalnızca Microsoft Müşteri Sözleşmesi kapsamına almak için agreementType sorgu parametresini kullanın.
İstek söz dizimi
Metot | İstek URI'si |
---|---|
GET | {baseURL}/v1/agreements?agreementType={agreement-type} HTTP/1.1 |
URI parametreleri
İsteğinizle birlikte aşağıdaki URI parametrelerini kullanın:
Adı | Tür | Zorunlu | Açıklama |
---|---|---|---|
sözleşme türü | Dize | Hayır | Sorgu yanıtını belirli bir sözleşme türüne göre kapsamak için bu parametreyi kullanın. Desteklenen değerler şunlardır: Yalnızca MicrosoftCloudAgreement türünde sözleşme meta verilerini içeren MicrosoftCloudAgreement Yalnızca MicrosoftCustomerAgreement türünde sözleşme meta verilerini içeren MicrosoftCustomerAgreement. * tüm sözleşme meta verilerini döndürür. (Microsoft herhangi bir zamanda yeni sözleşme türleriyle sözleşme meta verilerini kullanıma sunabileceğinden, kodunuz bilinmeyen sözleşme türlerini işlemek için gerekli çalışma zamanı mantığına sahip değilse kullanmayın * .) Not: URI parametresi belirtilmezse, geriye dönük uyumluluk için sorgu varsayılan olarak MicrosoftCloudAgreement olur. |
İ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/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övdesindeki AgreementMetaData 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": 1,
"items": [
{
"templateId": "117a77b0-9360-443b-8795-c6dedc750cf9",
"agreementType": "MicrosoftCustomerAgreement",
"agreementLink": "https://aka.ms/customeragreement",
"versionRank": 0
}
],
"attributes": {
"objectType": "Collection"
}
}