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

  • Article

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

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 :

  1. Utilisez votre IAggregatePartner.

  2. 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 :

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"
    }
}