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

Servizio:

Partner Center Rest

Versione API:

v1

Ottiene l'utilizzo per le risorse che appartengono a una sottoscrizione di Azure di proprietà di un cliente del partner.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure

Con parametri facoltativi:

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}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
customer_id	path	True	string	ID del cliente proprietario della sottoscrizione.
subscription_id	path	True	string	ID della sottoscrizione di Azure per cui recuperare l'utilizzo.
end_time	query		string date-time	Ora finale di quando l'utilizzo è stato a consumo nel sistema di fatturazione.
granularity	query		string	Granularità del tempo di utilizzo delle risorse. Può essere giornaliera o oraria. Il defalt è giornaliero.
seek_operation	query		string	Operazione di ricerca da eseguire. È supportato solo Next.
show_details	query		boolean	Se impostato su true, i record di utilizzo verranno suddivisi per i livelli di istanza della risorsa. Se impostato su false, i record di utilizzo verranno aggregati a livello di risorsa. Il valore predefinito è true.
size	query		integer int32	Numero massimo facoltativo di record da restituire. Il valore predefinito è 1000. La raccolta di risorse restituita specifica un collegamento successivo nel caso in cui siano disponibili più record di utilizzo.
start_time	query		string date-time	Ora di inizio della misurazione dell'utilizzo nel sistema di fatturazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di connessione dell'autorizzazione
ms-correlationid		string	Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta
ms-cv		string	Usato per tenere traccia delle richieste internamente. Se non viene specificata una ms-cv, il server genererà un nuovo per ogni richiesta
ms-requestid		string	Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta

Risposte

Nome	Tipo	Descrizione
200 OK	Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]	La richiesta ha avuto esito positivo. Il corpo della risposta contiene la raccolta di risorse dei record di utilizzo di Azure. Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content	Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]	I dati non sono disponibili per l'ora di inizio e di fine specificata. Nessun contenuto viene restituito con un'intestazione retry-after. Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request		Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore. Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized		La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner. Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden		La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found		La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error		Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definizioni

Nome	Descrizione
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]

Nome	Tipo	Descrizione
attributes	ResourceAttributes
items	Utilizations.AzureUtilizationRecord[]
links	ResourceLinks
totalCount	integer

Link

Nome	Tipo	Descrizione
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

ResourceAttributes

Nome	Tipo	Descrizione
etag	string
objectType	string

ResourceLinks

Nome	Tipo	Descrizione
next	Link
previous	Link
self	Link

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

Nome	Tipo	Descrizione
key	string
value	string

Utilizations.AzureInstanceData

Nome	Tipo	Descrizione
additionalInfo	object
location	string
orderNumber	string
partNumber	string
resourceUri	string
tags	object

Utilizations.AzureResource

Nome	Tipo	Descrizione
category	string
id	string
name	string
region	string
subcategory	string

Utilizations.AzureUtilizationRecord

Nome	Tipo	Descrizione
attributes	ResourceAttributes
infoFields	object
instanceData	Utilizations.AzureInstanceData
quantity	number
resource	Utilizations.AzureResource
unit	string
usageEndTime	string
usageStartTime	string