Condividi tramite


Azure spending - Get usage summary for customer's subscription

Recupera il riepilogo dell'utilizzo per tutte le risorse nella sottoscrizione di un determinato cliente per il periodo di fatturazione corrente.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
customer_id
path True

string

ID cliente.

subscription_id
path True

string

ID sottoscrizione.

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.PagedResourceCollection[UsageManagement.SubscriptionUsageSummary]

La richiesta ha avuto esito positivo. Il corpo della risposta contiene il riepilogo dell'utilizzo.

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.PagedResourceCollection[UsageManagement.SubscriptionUsageSummary]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
UsageManagement.SubscriptionUsageSummary

Collections.PagedResourceCollection[UsageManagement.SubscriptionUsageSummary]

Nome Tipo Descrizione
attributes

ResourceAttributes

continuationToken

string

items

UsageManagement.SubscriptionUsageSummary[]

links

ResourceLinks

totalCount

integer (int32)

Nome Tipo Descrizione
headers

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

method

string

uri

string

ResourceAttributes

Nome Tipo Descrizione
etag

string

objectType

string

Nome Tipo Descrizione
next

Link

previous

Link

self

Link

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

Nome Tipo Descrizione
key

string

value

string

UsageManagement.SubscriptionUsageSummary

Nome Tipo Descrizione
attributes

ResourceAttributes

billingEndDate

string (date-time)

billingStartDate

string (date-time)

currencyCode

string

currencyLocale

string

id

string

lastModifiedDate

string (date-time)

links

ResourceLinks

name

string

resourceId

string

resourceName

string

totalCost

number (double)

usdTotalCost

number (double)