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

Artikel
01/02/2025

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

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partner Center-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 leta upp 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 i avsnittet Kundkontoinformation. Microsoft-ID:t är detsamma som kund-ID :t (customer-tenant-id).
Den indirekta leverantören eller direktfaktureringspartnern måste ha en aktiv återförsäljarrelation med kunden för att hämta status för direkt signering av avtalet.

C#

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

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

Exempel på: Konsolprovapp. Project: SdkSamples Class: GetDirectSignedCustomerAgreementStatus.cs

REST-begäran

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

Begäransyntax

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

Metod	Begär URI
FÅ	{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	Krävs	Beskrivning
kund-hyresgäst-id	GUID	Ja	Värdet är en GUID-formaterad CustomerTenantId som låter dig ange kundens hyres-ID.

Begärandehuvuden

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

Begärandetext

Ingen.

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 egenskap isSigned som anger kundens direktsigneringsstatus (direkt godkännande).

Värdet sant anger att avtalet undertecknades (accepterades) direkt av kunden.
Värdet falskt anger att avtalet inte har signerats (godkänts) 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. För hela listan, se REST-felkoder för Partner Center.

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