Obtenir un résumé de l’utilisation pour tous les abonnements d’un client

Article
10/07/2024

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

Vous pouvez utiliser la ressource CustomerUsageSummary pour obtenir l’utilisation d’un client d’un service ou d’une ressource Azure spécifique pendant la période de facturation actuelle.

Remarque

En règle générale, les données d’utilisation non facturées par jour sont disponibles via l’API ou le portail de l’Espace partenaires après 24 heures. Selon votre emplacement et lorsque les compteurs signalent l’utilisation, des retards supplémentaires peuvent se produire.

Parfois, vous ne voyez peut-être pas les données d’utilisation non facturées les plus récentes depuis le début du mois jusqu’à ce que les données d’utilisation facturées du mois précédent soient remises. Cela permet de s’assurer que les données d’utilisation facturées sont fournies efficacement dans le contrat SLA. Une fois que vous avez reçu les données d’utilisation facturées, vous pouvez commencer à récupérer toutes les données d’utilisation non facturées mises à jour à partir du début du mois.

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 de partenaires en sélectionnant l’espace de travail Clients, puis le client dans la liste des clients, puis compte. Dans la page 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).

C#

Pour obtenir un résumé de l’utilisation pour tous les abonnements d’un client :

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

Appelez la propriété UsageSummary , suivie des méthodes Get() ou GetAsync() :

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

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Pour obtenir un exemple, consultez les rubriques suivantes :

Exemple : Application de test console
Projet : PartnerSDK.FeatureSamples
Classe : GetCustomerUsageSummary.cs

Demande REST

Syntaxe de la requête

Méthode	URI de demande
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

Paramètre d’URI

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

Nom	Type	Requise	Description
id-locataire-client	guid	Y	GUID correspondant au client.

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/customers/{customer-tenant-id}/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 CustomerUsageSummary 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 une liste complète, consultez Codes d’erreur.

Exemple de réponse pour l’abonnement Microsoft Azure (MS-AZR-0145P)

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

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

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

Exemple de réponse pour le plan Azure

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

Pour les clients disposant de plans Azure, les modifications suivantes sont apportées à la réponse de l’API :

currencyLocale est remplacé par currencyCode
usdTotalCost est un nouveau champ

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

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Modern Azure Customer UK",
    "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",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}

Partage via