Aracılığıyla paylaş

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

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

için 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ü GitHub'dan, yararlı bilgiler içeren bir benioku dosyasıyla birlikte 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ı'de açıklandığı şekliyle 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'ne göre 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();

GetAgreementDetails sınıfında konsol test uygulaması projesinden 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, İş 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. topluluk yardım alabilir veya bir sorunla karşılaşırsanız 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;
    }
}

GetAgreementDetails sınıfında konsol test uygulaması projesinden 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. topluluk yardım alabilir veya bir sorunla karşılaşırsanız 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 için 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

Yöntem İstek URI'si
AL {baseURL}/v1/agreements HTTP/1.1

URI parametreleri

İsteğinizle birlikte aşağıdaki URI parametrelerini kullanın:

İsim Tür Gerekli Açıklama
sözleşme türü dizgi 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:

MicrosoftCloudAgreement yalnızca MicrosoftCloudAgreement türündeki sözleşme meta verilerini içeren

MicrosoftCustomerAgreement yalnızca MicrosoftCustomerAgreement türündeki sözleşme meta verilerini içerir.

Tüm sözleşme meta verilerini döndüren *. (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 olmadığı sürece * kullanmayın.)

Not: URI parametresi belirtilmezse, geriye dönük uyumluluk için sorgu varsayılan olarak MicrosoftCloudAgreement olur.

İstek başlıkları

Daha fazla bilgi için bakınız İş Ortağı Merkezi'nin REST üst bilgileri.

İstek İçeriği

Hiç kimse.

İ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: aaaa0000-bb11-2222-33cc-444444dddddd

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesindeki AgreementMetaData kaynak 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: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "totalCount": 1,
    "items": [
        {
            "templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "agreementType": "MicrosoftCloudAgreement",
            "agreementLink": "/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.