Hämta alla månatliga användningsposter för en prenumeration

Artikel
10/07/2024

Gäller för: Partnercenter | Partnercenter för Microsoft Cloud for US Government

Du kan använda resurssamlingen AzureResourceMonthlyUsageRecord för att hämta en lista över tjänster i en kunds prenumeration och deras associerade klassificerade användningsinformation.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående App- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden i kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
En prenumerationsidentifierare.

Det här API:et stöder endast Microsoft Azure-prenumerationer (MS-AZR-0145P). Om du använder en Azure-plan kan du läsa Hämta användningsdata för prenumeration per mätare i stället.

C#

Så här hämtar du en prenumerations resursanvändningsinformation:

Använd din IAggregatePartner.Customers-samling för att anropa metoden ById().
Anropa egenskapen Prenumerationer och UsageRecords och sedan egenskapen Resurser .
Anropa metoderna Get() eller GetAsync().

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

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

Ett exempel finns i följande:

Exempel: Konsoltestapp
Projekt: PartnerSDK.FeatureSample
Klass: SubscriptionResourceUsageRecords.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1

URI-parametrar

Den här tabellen visar de frågeparametrar som krävs för att hämta den klassificerade användningsinformationen.

Namn	Typ	Obligatorisk	Beskrivning
customer-tenant-id	Guid	Y	Ett GUID som motsvarar kunden.
prenumerations-ID	Guid	Y	Ett GUID som motsvarar prenumerationen.

Begärandehuvuden

Mer information finns i REST-huvuden i Partnercenter.

Begärandetext

Inga.

Exempel på begäran

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 65b26053-37d0-4303-9fd1-46ad8012bcb6
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-svar

Om det lyckas returnerar den här metoden en samling AzureResourceMonthlyUsageRecord-resurser i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Exempel på svar

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    "totalCount":20,
    "items":[{
        "category":"Storage",
        "subcategory":"LOCALLY REDUNDANT",
        "quantityUsed":0.151287527825352,
        "unit":"GB",
        "id":"2a2419c0-cefe-46b2-8004-8eb002ad606c",
        "name":"Azure Resource 1",
        "totalCost":0.195779159290613,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    },
    {
        "category":"Remote App",
        "subcategory":"Remote App",
        "quantityUsed":0.932546524299563,
        "unit":"GB",
        "id":"7e4099c8-2b3d-41a6-a1bd-d5cf315989b2",
        "name":"Azure Resource 2",
        "totalCost":0.920983775016379,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    }],
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription>%20/usagerecords",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"Collection"
    }
}

Dela via