Získání všech záznamů o měsíčním využití pro předplatné

  • Článek

Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud for US Government

Pomocí kolekce prostředků AzureResourceMonthlyUsageRecord můžete získat seznam služeb v rámci předplatného zákazníka a informace o jejich přidruženém poměru využití.

Požadavky

  • Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud ID zákazníka neznáte, můžete ho vyhledat v Partnerském centru tak, že vyberete pracovní prostor Zákazníci , pak zákazníka ze seznamu zákazníků a pak Účet. Na stránce Účet zákazníka vyhledejte Microsoft ID v části Informace o účtu zákazníka . ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

  • Identifikátor předplatného.

Toto rozhraní API podporuje jenom předplatná Microsoft Azure (MS-AZR-0145P). Pokud používáte plán Azure, přečtěte si téma Získání dat o využití předplatného podle měřiče .

C#

Získání informací o využití prostředků předplatného:

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

  2. Volejte vlastnost Subscriptions (Předplatná ) a UsageRecords (UsageRecords) a potom vlastnost Resources (Prostředky ).

  3. Volejte metody Get() nebo GetAsync().

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

var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Resources.Get();

Příklad:

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1

Parametry identifikátoru URI

Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro získání informací o jmenovité využití.

Název Typ Vyžadováno Popis
customer-tenant-ID Identifikátor guid Y Identifikátor GUID odpovídající zákazníkovi.
ID předplatného Identifikátor guid Y Identifikátor GUID odpovídající předplatnému.

Hlavičky požadavku

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

Text požadavku

Žádné

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 65b26053-37d0-4303-9fd1-46ad8012bcb6
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

Odpověď REST

V případě úspěchu vrátí tato metoda kolekci prostředků AzureResourceMonthlyUsageRecord v těle odpovědi.

Kódy úspěšných odpovědí a chyb

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 trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: 648a26a4-a63e-459f-844b-4f29d7913353
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    "totalCount":20,
    "items":[{
        "category":"Storage",
        "subcategory":"LOCALLY REDUNDANT",
        "quantityUsed":0.151287527825352,
        "unit":"GB",
        "id":"2a2419c0-cefe-46b2-8004-8eb002ad606c",
        "name":"Azure Resource 1",
        "totalCost":0.195779159290613,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    },
    {
        "category":"Remote App",
        "subcategory":"Remote App",
        "quantityUsed":0.932546524299563,
        "unit":"GB",
        "id":"7e4099c8-2b3d-41a6-a1bd-d5cf315989b2",
        "name":"Azure Resource 2",
        "totalCost":0.920983775016379,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    }],
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription>%20/usagerecords",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"Collection"
    }
}