Pobieranie metadanych umowy dla umowy dotyczącej platformy Microsoft Cloud

Dotyczy: Centrum partnerskie

Nie dotyczy: Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Zasób AgreementMetaData jest obecnie obsługiwany przez Centrum partnerskie tylko w chmurze publicznej firmy Microsoft.

Od 2021 r. Umowa z Klientem Microsoft zastąpiła umowę Microsoft Cloud Agreement. Jeśli klient wcześniej podpisał umowę Microsoft Cloud Agreement, jego ostatnia znana historia umowy będzie dostępna oprócz historii Umowa z Klientem Microsoft.

Wymagania wstępne

• Jeśli używasz zestawu .NET SDK Centrum partnerskiego, wymagana jest wersja 1.9 lub nowsza.

  Ważne

  Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z usługi GitHub wraz z plikiem readme zawierającym przydatne informacje.

  Zachęcamy partnerów do dalszego korzystania z interfejsów API REST Centrum partnerskiego.

• Jeśli używasz zestawu JAVA SDK Centrum partnerskiego, wymagana jest wersja 1.8 lub nowsza.

• Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie aplikacji i użytkowników.

.NET (wersja 1.14 lub nowsza)

Aby pobrać metadane umowy dla umowy Microsoft Cloud Agreement:

1. Najpierw pobierz kolekcję IAggregatePartner.AgreementDetails .

2. Wywołaj metodę ByAgreementType , aby przefiltrować kolekcję do umowy Microsoft Cloud Agreement.++++++++++++++++++++++++

3. Na koniec wywołaj metodę Get lub GetAsync .

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCloudAgreement";

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

Kompletny przykład można znaleźć w klasie GetAgreementDetails z projektu aplikacji testowej konsoli.

.NET (wersja 1.9 — 1.13)

Aby pobrać metadane umowy dla umowy Microsoft Cloud Agreement:

Najpierw pobierz kolekcję IAggregatePartner.AgreementDetails , a następnie wywołaj metody Get lub GetAsync . Następnie wyszukaj element w kolekcji, który odpowiada umowie dotyczącej chmury firmy Microsoft:

// IAggregatePartner partnerOperations;

var agreements = partnerOperations.AgreementDetails.Get();

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

Java

Zestaw SDK Java Centrum partnerskiego może służyć do zarządzania zasobami Centrum partnerskiego. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub .

Aby pobrać metadane umowy dla umowy Microsoft Cloud Agreement:

Najpierw wywołaj funkcję IAggregatePartner.getAgreementDetails , a następnie wywołaj funkcję get . Następnie wyszukaj element w kolekcji, który odpowiada umowie dotyczącej chmury firmy Microsoft:

// IAggregatePartner partnerOperations;

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

AgreementMetaData microsoftCloudAgreement;

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

Kompletny przykład można znaleźć w klasie GetAgreementDetails z projektu aplikacji testowej konsoli.

PowerShell

Moduł PowerShell Centrum partnerskiego może służyć do zarządzania zasobami Centrum partnerskiego. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub .

Aby pobrać metadane umowy dla umowy Microsoft Cloud Agreement:

Użyj polecenia Get-PartnerAgreementDetail. Następnie wyszukaj element w kolekcji, który odpowiada umowie dotyczącej chmury firmy Microsoft:

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

Żądanie REST

Aby pobrać metadane umowy dla umowy Microsoft Cloud Agreement, najpierw utwórz żądanie REST w celu pobrania kolekcji AgreementMetaData . Następnie wyszukaj element w kolekcji, który odpowiada umowie Microsoft Cloud Agreement.

Składnia żądania

Method	Identyfikator URI żądania
GET	{baseURL}/v1/agreement HTTP/1.1

Parametry identyfikatora URI

Użyj następujących parametrów identyfikatora URI z żądaniem:

Nazwisko	Type	Wymagania	opis
typ umowy	string	Nie	Użyj tego parametru, aby określić zakres odpowiedzi zapytania na określony typ umowy. Obsługiwane wartości to: MicrosoftCloudAgreement , który zawiera metadane umowy tylko typu MicrosoftCloudAgreement MicrosoftCustomerAgreement , który zawiera metadane umowy tylko typu MicrosoftCustomerAgreement. * zwraca wszystkie metadane umowy. (Nie używaj * , chyba że kod ma niezbędną logikę środowiska uruchomieniowego do obsługi nieznanych typów umów, ponieważ firma Microsoft może wprowadzać metadane umowy z nowymi typami umów w dowolnym momencie). Uwaga: jeśli parametr URI nie jest określony, zapytanie jest domyślnie ustawione na MicrosoftCloudAgreement w celu zapewnienia zgodności z poprzednimi wersjami.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

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

Odpowiedź REST

Jeśli ta metoda powiedzie się, zwraca kolekcję zasobów AgreementMetaData w treści odpowiedzi.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i inne informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

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"
    }
}

Aby zidentyfikować zasób w odpowiedzi odpowiadającej umowie Microsoft Cloud Agreement, poszukaj zasobu, którego właściwość agreementType ma wartość "MicrosoftCloudAgreement".