Uzyskiwanie stanu bezpośredniego podpisywania klienta (bezpośrednia akceptacja) Umowa z Klientem Microsoft

  • Artykuł

Dotyczy: Centrum partnerskie

Nie dotyczy: Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Zasób DirectSignedCustomerAgreementStatus jest obecnie obsługiwany przez Centrum partnerskie tylko w chmurze publicznej firmy Microsoft.

W tym artykule wyjaśniono, jak można pobrać stan bezpośredniej akceptacji Umowa z Klientem Microsoft przez klienta.

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń aplikacji i użytkownika.

  • Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

C#

Aby pobrać stan bezpośredniej akceptacji Umowa z Klientem Microsoft klienta, wywołaj metodę IAggregatePartner.Customers.ById identyfikatorem klienta. Następnie użyj właściwości Agreement, aby pobrać interfejs ICustomerAgreementCollection. Na koniec wywołaj metodę GetDirectSignedCustomerAgreementStatus() lub GetDirectSignedCustomerAgreementStatusAsync() pobierz stan.

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

Przykład: przykładowa aplikacja konsoli. Projekt: SdkSamples , klasa: GetDirectSignedCustomerAgreementStatus.cs

Żądanie REST

Aby pobrać stan bezpośredniej akceptacji Umowa z Klientem Microsoft przez klienta, utwórz żądanie REST w celu pobrania parametru DirectSignedCustomerAgreementStatus dla klienta.

Składnia żądania

Użyj następującej składni żądania:

Method Identyfikator URI żądania
GET {baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parametry identyfikatora URI

Możesz użyć następujących parametrów identyfikatora URI z żądaniem:

Nazwisko Type Wymagania opis
identyfikator dzierżawy klienta Identyfikator GUID Tak Wartość jest identyfikatorem GUID sformatowanym identyfikatorem CustomerTenantId , który umożliwia określenie identyfikatora dzierżawy klienta.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

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: ab993325-1605-4cf4-bac4-fb584142a31b

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca zasób DirectSignedCustomerAgreementStatus w treści odpowiedzi.

Zasób ma właściwość isSigned , która wskazuje stan podpisywania bezpośredniego (bezpośredniej akceptacji) klienta.

  • Wartość true wskazuje, że umowa została podpisana (zaakceptowana) bezpośrednio przez klienta.

  • Wartość false wskazuje, że umowa nie została podpisana (zaakceptowana) bezpośrednio przez klienta.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu.

Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

{"isSigned":true}