Sdílet prostřednictvím

Manage billing - Get a customer's utilization records for Azure

  • Reference
Služba:
Partner Center Rest
Verze rozhraní API:
v1

Získá využití prostředků, které patří do předplatného Azure vlastněného zákazníkem partnera.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
S volitelnými parametry: 
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
customer_id
 path True

string

ID zákazníka, který vlastní předplatné.
subscription_id
 path True

string

ID předplatného Azure, pro které se načte využití.
end_time
 query

string

date-time

Koncový čas měření využití ve fakturačním systému.
granularity
 query

string

Časové intervaly využití prostředků. Může být buď denně, nebo hodinově. Defalt je denně.
seek_operation
 query

string

Operace hledání, která se má provést. Podporuje se pouze další.
show_details
 query

boolean

Pokud je nastavená hodnota true, záznamy o využití se rozdělí podle úrovní instance prostředku. Pokud je nastavená hodnota false, záznamy o využití se agregují na úrovni prostředku. Výchozí hodnota je true.
size
 query

integer

int32

Volitelný maximální počet záznamů, které se mají vrátit. Výchozí hodnota je 1000. Vrácená kolekce prostředků určí další odkaz pro případ, že budou k dispozici více záznamů o využití.
start_time
 query

string

date-time

Počáteční čas, kdy bylo využití měřeno ve fakturačním systému.

Hlavička požadavku

Name Vyžadováno Typ Description
Authorization True

string

Autorizační nosný token
ms-correlationid

string

Používá se pro interní sledování požadavků. Pokud není zadaný parametr ms-correlationid, server pro každý požadavek vygeneruje nový.
ms-cv

string

Používá se pro interní sledování požadavků. Pokud není zadaný ms-cv, server pro každý požadavek vygeneruje nový.
ms-requestid

string

Používá se k idempotenci požadavků. Pokud není zadaný identifikátor ms-requestid, server pro každý požadavek vygeneruje nový.

Odpovědi

Name Typ Description
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Požadavek byl úspěšný. Tělo odpovědi obsahuje kolekci prostředků, které využívá Azure.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Data nejsou k dispozici pro daný počáteční a koncový čas. Žádný obsah se nevrácí s hlavičkou opakování.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Došlo k chybě nebo neplatnému vstupu. Text odpovědi poskytne podrobnosti o chybě.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

Požadavek nebyl ověřen. Klient se musí nejprve ověřit ve službě partnerského rozhraní API.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

Žádost byla ověřena, ale byla odmítnuta, protože volající nemá práva k jeho vyvolání.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

Prostředek nebyl nalezen nebo není k dispozici s danými vstupními parametry.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

Službě partnerského rozhraní API nebo některé z jejích závislostí se nepodařilo splnit požadavek. Volající to možná zkusí znovu.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definice

Name Description
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
Utilizations.AzureInstanceData
Utilizations.AzureResource
Utilizations.AzureUtilizationRecord

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Name Typ Description
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Name Typ Description
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Name Typ Description
etag

string

objectType

string

Name Typ Description
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Name Typ Description
key

string

value

string

Utilizations.AzureInstanceData

Name Typ Description
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Name Typ Description
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Name Typ Description
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string