Delen via

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 voor de Amerikaanse overheid

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 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 alleen app- en gebruikersverificatie.

  • 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 (versie 1.4 of hoger)

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 naar Microsoft Cloud Agreement door de methode ByAgreementType aan te roepen.

  • Methode Get of GetAsync aanroepen.

// 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 consoletest-app-project .

.NET (versie 1.9 - 1.13)

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

Gebruik de verzameling IAggregatePartner.Customers en roep de ById-methode aan met de opgegeven klant-id. Haal vervolgens de eigenschap Agreements op, gevolgd door de get - of GetAsync-methoden aan te roepen.

// 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 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.

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

Gebruik de functie IAggregatePartner.getCustomers en roep de byId-functie 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 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.

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

Gebruik de opdracht Get-PartnerCustomerAgreement.

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

REST-aanvraag

Zie de volgende instructies om de bevestiging op te halen van klantacceptatie 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.

Name Type Vereist Beschrijving
CustomerTenantId GUID J De waarde is een door de GUID opgemaakte CustomerTenantId waarmee u een klant kunt opgeven.

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