Hämta användningssammanfattning för kundens prenumeration

Artikel
01/29/2024

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

Du kan använda resursen SubscriptionUsageSummary för att få en sammanfattning av prenumerationsanvändningen för en kund. Den här resursen representerar sammanfattningen av prenumerationsanvändningen för en specifik Azure-tjänst eller resurs under den aktuella faktureringsperioden.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med 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

C#

Så här får du en sammanfattning av prenumerationsanvändningen för en kunds prenumeration:

Använd din IAggregatePartner.Customers-samling för att anropa metoden ById().

Anropa sedan egenskapen Prenumerationer och egenskapen UsageSummary . Slutför genom att anropa metoderna Get() eller GetAsync().

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

var subscriptionUsageSummary = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageSummary.Get();

Ett exempel finns i följande:

Exempel: Konsoltestapp
Projekt: PartnerSDK.FeatureSamples
Klass: GetSubscriptionUsageSummary.cs

REST-begäran

Begärandesyntax

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

URI-parametrar

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

Namn	Typ	Obligatorisk	Beskrivning
customer-tenant-id	Guid	Y	Ett GUID som motsvarar kunden.
prenumerations-ID	Guid	Y	Ett GUID som motsvarar identifieraren för en prenumeration. För en Azure-plan är detta identifieraren för motsvarande PartnerCenter-prenumerationsresurs, som representerar Azure-planen. För Prenumerationsresurser för Azure-plan anger du plan-id* som prenumerations-ID i den här vägen.*

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/{subscription-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

REST-svar

Om det lyckas returnerar den här metoden en SubscriptionUsageSummary-resurs 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. En fullständig lista finns i Felkoder.

Svarsexempel för Prenumerationer på Microsoft Azure (MS-AZR-0145P)

I det här exemplet köpte kunden ett 145P Azure PayG-erbjudande .

För kunder med Microsoft Azure-prenumerationer (MS-AZR-0145P) ändras inte API-svaret.

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

{
    "resourceId": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "id": "ABCDEFGH-F347-41B6-B02C-187B1B778A43",
    "resourceName": "Microsoft Azure",
    "name": "Microsoft Azure",
    "billingStartDate": "2019-08-28T00:00:00-07:00",
    "billingEndDate": "2019-09-27T00:00:00-07:00",
    "totalCost": 22.861172,
    "currencyLocale": "fr-FR",
    "lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

REST-svarsexempel för Azure-plan

I det här exemplet köpte kunden en Azure-plan.

För kunder med Azure-planer finns följande API-svarsändringar:

currencyLocale ersätts med currencyCode
usdTotalCost är ett nytt fält

HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac1
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "resourceId": "11111111-dca5-6f31-d3a6-dbbfad9be0fc",
    "resourceName": "Azure plan",
    "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",
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/usagesummary",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SubscriptionUsageSummary"
    }
}

Dela via