Hämta status för en kunds direktsignering (direkt godkännande) av Microsoft-kundavtal

Artikel
03/05/2024

Gäller för: Partnercenter

Gäller inte för: Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Resursen DirectSignedCustomerAgreementStatus stöds för närvarande endast av Partnercenter i Microsofts offentliga moln.

Den här artikeln beskriver hur du kan hämta statusen för en kunds direkta godkännande av Microsoft-kundavtal.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

C#

Om du vill hämta statusen för en kunds direkta godkännande av Microsoft-kundavtal anropar du metoden IAggregatePartner.Customers.ById med kundidentifieraren. Använd sedan egenskapen Avtal för att hämta ett ICustomerAgreementCollection-gränssnitt. GetDirectSignedCustomerAgreementStatus() Anropa eller GetDirectSignedCustomerAgreementStatusAsync() hämta slutligen statusen.

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

Exempel: Exempelapp för konsol. Projekt: SdkSamples-klass: GetDirectSignedCustomerAgreementStatus.cs

REST-begäran

Om du vill hämta statusen för en kunds direkta godkännande av Microsoft-kundavtal skapar du en REST-begäran för att hämta DirectSignedCustomerAgreementStatus för kunden.

Syntax för begäran

Använd följande syntax för begäran:

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

URI-parametrar

Du kan använda följande URI-parametrar med din begäran:

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	GUID	Ja	Värdet är ett GUID-formaterat CustomerTenantId som gör att du kan ange klientorganisations-ID för en kund.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden en DirectSignedCustomerAgreementStatus-resurs i svarstexten.

Resursen har en isSigned-egenskap som anger kundens direktsigneringsstatus (direkt godkännande).

Värdet true anger att avtalet signerades (accepterades) direkt av kunden.
Värdet false anger att avtalet inte har signerats (accepterats) direkt av kunden.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och mer felsökningsinformation.

Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Rest-felkoder för Partnercenter.

Svarsexempel

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}

Dela via