Pobieranie danych dotyczących użycia dla subskrypcji według miernika

Artykuł
10/07/2024

Dotyczy: Centrum partnerskie | Centrum partnerskie dla Microsoft Cloud for US Government

Możesz użyć kolekcji zasobów MeterUsageRecord , aby uzyskać rekordy użycia miernika klienta dla określonych usług platformy Azure lub zasobów w bieżącym okresie rozliczeniowym. Ta kolekcja zasobów reprezentuje zagregowaną sumę dla każdego miernika dla bieżącego cyklu rozliczeniowego w całym planie platformy Azure.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie tylko przy użyciu poświadczeń użytkownika i aplikacji.
Identyfikator klienta (customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz go wyszukać w Centrum partnerskim , wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta . Identyfikator Firmy Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).
Identyfikator subskrypcji

Ta nowa trasa jest odpowiednikiem subscriptions/{subscription-id}/usagerecords/resourcesdla subskrypcji platformy Microsoft Azure (MS-AZR-0145P). Ta nowa trasa będzie obsługiwać zarówno subskrypcje platformy Microsoft Azure (MS-AZR-0145P) i plany platformy Azure. Aby uzyskać te informacje dla planu platformy Azure, musisz przełączyć się na tę nową trasę. Poza właściwościami wymienionymi w poniższych sekcjach odpowiedź jest taka sama jak stara trasa.

C#

Aby uzyskać rekordy użycia miernika klienta dla określonej usługi platformy Azure lub zasobu w bieżącym okresie rozliczeniowym:

Użyj kolekcji IAggregatePartner.Customers, aby wywołać metodę ById().

Wywołaj właściwość Subscriptions i UsageRecords, a następnie właściwość Meter . Zakończ, wywołując metody Get() lub GetAsync().

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

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

Aby zapoznać się z przykładem, zobacz następujący przykład:

Przykład: aplikacja testowa konsoli
Projekt: PartnerSDK.FeatureSamples
Klasa: GetSubscriptionUsageRecordsByMeter.cs

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1

Parametry identyfikatora URI

Ta tabela zawiera listę wymaganych parametrów zapytania w celu uzyskania informacji o ocenianej użyciu klienta.

Nazwa	Typ	Wymagane	Opis
customer-tenant-id	Identyfikator guid	Y	Identyfikator GUID odpowiadający klientowi.
identyfikator subskrypcji	Identyfikator guid	Y	Identyfikator GUID odpowiadający identyfikatorowi zasobu subskrypcji Centrum partnerskiego, który reprezentuje subskrypcję platformy Microsoft Azure (MS-AZR-0145P) lub plan platformy Azure. W przypadku zasobów subskrypcji planu platformy Azure podaj identyfikator planu* jako identyfikator subskrypcji w tej trasie.*

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak.

Przykład żądania

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

Odpowiedź REST

W przypadku powodzenia ta metoda zwraca zasób PagedResourceCollection<MeterUsageRecord> w treści odpowiedzi.

Kody powodzenia odpowiedzi i błędów

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi dla subskrypcji platformy Microsoft Azure (MS-AZR-0145P)

W tym przykładzie klient kupił 145P Azure PayG.

W przypadku klientów z subskrypcją platformy Microsoft Azure (MS-AZR-0145P) nie będzie żadnych zmian w odpowiedzi interfejsu 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"
    }
}

Przykład odpowiedzi REST dla planu platformy Azure

W tym przykładzie klient kupił plan platformy Azure.

W przypadku klientów z planami platformy Azure istnieją następujące zmiany w odpowiedzi interfejsu API:

currencyLocale jest zastępowany walutąCode
usdTotalCost to nowe pole

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

Udostępnij za pośrednictwem