Sdílet prostřednictvím


Získání metadat smlouvy pro smlouvu se zákazníkem Microsoftu

platí pro: Partnerské centrum

Nevztahuje se na: Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Metadata smlouvy pro smlouvu se zákazníkem Microsoftu v současné době podporují Partnerské centrum pouze ve veřejném cloudu Microsoftu.

Než budete moct, musíte načíst metadata smlouvy pro smlouvu se zákazníkem Microsoftu:

Požadavky

  • Pokud používáte sadu .NET SDK partnerského centra, vyžaduje se verze 1.14 nebo novější.

    Důležitý

    Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Verzi sady SDK můžete stáhnout z GitHubuspolečně s souborem readme, který obsahuje užitečné informace.

    Doporučujeme, aby partneři nadále používali rozhraní REST API Partnerského centra.

  • Přihlašovací údaje, jak jsou popsány v autentizaci v Partnerském centru. Tento scénář podporuje pouze ověřování aplikací a uživatelů.

.NET (verze 1.14 nebo novější)

Načtení metadat smlouvy pro smlouvu se zákazníkem Microsoftu:

  1. Nejprve načtěte kolekci IAggregatePartner.AgreementDetails.

  2. Voláním metody ByAgreementType vyfiltrujte kolekci podle smlouvy se zákazníkem Microsoftu.

  3. Nakonec volejte metodu Get nebo GetAsync.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

Úplnou ukázku najdete v GetAgreementDetails třídě z projektu konzolové testovací aplikace.

Požadavek REST

Pro načtení metadat smlouvy pro Microsoft Customer Agreement:

  1. Vytvořte požadavek REST pro načtení kolekce AgreementMetaData.

  2. Pro omezení výsledku pouze na Microsoft Customer Agreement použijte parametr dotazu agreementType.

Syntaxe požadavku

Metoda Identifikátor URI požadavku
ZÍSKEJ {baseURL}/v1/agreements?agreementType={agreement-type} HTTP/1.1

Parametry identifikátoru URI

V požadavku použijte následující parametry identifikátoru URI:

Jméno Typ Povinný Popis
typ smlouvy řetězec Ne Tento parametr použijte k určení rozsahu odpovědi dotazu na konkrétní typ smlouvy. Podporované hodnoty jsou:

MicrosoftCloudAgreement, která obsahují pouze metadata smlouvy typu MicrosoftCloudAgreement

MicrosoftCustomerAgreement, který obsahuje metadata smlouvy pouze typu MicrosoftCustomerAgreement.

*, která vrátí všechna metadata smlouvy. (Nepoužívejte *, pokud váš kód nemá potřebnou logiku modulu runtime pro zpracování neznámých typů smluv, protože Microsoft může kdykoli zavést metadata smlouvy s novými typy smluv.)

Poznámka: Pokud není zadaný parametr identifikátoru URI, má dotaz výchozí hodnotu MicrosoftCloudAgreement kvůli zpětné kompatibilitě.

Hlavičky požadavku

Další informace najdete v REST hlavičkách Partnerského centra.

Text požadavku

Žádný.

Příklad požadavku

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

Odpověď REST

V případě úspěchu tato metoda vrátí v textu odpovědi kolekci prostředků AgreementMetaData.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění.

Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete viz chybové kódy REST API v Partner Center.

Příklad odpovědi

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": "MicrosoftCustomerAgreement",
            "agreementLink": "https://aka.ms/customeragreement",
            "versionRank": 0
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}