Ottenere lo stato della firma diretta di un cliente (accettazione diretta) di Contratto del cliente Microsoft

Articolo
03/05/2024

Si applica a: Centro per i partner

Non si applica a: Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

La risorsa DirectSignedCustomerAgreementStatus è attualmente supportata dal Centro per i partner solo nel cloud pubblico Microsoft.

Questo articolo illustra come recuperare lo stato dell'accettazione diretta del Contratto del cliente Microsoft da parte di un cliente.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

C#

Per recuperare lo stato dell'accettazione diretta del Contratto del cliente Microsoft da parte di un cliente, chiamare il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente. Usare quindi la proprietà Agreements per recuperare un'interfaccia ICustomerAgreementCollection. Infine, chiamare GetDirectSignedCustomerAgreementStatus() o GetDirectSignedCustomerAgreementStatusAsync() per recuperare lo stato.

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

Esempio: App di esempio console. Progetto: Classe SdkSamples: GetDirectSignedCustomerAgreementStatus.cs

Richiesta REST

Per recuperare lo stato dell'accettazione diretta del Contratto del cliente Microsoft da parte di un cliente, creare una richiesta REST per recuperare DirectSignedCustomerAgreementStatus per il cliente.

Sintassi della richiesta

Usare la sintassi di richiesta seguente:

metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1

Parametri URI

È possibile usare i parametri URI seguenti con la richiesta:

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	GUID	Sì	Il valore è un CustomerTenantId formattato con GUID che consente di specificare l'ID tenant di un cliente.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una risorsa DirectSignedCustomerAgreementStatus nel corpo della risposta.

La risorsa ha una proprietà isSigned che indica lo stato di firma diretta del cliente (accettazione diretta).

Un valore true indica che il contratto è stato firmato (accettato) direttamente dal cliente.
Un valore false indica che il contratto non è stato firmato (accettato) direttamente dal cliente.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug.

Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Risposta di esempio

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}

Condividi tramite