Obtenir les métadonnées de contrat pour le contrat Microsoft Cloud
S’applique à : Espace partenaires
Ne s’applique pas à : Espace partenaires géré par 21Vianet | Espace partenaires Microsoft Cloud for US Government
La ressource AgreementMetaData est actuellement prise en charge par l’Espace partenaires dans le cloud public Microsoft uniquement.
Le Contrat client Microsoft a remplacé le Contrat Cloud Microsoft, à compter de 2021. Si votre client a précédemment signé un contrat Cloud Microsoft, son dernier historique de contrat connu sera disponible, en plus de Contrat client Microsoft’historique.
Prérequis
Si vous utilisez le Kit de développement logiciel (SDK) .NET de l’Espace partenaires, la version 1.9 ou ultérieure est requise.
Important
Depuis juin 2023, la dernière version du Kit de développement logiciel (SDK) .NET de l’Espace partenaires version 3.4.0 est désormais archivée. Vous pouvez télécharger la version du SDK à partir de GitHub, ainsi qu’un fichier lisezmoi contenant des informations utiles.
Les partenaires sont encouragés à continuer à utiliser les API REST de l’Espace partenaires.
Si vous utilisez le Kit de développement logiciel (SDK) Java de l’Espace partenaires, la version 1.8 ou ultérieure est requise.
Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification de l’application + utilisateur.
.NET (version 1.14 ou ultérieure)
Pour récupérer les métadonnées du contrat pour le Contrat Cloud Microsoft :
Tout d’abord, récupérez la collection IAggregatePartner.AgreementDetails .
Appelez la méthode ByAgreementType pour filtrer la collection sur Microsoft Cloud Agreement.++++++++++++++++++++++++
Enfin, appelez la méthode Get ou GetAsync .
// IAggregatePartner partnerOperations;
string agreementType = "MicrosoftCloudAgreement";
var microsoftCloudAgreementDetails = partnerOperations.AgreementDetails.ByAgreementType(agreementType).Get().Items.Single();
Vous trouverez un exemple complet dans la classe GetAgreementDetails à partir du projet d’application de test console.
.NET (version 1.9 - 1.13)
Pour récupérer les métadonnées de contrat pour le Contrat Cloud Microsoft :
Commencez par récupérer la collection IAggregatePartner.AgreementDetails, puis appelez les méthodes Get ou GetAsync. Recherchez ensuite l’élément dans la collection, qui correspond au Contrat Cloud Microsoft :
// IAggregatePartner partnerOperations;
var agreements = partnerOperations.AgreementDetails.Get();
AgreementMetaData microsoftCloudAgreement = agreements.Items.FirstOrDefault (agr => agr.AgreementType == AgreementType.MicrosoftCloudAgreement);
Java
Le Kit de développement logiciel (SDK) Java de l’Espace partenaires peut être utilisé pour gérer les ressources de l’Espace partenaires. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.
Pour récupérer les métadonnées de contrat pour le Contrat Cloud Microsoft :
Appelez d’abord la fonction IAggregatePartner.getAgreementDetails , puis appelez la fonction get . Recherchez ensuite l’élément dans la collection, qui correspond au Contrat Cloud Microsoft :
// IAggregatePartner partnerOperations;
ResourceCollection<AgreementMetaData> agreements = partnerOperations.getAgreements().get();
AgreementMetaData microsoftCloudAgreement;
for (AgreementMetaData metadata : agreements)
{
if(metadata.getAgreementType() == AgreementType.MicrosoftCloudAgreement)
{
microsoftCloudAgreement = metadata;
}
}
Vous trouverez un exemple complet dans la classe GetAgreementDetails à partir du projet d’application de test console.
PowerShell
Le module PowerShell de l’Espace partenaires peut être utilisé pour gérer les ressources de l’Espace partenaires. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.
Pour récupérer les métadonnées de contrat pour le Contrat Cloud Microsoft :
Utilisez la commande Get-PartnerAgreementDetail. Recherchez ensuite l’élément dans la collection, qui correspond au Contrat Cloud Microsoft :
Get-PartnerAgreementDetail | Where-Object {$_.AgreementType -eq 'MicrosoftCloudAgreement'} | Select-Object -First 1
Demande REST
Pour récupérer les métadonnées de contrat pour le Contrat Cloud Microsoft, commencez par créer une requête REST pour récupérer la collection AgreementMetaData . Recherchez ensuite l’élément dans la collection qui correspond au Contrat Cloud Microsoft.
Syntaxe de la requête
| Méthode | URI de demande |
|---|---|
| GET | {baseURL}/v1/agreements HTTP/1.1 |
Paramètres d’URI
Utilisez les paramètres d’URI suivants avec votre requête :
| Nom | Type | Requise | Description |
|---|---|---|---|
| type de contrat | string | Non | Utilisez ce paramètre pour étendre la réponse de requête à un type de contrat spécifique. Les valeurs prises en charge sont les suivantes : MicrosoftCloudAgreement qui inclut les métadonnées de contrat uniquement du type MicrosoftCloudAgreement MicrosoftCustomerAgreement qui inclut les métadonnées de contrat uniquement du type MicrosoftCustomerAgreement. * qui retourne toutes les métadonnées de contrat. (N’utilisez * pas, sauf si votre code a la logique d’exécution nécessaire pour gérer les types de contrat inconnus, car Microsoft peut introduire des métadonnées de contrat avec de nouveaux types de contrats à tout moment.) Remarque : Si le paramètre URI n’est pas spécifié, la requête est définie par défaut sur MicrosoftCloudAgreement pour la compatibilité descendante. |
En-têtes de requête
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de la demande
Aucune.
Exemple de requête
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: aaaa0000-bb11-2222-33cc-444444dddddd
Réponse REST
Si elle réussit, cette méthode retourne une collection de ressources AgreementMetaData dans le corps de la réponse.
Codes d’erreur et de réussite de la réponse
Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.
Exemple de réponse
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": 1,
"items": [
{
"templateId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"agreementType": "MicrosoftCloudAgreement",
"agreementLink": "https://learn.microsoft.com/partner-center/agreements",
"versionRank": 0
}
],
"links": {
"self": {
"uri": "/agreements",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Pour identifier la ressource dans la réponse qui correspond au Contrat Cloud Microsoft, recherchez la ressource dont la propriété agreementType a la valeur « MicrosoftCloudAgreement ».