Udostępnij za pośrednictwem

Uzyskiwanie stanu bezpośredniego podpisywania klienta (bezpośredniej akceptacji) umowy klienta firmy Microsoft

  • Artykuł

Dotyczy: Centrum Partnerskie

nie ma zastosowania do: 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 publicznej chmurze Microsoft.

W tym artykule wyjaśniono, jak można pobrać stan bezpośredniej akceptacji umowy klienta firmy Microsoft.

Warunki wstępne

  • Poświadczenia zgodnie z opisem w uwierzytelnianiu Centrum Partnerskiego . 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 klient z listy klientów, a następnie konto. Na stronie Konto Klienta znajdź identyfikator Microsoft w sekcji Informacje o Koncie Klienta. Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).

  • Dostawca pośredni lub partner bezpośredniej fakturacji musi mieć aktywną relację odsprzedaży z klientem, aby uzyskać status bezpośredniego podpisania umowy.

C#

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

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

Przykład: Przykładowa aplikacja konsoli. project: SdkSamples Class: GetDirectSignedCustomerAgreementStatus.cs

Żądanie REST

Aby uzyskać status bezpośredniej akceptacji Microsoft Customer Agreement przez klienta, utwórz żądanie REST w celu pobrania DirectSignedCustomerAgreementStatus dla klienta.

Składnia żądania

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

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

Parametry identyfikatora URI

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

Nazwa Typ Wymagane Opis
identyfikator dzierżawy klienta GUID Tak Wartość to identyfikator najemcy klienta w formacie GUID, oznaczony jako CustomerTenantId, który umożliwia określenie identyfikatora klienta.

Nagłówki żądań

Więcej informacji znajdziesz w Nagłówkach REST Centrum Partnerów.

Treść żądania

Żaden.

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: aaaa0000-bb11-2222-33cc-444444dddddd

Odpowiedź REST

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

Zasób ma cechę isSigned, która wskazuje status bezpośredniego podpisu (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 sukcesu 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 zapoznać się z pełną listą kodów błędów REST Centrum partnerskiego, zobacz .

Przykład odpowiedzi

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}