Microsoft Müşteri Sözleşmesi için anlaşma meta verilerini alma

  • Makale
  • Okumak için 2 dakika

Uygulama:İş Ortağı Merkezi

için geçerli değildir:İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government

İş yüklerini Microsoft Müşteri Sözleşmesi meta verileri şu anda yalnızca Microsoft İş Ortağı Merkezi bulut üzerinde desteklene bir hizmettir.

Şunların öncesinde, Microsoft Müşteri Sözleşmesi için sözleşme meta verilerini alalız:

Önkoşullar

  • İş Ortağı Merkezi .NET SDK kullanıyorsanız sürüm 1.14 veya daha yenisi gereklidir.

  • kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo yalnızca App+User kimlik doğrulamasını destekler.

.NET (sürüm 1.14 veya daha yenisi)

Aşağıdakiler için sözleşme meta verilerini Microsoft Müşteri Sözleşmesi:

  1. İlk olarak IAggregatePartner.AgreementDetails koleksiyonunu alın.

  2. Koleksiyonu filtre olarak filtrelemek için ByAgreementType yöntemini Microsoft Müşteri Sözleşmesi.

  3. Son olarak Get veyaGetAsync yöntemini arayın.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

var microsoftCustomerAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();

Eksiksiz bir örnek, konsol test uygulaması projesinden GetAgreementDetailssınıfında bulunabilir.

REST isteği

Aşağıdakiler için sözleşme meta verilerini Microsoft Müşteri Sözleşmesi:

  1. AgreementMetaData koleksiyonunu almak için bir REST isteği oluşturun.

  2. AgreementType sorgu parametresini kullanarak sonucun kapsamını yalnızca Microsoft Müşteri Sözleşmesi.

İstek söz dizimi

Yöntem İstek URI'si
GET {baseURL}/v1/agreements?agreementType={agreement-type} HTTP/1.1

URI parametreleri

Ad Tür Gerekli Açıklama
sözleşme türü dize No Sorgu yanıtının kapsamını belirli bir anlaşma türüne göre yapmak için bu parametreyi kullanın. Desteklenen değerler:

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. (Kodunuzun, microsoft herhangi bir zamanda yeni anlaşma türleriyle sözleşme meta verileri tanıtabilir, çünkü microsoft, yabancı anlaşma türlerini işlemek için gerekli çalışma zamanı mantığına sahip * değilse bunu kullanma.)

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.

İstek gövdesi

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övdesinde AgreementMetaData kaynaklarının bir koleksiyonunu döndürür.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir.

Bu kodu, hata türünü ve ek 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"
    }
}