Ottenere la conferma dell'accettazione del Contratto Microsoft Cloud da parte di un cliente
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"
}
]
}