Obtenir le résumé de l’utilisation de l’abonnement du client

  • Article

S’applique à : Espace partenaires | Espace partenaires de Microsoft Cloud for US Government

Vous pouvez utiliser la ressource SubscriptionUsageSummary pour obtenir un résumé de l’utilisation de l’abonnement pour un client. Cette ressource représente le résumé de l’utilisation de l’abonnement d’un service ou d’une ressource Azure spécifique pendant la période de facturation actuelle.

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.

  • ID du client (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans l’Espace partenaires en sélectionnant l’espace de travail Clients , puis le client dans la liste des clients, puis Compte. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).

  • Identificateur d’abonnement

C#

Pour obtenir un résumé de l’utilisation de l’abonnement d’un client :

  1. Utilisez votre collection IAggregatePartner.Customers pour appeler la méthode ById().

  2. Appelez ensuite la propriété Subscriptions et la propriété UsageSummary . Terminez en appelant les méthodes Get() ou GetAsync().

    // IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// var selectedSubscriptionId as string;

var subscriptionUsageSummary = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).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/customers/{customer-tenant-id}/subscriptions/{subscription-id}/usagesummary HTTP/1.1

Paramètres URI

Ce tableau répertorie les paramètres de requête requis pour obtenir les informations d’utilisation évaluées du client.

Nom Type Obligatoire Description
customer-tenant-id guid O GUID correspondant au client.
subscription-id guid O GUID correspondant à l’identificateur d’un abonnement. Pour un plan Azure, il s’agit de l’identificateur de la ressource d’abonnement Espace partenaires correspondante, qui représente le plan Azure. Pour les ressources d’abonnement au plan Azure, fournissez l’id de plan comme id d’abonnement dans cet itinéraire.

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/customers/{customer-tenant-id}/subscriptions/{subscription-id}/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 SubscriptionUsageSummary 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 pour les abonnements Microsoft Azure (MS-AZR-0145P)

Dans cet exemple, le client a acheté une offre Azure PayG 145P .

Pour les clients disposant d’un abonnement Microsoft Azure (MS-AZR-0145P), aucune modification n’est apportée à la réponse de l’API.

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

{
    "resourceId": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "id": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "resourceName": "Microsoft Azure",
    "name": "Microsoft Azure",
    "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": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Exemple de réponse REST pour le plan Azure

Dans cet exemple, le client a acheté un plan Azure.

Pour les clients disposant de plans Azure, il existe les modifications de réponse d’API suivantes :

  • currencyLocale est remplacé par currencyCode
  • usdTotalCost est un nouveau champ
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac1
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "11111111-dca5-6f31-d3a6-dbbfad9be0fc",
    "resourceName": "Azure plan",
    "billingStartDate": "2019-09-01T00:00:00+00:00",
    "billingEndDate": "2019-10-01T00:00:00+00:00",
    "totalCost": 28.82860766744404945074,
    "currencyCode": "GBP",
    "usdTotalCost": 35.23000000000000362337,
    "lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}