Få en användningssammanfattning för alla en kunds prenumerationer

Artikel
10/07/2024

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

Du kan använda resursen CustomerUsageSummary för att få en kunds användning av en specifik Azure-tjänst eller resurs under den aktuella faktureringsperioden.

Kommentar

I allmänhet är dagliga ej fakturerade användningsdata tillgängliga via API eller Partnercenter-portalen efter 24 timmar. Beroende på din plats och när mätarna rapporterar användning kan ytterligare fördröjningar uppstå.

Ibland kanske du inte ser de senaste ofakturerade användningsdata från början av månaden förrän föregående månads fakturerade användningsdata levereras. Detta för att se till att de fakturerade användningsdata levereras effektivt inom serviceavtalet. När du har fått de fakturerade användningsdata kan du börja hämta alla uppdaterade ej fakturerade användningsdata från början av månaden.

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 från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

C#

Så här får du en användningssammanfattning för alla en kunds prenumerationer:

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

Anropa egenskapen UsageSummary följt av metoderna Get() eller GetAsync():

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

var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();

Ett exempel finns i följande:

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

REST-begäran

Syntax för begäran

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

URI-parameter

Den här tabellen visar den frågeparameter som krävs för att hämta kundens klassificeringsinformation.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	Guid	Y	Ett GUID som motsvarar kunden.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-svar

Om det lyckas returnerar den här metoden en CustomerUsageSummary-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 Prenumeration på Microsoft Azure (MS-AZR-0145P)

I det här exemplet har kunden köpt 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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget":{
        "ammount":300.000000,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "id":"65726577-C208-40FD-9735-8C85AC9CAC68",
    "name":"600 test",
    "billingStartDate":"2016-02-06T00:00:00-08:00",
    "billingEndDate":"2016-03-05T00:00:00-08:00",
    "totalCost":0.0,
    "currencyLocale":"en-US",
    "lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
    "links":{
        "self":{
            "uri":"/customers/{customer-tenant-id}/usagesummary",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"CustomerUsageSummary"
    }
}

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 ändringar i API-svaret:

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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
    "resourceName": "Modern Azure Customer UK",
    "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",
    "attributes": {
        "objectType": "CustomerUsageSummary"
    }
}

Dela via