Metagegevens van overeenkomst ophalen voor de Microsoft-klantovereenkomst

Artikel
03/08/2025

van toepassing op: Partnercentrum

Is niet van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Metagegevens van overeenkomsten voor de Microsoft-klantovereenkomst worden momenteel alleen ondersteund door het Partnercentrum in de Microsoft-public cloud.

U moet de metagegevens van de overeenkomst voor de Microsoft-klantovereenkomst ophalen voordat u het volgende kunt doen:

Voorwaarden

Als u de .NET SDK van Partnercentrum gebruikt, is versie 1.14 of hoger vereist.

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de Partner center REST API'ste blijven gebruiken.
Referenties zoals beschreven in Partnercentrum-authenticatie. Dit scenario biedt alleen ondersteuning voor App+User-verificatie.

.NET (versie 1.14 of hoger)

De metagegevens van de overeenkomst voor Microsoft-klantovereenkomst ophalen:

Haal eerst de verzameling IAggregatePartner.AgreementDetails op.
Roep de methode ByAgreementType aan om de verzameling te filteren op een Microsoft-klantovereenkomst.
Tenslotte, roep de methode Get of GetAsync aan.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCustomerAgreement";

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

Een volledig voorbeeld vindt u in de GetAgreementDetails klasse uit de consoletest-app project.

REST-aanvraag

De metagegevens van de overeenkomst voor Microsoft-klantovereenkomst ophalen:

Maak een REST-aanvraag om de verzameling AgreementMetaData op te halen.
Gebruik de queryparameter agreementType om het resultaat alleen te beperken tot de Microsoft-klantovereenkomst.

Aanvraagsyntaxis

Methode	Aanvraag-URI
HALEN	{baseURL}/v1/agreements?agreementType={agreement-type} HTTP/1.1

URI-parameters

Gebruik de volgende URI-parameters voor uw aanvraag:

Naam	Type	Vereist	Beschrijving
overeenkomsttype	tekenreeks / snaar	Nee	Gebruik deze parameter om het bereik van het queryantwoord op een specifiek overeenkomsttype te bepalen. De ondersteunde waarden zijn: MicrosoftCloudAgreement- die alleen metagegevens van de overeenkomst bevat van het type MicrosoftCloudAgreement MicrosoftCustomerAgreement- die alleen overeenkomstmetagegevens bevat van het type MicrosoftCustomerAgreement. * die alle metagegevens van de overeenkomst retourneren. (Gebruik * alleen als uw code over de benodigde runtimelogica beschikt om niet-bekende overeenkomsttypen af te handelen, omdat Microsoft op elk gewenst moment metagegevens van overeenkomsten kan introduceren met nieuwe overeenkomsttypen.) Opmerking: Als de URI-parameter niet is opgegeven, wordt de query standaard ingesteld op MicrosoftCloudAgreement voor achterwaartse compatibiliteit.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Verzoekinhoud

Geen.

Aanvraagvoorbeeld

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

REST-antwoord

Als dit lukt, retourneert deze methode een verzameling AgreementMetaData resources in de antwoordtekst.

Geslaagde antwoorden en foutcodes

Elke reactie wordt geleverd met een HTTP-statuscode die aangeeft of deze is geslaagd of mislukt en andere foutopsporingsinformatie.

Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Partnercentrum REST-foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

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

Delen via