Obtenir les données d’utilisation d’abonnement par compteurGet usage data for subscription by meter

S’applique à :Applies to:

  • Espace partenairesPartner Center
  • Espace partenaires de Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Espace partenaires de Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Vous pouvez utiliser la collection de ressources MeterUsageRecord pour obtenir les enregistrements d’utilisation de compteur d’un client pour des services ou des ressources Azure spécifiques pendant la période de facturation en cours.You can use the MeterUsageRecord resource collection to get meter usage records of a customer for specific Azure services or resources during the current billing period. Cette collection de ressources représente un total agrégé pour chaque compteur du cycle de facturation actuel, sur l’ensemble de votre plan Azure.This resource collection represents an aggregated total for each meter for the current billing cycle, across your entire Azure plan.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application et de l’utilisateur uniquement.This scenario supports authentication with App+User credentials only.

  • ID du client (customer-tenant-id).A customer ID (customer-tenant-id). Si vous ne connaissez pas l’ID du client, vous pouvez le rechercher dans le tableau de bord de l’Espace partenaires.If you don't know the customer's ID, you can look it up in the Partner Center dashboard. Sélectionnez CSP dans le menu Espace partenaires, puis Clients.Select CSP from the Partner Center menu, followed by Customers. Sélectionnez le client dans la liste des clients, puis Compte.Select the customer from the customer list, then select Account. Dans la page du compte du client, recherchez l’ID Microsoft dans la section Informations sur le compte client.On the customer’s Account page, look for the Microsoft ID in the Customer Account Info section. L’ID Microsoft est le même que l’ID de client (customer-tenant-id).The Microsoft ID is the same as the customer ID (customer-tenant-id).

  • Un ID d’abonnementA subscription ID

Ce nouvel itinéraire est équivalent à subscriptions/{subscription-id}/usagerecords/resources , qui continuera à fonctionner uniquement pour les abonnements Microsoft Azure (MS-AZR-0145P).This new route is equivalent to subscriptions/{subscription-id}/usagerecords/resources, which will continue to function only for Microsoft Azure (MS-AZR-0145P) subscriptions. Ce nouvel itinéraire prendra en charge à la fois les abonnements Microsoft Azure (MS-AZR-0145P) et les plans Azure.This new route will support both Microsoft Azure (MS-AZR-0145P) subscriptions and Azure plans. Pour obtenir ces informations pour votre plan Azure, vous devez passer à ce nouvel itinéraire.In order to get this information for your Azure plan, you need to switch to this new route. À part les propriétés mentionnées dans les sections suivantes, la réponse est la même que l’ancien itinéraire.Other than the properties mentioned in the following sections, the response is the same as the old route.

C#C#

Pour obtenir les enregistrements d’utilisation de compteur d’un client pour un service ou une ressource Azure spécifique pendant la période de facturation actuelle :To get meter usage records of a customer for a specific Azure service or resource during the current billing period:

  1. Utilisez votre collection collection iaggregatepartner. Customers pour appeler la méthode méthode BYID () .Use your IAggregatePartner.Customers collection to call the ById() method.

  2. Appelez la propriété subscriptions et UsageRecords, puis la propriété mètres .Call the Subscriptions property, and UsageRecords, then the Meters property. Terminez en appelant les méthodes d’extraction () ou GetAsync ().Finish by calling the Get() or GetAsync() methods.

    // IAggregatePartner partnerOperations;
    // var selectedCustomerId as string;
    // var selectedSubscriptionId as string;
    
    var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();
    

Pour obtenir un exemple, consultez l’exemple suivant :For an example, see the following sample:

  • Exemple : Application de test de consoleSample: Console test app
  • Projet : PartnerSDK. FeatureSamplesProject: PartnerSDK.FeatureSamples
  • Classe : GetSubscriptionUsageRecordsByMeter.csClass: GetSubscriptionUsageRecordsByMeter.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET {baseURL}/v1/Customers/{Customer-tenant-ID}/subscriptions/{subscription-ID}/meterusagerecords http/1.1{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1

Paramètres d’URIURI parameters

Ce tableau répertorie les paramètres de requête requis pour obtenir les informations d’utilisation évaluées du client.This table lists the required query parameters to get the customer's rated usage information.

NomName TypeType ObligatoireRequired DescriptionDescription
customer-tenant-idcustomer-tenant-id guidguid OY GUID correspondant au client.A GUID corresponding to the customer.
ID d’abonnementsubscription-id guidguid OY GUID correspondant à l’identificateur d’une ressource d’abonnementde l’espace partenaires, qui représente un abonnement Microsoft Azure (MS-AZR-0145P) ou un plan Azure.A GUID corresponding to the identifier of a Partner Center subscription resource, which represents a Microsoft Azure (MS-AZR-0145P) subscription or an Azure plan. Pour les ressources d’abonnement de plan Azure, indiquez l' ID de plan en tant qu' ID d’abonnement dans cet itinéraire.For Azure plan subscription resources, provide the plan-id as the subscription-id in this route.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Aucun.None.

Exemple de requêteRequest example

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords 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 RESTREST response

En cas de réussite, cette méthode retourne une ressource **PagedResourceCollection <MeterUsageRecord> ** dans le corps de la réponse.If successful, this method returns a PagedResourceCollection<MeterUsageRecord> resource in the response body.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, the error type, and additional parameters. Pour obtenir une liste complète, consultez codes d’erreur.For a full list, see Error Codes.

Exemple de réponse pour les abonnements Microsoft Azure (MS-AZR-0145P)Response example for Microsoft Azure (MS-AZR-0145P) subscriptions

Dans cet exemple, le client a acheté 145P Azure PayG.In this example, the customer purchased 145P Azure PayG.

Pour les clients disposant d’un abonnement Microsoft Azure (MS-AZR-0145P), aucune modification n’est apportée à la réponse de l’API.For customers with a Microsoft Azure (MS-AZR-0145P) subscription, there will be no change to API response.

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

{
    "totalCount": 1,
    "items": [
        {
            "status": "active",
            "offerId": "MS-AZR-0145P",
            "resourceId": "11111111-F347-41B6-B02C-187B1B778A43",
            "id": "11111111-F347-41B6-B02C-187B1B778A43",
            "resourceName": "Microsoft Azure",
            "name": "Microsoft Azure",
            "totalCost": 22.861172,
            "currencyLocale": "fr-FR",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
            "attributes": {
                "objectType": "SubscriptionMonthlyUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/{customer-tenant-id}/subscriptions/usagerecords/",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Exemple de réponse REST pour le plan AzureREST response example for Azure plan

Dans cet exemple, le client a acheté un plan Azure.In this example, the customer purchased an Azure plan.

Pour les clients disposant de plans Azure, les modifications suivantes ont été apportées à la réponse de l’API :For customers with Azure plans, there are the following changes in the API response:

  • currencyLocale est remplacé par currencyCodecurrencyLocale is replaced with currencyCode
  • usdTotalCost est un nouveau champusdTotalCost is a new field
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: Fri, 26 Feb 2016 20:31:45 GMT

{
    "totalCount": 4,
    "items": [
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNVX-005J-Data Transfer In (GB)",
            "meterName": "Data Transfer In",
            "category": "Bandwidth",
            "subcategory": "Bandwidth",
            "quantityUsed": 0.01129,
            "unit": "1 GB",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNVX-005J-Data Transfer Out (GB)",
            "meterName": "Data Transfer Out",
            "category": "Bandwidth",
            "subcategory": "Bandwidth",
            "quantityUsed": 0.000224,
            "unit": "1 GB",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNZ5-006G-10K Batch Write Operations",
            "meterName": "Batch Write Operations",
            "category": "Storage",
            "subcategory": "Tables",
            "quantityUsed": 0.2462,
            "unit": "10K",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNZ5-006G-Data Stored (GB/Month)",
            "meterName": "LRS Data Stored",
            "category": "Storage",
            "subcategory": "Tables",
            "quantityUsed": 0.002632,
            "unit": "1 GB/Month",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/meterusagerecords",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}