Bevestiging van acceptatie door de klant van Microsoft Cloud-overeenkomst ophalen

  • Artikel

Van toepassing op: Partnercentrum

Is niet van toepassing op: Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

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

Vereisten

  • Als u de .NET SDK van partnercentrum gebruikt, is versie 1.9 of hoger vereist.

    Belangrijk

    Vanaf juni 2023 wordt de meest recente partnercentrum .NET SDK-release 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 Partner Center Java SDK gebruikt, is versie 1.8 of hoger vereist.

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

  • Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in 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 (versie 1.4 of hoger)

Bevestiging(en) van klantacceptatie ophalen 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 Cloud Agreement door de methode ByAgreementType aan te roepen.

  • Roep de methode Get of GetAsync aan.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

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

.NET (versie 1.9 - 1.13)

Ga als volgende te werk om de eerder opgegeven bevestiging van klantacceptatie op te halen:

Gebruik de verzameling IAggregatePartner.Customers en roep de ById-methode aan met de opgegeven klant-id. Haal vervolgens de eigenschap Agreements op, gevolgd door het aanroepen van de methode Get of GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

Java

De Partner Center Java SDK kan worden gebruikt voor het beheren van partnercentrumresources. Het is een opensource-project dat wordt beheerd 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.

Ga als volgende te werk om de eerder opgegeven bevestiging van klantacceptatie op te halen:

Gebruik de functie IAggregatePartner.getCustomers en roep de functie byId aan met de opgegeven klant-id. Haal vervolgens de functie getAgreements op , gevolgd door het aanroepen van de get-functie.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

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

PowerShell

De PowerShell-module partnercentrum kan worden gebruikt voor het beheren van partnercentrumresources. Het is een opensource-project dat wordt beheerd 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.

Ga als volgende te werk om de eerder opgegeven bevestiging van klantacceptatie op te halen:

Gebruik de opdracht Get-PartnerCustomerAgreement .

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

REST-aanvraag

Zie de volgende instructies om de bevestiging van klantacceptatie op te halen die eerder is opgegeven.

Maak een nieuwe overeenkomstresource met de relevante certificeringsgegevens.

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de klant op te geven die u bevestigt.

Naam Type Vereist Beschrijving
CustomerTenantId GUID J De waarde is een DOOR GUID opgemaakte CustomerTenantId waarmee u een klant kunt opgeven.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor 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: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        }
    ]
}