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

Článek
10/07/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