Získání všech záznamů o měsíčním využití pro předplatné
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:
K volání metody ById() použijte kolekci IAggregatePartner.Customers.
Volejte vlastnost Subscriptions (Předplatná ) a UsageRecords (UsageRecords) a potom vlastnost Resources (Prostředky ).
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:
- Ukázka: Testovací aplikace konzoly
- Projekt: PartnerSDK.FeatureSample
- Třída: SubscriptionResourceUsageRecords.cs
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: aaaa0000-bb11-2222-33cc-444444dddddd
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: bbbb1111-cc22-3333-44dd-555555eeeeee
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"
}
}