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

  • Článek

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:

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

  2. 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:

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: 47c36033-af5d-4457-80a4-512c1626fac4

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: 47c36033-af5d-4457-80a4-512c1626fac4
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: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    "budget": {
        "amount": 97,
        "attributes": {
            "objectType": "SpendingBudget"
        }
    },
    "resourceId": "44908a11-641b-4c53-b7fc-0f2bfca8a581",
    "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"
    }
}