Obtenir un résumé de l’utilisation d’un partenaire
S’applique à : Espace partenaires | Espace partenaires de Microsoft Cloud for US Government
Vous pouvez utiliser la ressource PartnerUsageSummary pour obtenir un résumé de l’utilisation partenaire de tous les clients qui ont acheté un service ou une ressource Azure spécifique pendant la période de facturation actuelle.
Le total retourné par cette API ne retournera pas la consommation pour les clients qui disposent d’un plan Azure. Dépréciation prévue à l’avenir.
Prérequis
- Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.
C#
Pour obtenir un résumé de l’utilisation pour tous les clients qui ont acheté un service ou une ressource Azure spécifique pendant la période de facturation actuelle :
Utilisez votre IAggregatePartner.
Appelez la propriété UsageSummary , suivie des méthodes Get() ou GetAsync() :
// IAggregatePartner partnerOperations; var usageSummary = partnerOperations.UsageSummary.Get();
Pour obtenir un exemple, consultez les éléments suivants :
- Exemple : Application de test de console
- Projet : PartnerSDK.FeatureSamples
- Classe : GetPartnerUsageSummary.cs
Demande REST
Syntaxe de la requête
Méthode | URI de requête |
---|---|
GET | {baseURL}/v1/usagesummary HTTP/1.1 |
En-têtes de requête
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de demande
Aucun.
Exemple de requête
GET https://api.partnercenter.microsoft.com/v1/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
Réponse REST
Si elle réussit, cette méthode renvoie une ressource PartnerUsageSummary dans le corps de la réponse.
Codes d’erreur et de réussite de la réponse
Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.
Exemple de réponse
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"customersOverBudget": 1,
"customersTrendingOver": 0,
"customersWithUsageBasedSubscription": 11,
"resourceId": "11111111-4574-4539-bc42-0e539b9684c0",
"id": "11111111-4574-4539-bc42-0e539b9684c0",
"resourceName": "PLAMUATT2NETNEW",
"name": "PLAMUATT2NETNEW",
"billingStartDate": "2019-08-28T00:00:00-07:00",
"billingEndDate": "2019-09-27T00:00:00-07:00",
"totalCost": 22.861172,
"currencyLocale": "fr-FR",
"lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
"links": {
"self": {
"uri": "/usagesummary",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "PartnerUsageSummary"
}
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour