Delen via

Bevestiging ontvangen van klantacceptatie van Microsoft Cloud-overeenkomst

van toepassing op: Partnercentrum

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

De overeenkomst resource wordt momenteel alleen ondersteund door Partner Centrum in de Microsoft openbare cloud.

Voorwaarden

  • 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 readme met nuttige informatie.

    Partners worden aangemoedigd om de Partner center REST API'ste blijven gebruiken.

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

  • Referenties zoals beschreven in Partnercentrum-authenticatie. 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 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)

Bevestigingen ophalen van klantacceptatie die eerder is opgegeven:

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

  • Haal de eigenschap Agreements op en filter de resultaten op Microsoft Cloud Agreement door byAgreementType methode aan te roepen.

  • Roep Get of GetAsync methode 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 GetCustomerAgreements klasse uit de consoletest-app project.

.NET (versie 1.9 - 1.13)

Ga als volgt te werk om de bevestiging van eerder verstrekte klantacceptatie op te halen:

Gebruik de IAggregatePartner.Customers verzameling en roep de methode ById aan met de opgegeven klant-id. Haal vervolgens de eigenschap Agreements op, gevolgd door de methoden Get of GetAsync 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 volgt te werk om de bevestiging van eerder verstrekte klantacceptatie op te halen:

Gebruik de IAggregatePartner.getCustomers functie en roep de functie byId aan met de opgegeven klant-id. Haal vervolgens de getAgreements functie 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 GetCustomerAgreements klasse uit de consoletest-app project.

PowerShell

De PowerShell-module van 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 volgt te werk om de bevestiging van eerder verstrekte 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 op te halen van klantacceptatie die eerder is opgegeven.

Maak een nieuwe Overeenkomst bron met de relevante certificeringsgegevens.

Aanvraagsyntaxis

Methode Aanvraag-URI
DOWNLOAD {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 (Globaal Unieke Identificator) Y De waarde is in GUID-indeling CustomerTenantId waarmee u een klant kunt opgeven.

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Verzoeksinhoud

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 Overeenkomst-bronnen in de reactie-inhoud.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of er sprake is van succes of mislukking en andere informatie voor foutopsporing. 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": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"/partner-center/agreements"
        }
    ]
}
  • Last updated on