Ottenere la conferma dell'accettazione del Contratto del cliente Microsoft da parte del cliente

Articolo
03/08/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 contratto è attualmente supportata dal Centro per i partner solo nel cloud pubblico Microsoft.

Questo articolo illustra come recuperare le conferme dell'accettazione del Contratto del cliente Microsoft da parte di un cliente.

Prerequisiti

Se si usa .NET SDK del Centro per i partner, è necessaria la versione 1.14 o successiva.

Importante

A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.

I partner sono invitati a continuare a usare le API REST del Centro per i partner .
Credenziali come descritto nell'autenticazione del Centro Partner . Questo scenario supporta solo l'autenticazione app+utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo in 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 cliente (customer-tenant-id).

.NET

Per recuperare le conferme dell'accettazione del cliente fornite in precedenza:

Usare la raccolta IAggregatePartner.Customers e chiamare il metodo ById con l'identificatore del cliente specificato.
Recuperare la proprietà Accordi e filtrare i risultati in base all'Accordo Cliente Microsoft chiamando il metodo ByAgreementType.
Chiamare il metodo Get o il metodo GetAsync.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Un esempio completo è disponibile nella classe GetCustomerAgreements del progetto dell'app di test della console .

Richiesta REST

Per recuperare la conferma dell'accettazione del cliente fornita in precedenza:

Creare una richiesta REST per recuperare la collezione contratti per il cliente.
Usare il parametro di query agreementType per limitare i risultati solo al Contratto Cliente Microsoft.

Sintassi della richiesta

Usare la sintassi di richiesta seguente:

Metodo	URI della richiesta
OTTIENI	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

Parametri URI

È possibile usare i parametri URI seguenti con la richiesta:

Nome	Digitare	Obbligatorio	Descrizione
id-cliente-inquilino	GUID (Identificatore Globale Unico)	Sì	Il valore è un GUID formattato CustomerTenantId che consente di specificare un cliente.
tipo di contratto	corda	No	Questo parametro restituisce tutti i metadati del contratto. Usare questo parametro per definire l'ambito della risposta di query a un tipo di contratto specifico. I valori supportati sono: MicrosoftCloudAgreement che include solo i metadati del contratto del tipo MicrosoftCloudAgreement. MicrosoftCustomerAgreement che include solo i metadati del contratto del tipo MicrosoftCustomerAgreement. * che restituisce tutti i metadati del contratto. Non usare * a meno che il codice non abbia la logica necessaria per gestire i tipi di contratto imprevisti. Nota: Se il parametro URI non è specificato, la query predefinita è MicrosoftCloudAgreement per la compatibilità con le versioni precedenti. Microsoft potrebbe introdurre metadati di contratto con nuovi tipi di contratto in qualsiasi momento.

Intestazioni della richiesta

Per ulteriori informazioni, vedere intestazioni REST del Centro Partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements?agreementType=MicrosoftCustomerAgreement 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 raccolta di risorse Agreement nel corpo della risposta.

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

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}

Condividi tramite