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

Articolo
01/02/2025

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 di Microsoft.

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

Prerequisiti

Credenziali come descritto 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 lo spazio di lavoro clienti, poi il cliente dall'elenco dei clienti e infine Account. Nella pagina Account del cliente, cercare l'ID Microsoft nella sezione informazioni sull'account cliente . L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
Il provider indiretto o il partner con fatturazione diretta deve avere una relazione di rivendita attiva con il cliente per ottenere lo stato di firma diretta del contratto.

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à Accordi 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();

App di esempio: App di esempio console. Progetto: SdkSamples Classe: 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 il DirectSignedCustomerAgreementStatus per il cliente.

Sintassi della richiesta

Usare la sintassi di richiesta seguente:

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

Parametri URI

È possibile usare i parametri URI seguenti con la richiesta:

Nome	Digitare	Obbligatorio	Descrizione
ID cliente-locatario	GUID	Sì	Il valore è un GUID formattato CustomerTenantId che consente di specificare l'ID tenant di un cliente.

Intestazioni della richiesta

Per altre informazioni, vedere 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 nel corpo della risposta una risorsa DirectSignedCustomerAgreementStatus.

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

Il valore true indica che il contratto è stato firmato (accettato) direttamente dal cliente.
Il valore false indica che l'accordo non è stato firmato (accettato) direttamente dal cliente.

Codici di errore e esito positivo 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, vedere codici di errore REST del Centro per i partner.

Esempio di risposta

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