Metagegevens van de overeenkomst voor Microsoft Cloud-overeenkomst ophalen

Van toepassing op: Partnercentrum

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

De AgreementMetaData-resource wordt momenteel alleen ondersteund door Het Partnercentrum in de openbare Microsoft-cloud.

De Microsoft-klantovereenkomst de Microsoft Cloud-overeenkomst vervangen vanaf 2021. Als uw klant eerder een Microsoft Cloud-overeenkomst heeft ondertekend, is de laatst bekende overeenkomstgeschiedenis beschikbaar, naast Microsoft-klantovereenkomst geschiedenis.

Vereisten

• Als u de .NET SDK van partnercentrum gebruikt, is versie 1.9 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 REST API's van partnercentrum te blijven gebruiken.

• Als u de Java SDK van partnercentrum gebruikt, is versie 1.8 of hoger vereist.

• Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt app- en gebruikersverificatie.

.NET (versie 1.14 of hoger)

De metagegevens van de overeenkomst voor Microsoft Cloud-overeenkomst ophalen:

1. Haal eerst de verzameling IAggregatePartner.AgreementDetails op.

2. Roep de methode ByAgreementType aan om de verzameling te filteren op Microsoft Cloud Agreement.++++++++++++++++++++++++

3. Roep tot slot de get - of GetAsync-methode aan.

// IAggregatePartner partnerOperations;

string agreementType = "MicrosoftCloudAgreement";

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

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

.NET (versie 1.9 - 1.13)

Metagegevens van overeenkomsten ophalen voor de Microsoft Cloud-overeenkomst:

Haal eerst de verzameling IAggregatePartner.AgreementDetails op en roep vervolgens deget- of GetAsync-methoden aan. Zoek vervolgens naar het item in de verzameling, dat overeenkomt met de Microsoft Cloud-overeenkomst:

// IAggregatePartner partnerOperations;

var agreements = partnerOperations.AgreementDetails.Get();

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

Java

De Partner Center Java SDK kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Metagegevens van overeenkomsten ophalen voor de Microsoft Cloud-overeenkomst:

Roep eerst de functie IAggregatePartner.getAgreementDetails aan en roep vervolgens de get-functie aan. Zoek vervolgens naar het item in de verzameling, dat overeenkomt met de Microsoft Cloud-overeenkomst:

// IAggregatePartner partnerOperations;

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

AgreementMetaData microsoftCloudAgreement;

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

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

Powershell

De PowerShell-module partnercentrum kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Metagegevens van overeenkomsten ophalen voor de Microsoft Cloud-overeenkomst:

Gebruik de opdracht Get-PartnerAgreementDetail. Zoek vervolgens naar het item in de verzameling, dat overeenkomt met de Microsoft Cloud-overeenkomst:

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

REST-aanvraag

Als u metagegevens van overeenkomsten voor Microsoft Cloud Agreement wilt ophalen, maakt u eerst een REST-aanvraag om de AgreementMetaData-verzameling op te halen. Zoek vervolgens naar het item in de verzameling die overeenkomt met de Microsoft Cloud-overeenkomst.

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/agreements HTTP/1.1

URI-parameters

Gebruik de volgende URI-parameters voor uw aanvraag:

Name	Type	Vereist	Beschrijving
overeenkomsttype	tekenreeks	Nee	Gebruik deze parameter om het bereik van het queryantwoord op een specifiek overeenkomsttype te bepalen. De ondersteunde waarden zijn: MicrosoftCloudAgreement met alleen metagegevens van overeenkomst van het type MicrosoftCloudAgreement MicrosoftCustomerAgreement dat alleen metagegevens van de overeenkomst bevat van het type MicrosoftCustomerAgreement. * die alle metagegevens van de overeenkomst retourneert. (Gebruik deze optie alleen * als uw code de benodigde runtimelogica heeft 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 Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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-antwoord

Als dit lukt, retourneert deze methode een verzameling AgreementMetaData-resources in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

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

Als u de resource in het antwoord wilt identificeren dat overeenkomt met de Microsoft Cloud-overeenkomst, zoekt u naar de resource waarvan de eigenschap agreementType de waarde MicrosoftCloudAgreement heeft.