Ottenere i dati di utilizzo per una sottoscrizione per contatore

Articolo
10/07/2024

Si applica a: Centro per i partner | Centro per i partner per Microsoft Cloud for US Government

È possibile usare la raccolta di risorse MeterUsageRecord per ottenere i record di utilizzo dei contatori di un cliente per servizi o risorse di Azure specifici durante il periodo di fatturazione corrente. Questa raccolta di risorse rappresenta un totale aggregato per ogni contatore per il ciclo di fatturazione corrente, nell'intero piano di Azure.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con le credenziali app + utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).
ID sottoscrizione

Questa nuova route equivale a subscriptions/{subscription-id}/usagerecords/resources, che continuerà a funzionare solo per le sottoscrizioni di Microsoft Azure (MS-AZR-0145P). Questa nuova route supporta le sottoscrizioni di Microsoft Azure (MS-AZR-0145P) e i piani di Azure. Per ottenere queste informazioni per il piano di Azure, è necessario passare a questa nuova route. Oltre alle proprietà indicate nelle sezioni seguenti, la risposta è uguale alla route precedente.

C#

Per ottenere i record di utilizzo dei contatori di un cliente per un servizio o una risorsa di Azure specifici durante il periodo di fatturazione corrente:

Usare la raccolta IAggregatePartner.Customers per chiamare il metodo ById().

Chiamare la proprietà Subscriptions e UsageRecords, quindi la proprietà Meters . Fine chiamando i metodi Get() o GetAsync().

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

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

Per un esempio, vedere l'esempio seguente:

Esempio: App di test della console
Progetto: PartnerSDK.FeatureSamples
Classe: GetSubscriptionUsageRecordsByMeter.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1

Parametri URI

Questa tabella elenca i parametri di query necessari per ottenere le informazioni di utilizzo valutate del cliente.

Nome	Tipo	Obbligatoria	Descrizione
customer-tenant-id	guid	S	GUID corrispondente al cliente.
id sottoscrizione	guid	S	GUID corrispondente all'identificatore di una risorsa di sottoscrizione del Centro per i partner, che rappresenta una sottoscrizione di Microsoft Azure (MS-AZR-0145P) o un piano di Azure. Per le risorse della sottoscrizione del piano di Azure, specificare l'ID piano* come id sottoscrizione in questa route.*

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una risorsa PagedResourceCollection<MeterUsageRecord> nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per un elenco completo, vedere Codici di errore.

Esempio di risposta per le sottoscrizioni di Microsoft Azure (MS-AZR-0145P)

In questo esempio il cliente ha acquistato 145P Azure PayG.

Per i clienti con una sottoscrizione di Microsoft Azure (MS-AZR-0145P), non verrà apportata alcuna modifica alla risposta 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

{
    "totalCount": 1,
    "items": [
        {
            "status": "active",
            "offerId": "MS-AZR-0145P",
            "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
            "id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
            "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"
    }
}

Esempio di risposta REST per il piano di Azure

In questo esempio il cliente ha acquistato un piano di Azure.

Per i clienti con piani di Azure, sono disponibili le modifiche seguenti nella risposta all'API:

currencyLocale viene sostituito con currencyCode
usdTotalCost è un nuovo campo

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

Condividi tramite