Získání souhrnu využití pro všechna předplatná zákazníka

Článek
07. 10. 2024

Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Pomocí prostředku CustomerUsageSummary můžete získat využití konkrétní služby Nebo prostředku Azure zákazníka během aktuálního fakturačního období.

Poznámka

Obecně platí, že denně nefakturovaná data o využití jsou k dispozici prostřednictvím rozhraní API nebo portálu Partnerského centra po 24 hodinách. V závislosti na vaší poloze a na využití sestav měřičů může dojít k dalším zpožděním.

Někdy se nemusí zobrazit nejnovější nefakturovaná data o využití od začátku měsíce do doručení fakturovaných dat o využití za předchozí měsíc. Tím zajistíte efektivní doručení fakturovaných dat o využití v rámci smlouvy SLA. Jakmile obdržíte fakturovaná data o využití, můžete začít načítat všechna aktualizovaná nefakturovaná data o využití od začátku měsíce.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

C#

Získání souhrnu využití pro všechna předplatná zákazníka:

K volání metody ById() použijte kolekci IAggregatePartner.Customers.

Zavolejte vlastnost UsageSummary následovanou metodami Get() nebo GetAsync():

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

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

Příklad najdete v následujícím příkladu:

Ukázka: Konzolová testovací aplikace
Projekt: PartnerSDK.FeatureSamples
Třída: GetCustomerUsageSummary.cs

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1

Parametr identifikátoru URI

Tato tabulka obsahuje požadovaný parametr dotazu pro získání informací o využití s hodnocením zákazníka.

Name	Type	Požadováno	Popis
customer-tenant-id	Identifikátor guid	Y	Identifikátor GUID odpovídající zákazníkovi.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

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

Odpověď REST

Pokud je tato metoda úspěšná, vrátí v těle odpovědi prostředek CustomerUsageSummary .

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi pro předplatné Microsoft Azure (MS-AZR-0145P)

V tomto příkladu si zákazník koupil nabídku 145P Azure PayG .

Pro zákazníky s předplatnými Microsoft Azure (MS-AZR-0145P) nedojde k žádné změně odpovědi rozhraní 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

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

Příklad odpovědi pro plán Azure

V tomto příkladu zákazník zakoupil plán Azure.

Pro zákazníky s plány Azure existují následující změny odpovědi rozhraní API:

currencyLocale se nahrazuje kódem currencyCode.
usdTotalCost je nové 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: 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"
    }
}

Sdílet prostřednictvím