Ottenere i metadati per il Contratto Microsoft Cloud
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 AgreementMetaData è attualmente supportata dal Centro per i partner solo nel cloud pubblico Microsoft.
Il Contratto del cliente Microsoft ha sostituito il Contratto Microsoft Cloud, a partire dal 2021. Se il cliente ha firmato in precedenza un Contratto Microsoft Cloud, sarà disponibile l'ultima cronologia del contratto noto, oltre a Contratto del cliente Microsoft cronologia.
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 l'autenticazione dell'app e dell'utente.
.NET (versione 1.14 o successiva)
Per recuperare i metadati del contratto per il Contratto Microsoft Cloud:
Recuperare prima di tutto l'insieme IAggregatePartner.AgreementDetails .
Chiamare il metodo ByAgreementType per filtrare la raccolta in Microsoft Cloud Agreement.++++++++++++++++++++++++
Infine, chiamare il metodo Get o GetAsync .
// IAggregatePartner partnerOperations;
string agreementType = "MicrosoftCloudAgreement";
var microsoftCloudAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
Un esempio completo è disponibile nella classe GetAgreementDetails del progetto di app di test della console.
.NET (versione 1.9 - 1.13)
Per recuperare i metadati del contratto per il Contratto Microsoft Cloud:
Recuperare innanzitutto l'insieme IAggregatePartner.AgreementDetails e quindi chiamare i metodi Get o GetAsync . Cercare quindi l'elemento all'interno della raccolta, che corrisponde al Contratto Microsoft Cloud:
// IAggregatePartner partnerOperations;
var agreements = partnerOperations.AgreementDetails.Get();
AgreementMetaData microsoftCloudAgreement = agreements.Items.FirstOrDefault (agr => agr.AgreementType == AgreementType.MicrosoftCloudAgreement);
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 i metadati del contratto per il Contratto Microsoft Cloud:
Chiamare prima la funzione IAggregatePartner.getAgreementDetails e quindi chiamare la funzione get . Cercare quindi l'elemento all'interno della raccolta, che corrisponde al Contratto Microsoft Cloud:
// IAggregatePartner partnerOperations;
ResourceCollection<AgreementMetaData> agreements = partnerOperations.getAgreements().get();
AgreementMetaData microsoftCloudAgreement;
for (AgreementMetaData metadata : agreements)
{
if(metadata.getAgreementType() == AgreementType.MicrosoftCloudAgreement)
{
microsoftCloudAgreement = metadata;
}
}
Un esempio completo è disponibile nella classe GetAgreementDetails 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 i metadati del contratto per il Contratto Microsoft Cloud:
Usare il comando Get-PartnerAgreementDetail. Cercare quindi l'elemento all'interno della raccolta, che corrisponde al Contratto Microsoft Cloud:
Get-PartnerAgreementDetail | Where-Object {$_.AgreementType -eq 'MicrosoftCloudAgreement'} | Select-Object -First 1
Richiesta REST
Per recuperare i metadati del contratto per il Contratto Microsoft Cloud, creare prima una richiesta REST per recuperare la raccolta AgreementMetaData . Cercare quindi l'elemento nella raccolta corrispondente al Contratto Microsoft Cloud.
Sintassi della richiesta
| metodo | URI della richiesta |
|---|---|
| GET | {baseURL}/v1/agreements HTTP/1.1 |
Parametri URI
Usare i parametri URI seguenti con la richiesta:
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
| tipo di contratto | string | No | 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 i metadati del contratto solo del tipo MicrosoftCustomerAgreement. * che restituisce tutti i metadati del contratto. Non usare * a meno che il codice non abbia la logica di runtime necessaria per gestire i tipi di contratto sconosciuti perché Microsoft potrebbe introdurre metadati di contratto con nuovi tipi di contratto in qualsiasi momento. Nota: se il parametro URI non è specificato, per impostazione predefinita la query è MicrosoftCloudAgreement per la compatibilità con le versioni precedenti. |
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/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 AgreementMetaData 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": 1,
"items": [
{
"templateId": "998b88de-aa99-4388-a42c-1b3517d49490",
"agreementType": "MicrosoftCloudAgreement",
"agreementLink": "https://learn.microsoft.com/partner-center/agreements",
"versionRank": 0
}
],
"links": {
"self": {
"uri": "/agreements",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Per identificare la risorsa nella risposta che corrisponde al Contratto Microsoft Cloud, cercare la risorsa la cui proprietà agreementType ha valore "MicrosoftCloudAgreement".
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per