Microsoft Bulut 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

AgreementMetaData kaynağı şu anda yalnızca Microsoft genel bulutunda İş Ortağı Merkezi tarafından desteklenmektedir.

Microsoft Müşteri Sözleşmesi, 2021 itibarıyla Microsoft Bulut Sözleşmesi'nin yerini aldı. Müşteriniz daha önce bir Microsoft Bulut Sözleşmesi imzalamışsa, Microsoft Müşteri Sözleşmesi geçmişine ek olarak bilinen son sözleşme geçmişi kullanılabilir olacaktır.

Ö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 uygulama + kullanıcı kimlik doğrulamayı destekler.

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

Microsoft Bulut Sözleşmesi için sözleşme meta verilerini almak için:

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

2. Koleksiyonu Microsoft Bulut Sözleşmesi.++++++++++++++++++++++++ olarak filtrelemek için ByAgreementType yöntemini çağırın

3. Son olarak Get veya GetAsync yöntemini çağır.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCloudAgreement";

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

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

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

Microsoft Bulut Sözleşmesi için sözleşme meta verilerini almak için:

Önce IAggregatePartner.AgreementDetails koleksiyonunu alın ve ardından Get veya GetAsync yöntemlerini çağırın. Ardından, Microsoft Bulut Sözleşmesi'ne karşılık gelen koleksiyondaki öğeyi arayın:

// IAggregatePartner partnerOperations;

var agreements = partnerOperations.AgreementDetails.Get();

AgreementMetaData microsoftCloudAgreement = agreements.Items.FirstOrDefault (agr => agr.AgreementType == AgreementType.MicrosoftCloudAgreement);

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.

Microsoft Bulut Sözleşmesi için sözleşme meta verilerini almak için:

Önce IAggregatePartner.getAgreementDetails işlevini çağırın ve sonra get işlevini çağırın. Ardından, Microsoft Bulut Sözleşmesi'ne karşılık gelen koleksiyondaki öğeyi arayın:

// IAggregatePartner partnerOperations;

ResourceCollection<AgreementMetaData> agreements = partnerOperations.getAgreements().get();

AgreementMetaData microsoftCloudAgreement;

for (AgreementMetaData metadata : agreements)
{
    if(metadata.getAgreementType() == AgreementType.MicrosoftCloudAgreement)
    {
        microsoftCloudAgreement = metadata;
    }
}

Konsol test uygulaması projesinden GetAgreementDetails 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.

Microsoft Bulut Sözleşmesi için sözleşme meta verilerini almak için:

Get-PartnerAgreementDetail komutunu kullanın. Ardından, Microsoft Bulut Sözleşmesi'ne karşılık gelen koleksiyondaki öğeyi arayın:

Get-PartnerAgreementDetail | Where-Object {$_.AgreementType -eq 'MicrosoftCloudAgreement'} | Select-Object -First 1

REST isteği

Microsoft Bulut Sözleşmesi'nin sözleşme meta verilerini almak için önce AgreementMetaData koleksiyonunu almak üzere bir REST İsteği oluşturun. Ardından, koleksiyonda Microsoft Bulut Sözleşmesi'ne karşılık gelen öğeyi arayın.

İstek söz dizimi

Metot	İstek URI'si
GET	{baseURL}/v1/sözleşmeler 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 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": "998b88de-aa99-4388-a42c-1b3517d49490",
            "agreementType": "MicrosoftCloudAgreement",
            "agreementLink": "https://learn.microsoft.com/partner-center/agreements",
            "versionRank": 0
        }
    ],
    "links": {
        "self": {
            "uri": "/agreements",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Yanıtta Microsoft Bulut Sözleşmesi'ne karşılık gelen kaynağı tanımlamak için agreementType özelliği "MicrosoftCloudAgreement" değerine sahip olan kaynağı arayın.