Condividi tramite

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

  • Articolo

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.

Prerequisiti

  • Se si usa .NET SDK del Centro per i partner, è necessaria la versione 1.9 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.

  • Se si usa Java SDK del Centro per i partner, è necessaria la versione 1.8 o successiva.

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta solo l'autenticazione dell'app e dell'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).

.NET (versione 1.4 o successiva)

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

  • Usare la raccolta IAggregatePartner.Customers e chiamare il metodo ById con l'identificatore del cliente specificato.

  • Recuperare la proprietà Agreements e filtrare i risultati in Base al Contratto Microsoft Cloud chiamando il metodo ByAgreementType .

  • Chiamare il metodo Get o GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

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

.NET (versione 1.9 - 1.13)

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

Usare l'insieme IAggregatePartner.Customers e chiamare il metodo ById con l'identificatore del cliente specificato. Ottenere quindi la proprietà Agreements , seguita chiamando i metodi Get o GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

Java

L'SDK Java del Centro per i partner può essere usato per gestire le risorse del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.

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

Usare la funzione IAggregatePartner.getCustomers e chiamare la funzione byId con l'identificatore del cliente specificato. Ottenere quindi la funzione getAgreements , seguita dalla chiamata alla funzione get .

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

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

PowerShell

Il modulo PowerShell del Centro per i partner può essere usato per gestire le risorse del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.

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

Usare il comando Get-PartnerCustomerAgreement.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

Richiesta REST

Per recuperare la conferma dell'accettazione fornita in precedenza dal cliente, vedere le istruzioni seguenti.

Creare una nuova risorsa contratto con le informazioni di certificazione pertinenti.

Sintassi della richiesta

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

Parametro URI

Usare il parametro di query seguente per specificare il cliente che si sta confermando.

Nome Digita Obbligatorio Descrizione
CustomerTenantId GUID Y Il valore è un GUID formattato CustomerTenantId che consente di specificare 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/agreements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Risposta REST

In caso di esito positivo, questo metodo restituisce una raccolta di risorse Agreement nel corpo della risposta.

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: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        }
    ]
}