Dela via


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

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}