Obtenir un résumé de l’utilisation d’un partenaire

Article
10/07/2024

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "customersOverBudget": 1,
    "customersTrendingOver": 0,
    "customersWithUsageBasedSubscription": 11,
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "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"
    }
}

Partage via