Bevestiging van acceptatie door de klant van Microsoft-klantovereenkomst ophalen

  • Artikel

Van toepassing op: Partnercentrum

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

De overeenkomstresource wordt momenteel alleen ondersteund door partnercentrum in de openbare cloud van Microsoft.

In dit artikel wordt uitgelegd hoe u bevestiging(en) van de acceptatie van de Microsoft-klantovereenkomst van een klant kunt ophalen.

Vereisten

  • 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 REST API's van partnercentrum te blijven gebruiken.

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor App+User-verificatie.

  • Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

.NET

Bevestiging(en) ophalen van klantacceptatie die eerder is opgegeven:

  • Gebruik de verzameling IAggregatePartner.Customers en roep de ById-methode aan met de opgegeven klant-id.

  • Haal de eigenschap Agreements op en filter de resultaten op Microsoft-klantovereenkomst door de methode ByAgreementType aan te roepen.

  • Methode Get of GetAsync aanroepen.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

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

REST-aanvraag

Bevestiging van klantacceptatie ophalen die eerder is opgegeven:

  1. Maak een REST-aanvraag om de verzameling overeenkomsten voor de klant op te halen.

  2. Gebruik de queryparameter agreementType om de resultaten alleen te beperken tot de Microsoft-klantovereenkomst.

Aanvraagsyntaxis

Gebruik de volgende aanvraagsyntaxis:

Methode Aanvraag-URI
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI-parameters

U kunt de volgende URI-parameters gebruiken met uw aanvraag:

Name Type Vereist Beschrijving
klant-tenant-id GUID Ja De waarde is een door de GUID opgemaakte CustomerTenantId waarmee u een klant kunt opgeven.
overeenkomsttype tekenreeks Nee Met deze parameter worden alle metagegevens van de overeenkomst geretourneerd. Gebruik deze parameter om het bereik van het queryantwoord op een specifiek overeenkomsttype te bepalen. De ondersteunde waarden zijn:

MicrosoftCloudAgreement dat alleen metagegevens van de overeenkomst bevat van het type MicrosoftCloudAgreement.

MicrosoftCustomerAgreement dat alleen metagegevens van de overeenkomst bevat van het type MicrosoftCustomerAgreement.

* die alle metagegevens van de overeenkomst retourneert. (Gebruik dit alleen * als uw code de benodigde logica heeft om onverwachte overeenkomsttypen af te handelen.)

Opmerking: Als de URI-parameter niet is opgegeven, wordt de query standaard ingesteld op MicrosoftCloudAgreement voor achterwaartse compatibiliteit. Microsoft kan op elk gewenst moment metagegevens van overeenkomsten met nieuwe overeenkomsttypen introduceren.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement 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 overeenkomstbronnen in de antwoordtekst.

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": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"117a77b0-9360-443b-8795-c6dedc750cf9",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}