De status van de directe ondertekening van een klant (directe acceptatie) van Microsoft-klantovereenkomst

Artikel
03/08/2024

Van toepassing op: Partnercentrum

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

De Resource DirectSignedCustomerAgreementStatus wordt momenteel alleen ondersteund door het Partnercentrum in de openbare Microsoft-cloud.

In dit artikel wordt uitgelegd hoe u de status van de directe acceptatie van de Microsoft-klantovereenkomst van een klant kunt ophalen.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
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).

C#

Als u de status van de directe acceptatie van de Microsoft-klantovereenkomst van een klant wilt ophalen, roept u de methode IAggregatePartner.Customers.ById aan met de klant-id. Gebruik vervolgens de eigenschap Agreements om een ICustomerAgreementCollection-interface op te halen. GetDirectSignedCustomerAgreementStatus() Roep ten slotte aan of GetDirectSignedCustomerAgreementStatusAsync() haal de status op.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

Voorbeeld: Consolevoorbeeld-app. Project: SdkSamples-klasse: GetDirectSignedCustomerAgreementStatus.cs

REST-aanvraag

Als u de status van de directe acceptatie van de Microsoft-klantovereenkomst van een klant wilt ophalen, maakt u een REST-aanvraag om de DirectSignedCustomerAgreementStatus voor de klant op te halen.

Aanvraagsyntaxis

Gebruik de volgende aanvraagsyntaxis:

Methode	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus 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 GUID opgemaakte CustomerTenantId waarmee u de tenant-id van 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/directSignedMicrosoftCustomerAgreementStatus 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 DirectSignedCustomerAgreementStatus-resource in de hoofdtekst van het antwoord.

De resource heeft een eigenschap isSigned die de status van de directe ondertekening (directe acceptatie) van de klant aangeeft.

Een waarde van true geeft aan dat de overeenkomst rechtstreeks door de klant is ondertekend (geaccepteerd).
Een waarde van false geeft aan dat de overeenkomst niet rechtstreeks door de klant is ondertekend (geaccepteerd).

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout optreedt en meer 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: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

Delen via