Compartilhar via

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

  • Referência
Serviço:
Partner Center Rest
Versão da API:
v1

Obtém a utilização de recursos que pertencem a uma assinatura do Azure de propriedade de um cliente do parceiro.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
Com parâmetros opcionais: 
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}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
customer_id
 path True

string

A ID do cliente que possui a assinatura.
subscription_id
 path True

string

A ID da assinatura do Azure para a qual recuperar a utilização.
end_time
 query

string

date-time

A hora final de quando a utilização foi limitada no sistema de cobrança.
granularity
 query

string

A granularidade do tempo de uso do recurso. Pode ser diária ou por hora. Defalt é diário.
seek_operation
 query

string

A operação de busca a ser executada. Somente o Next tem suporte.
show_details
 query

boolean

Se definido como true, os registros de utilização serão divididos pelos níveis da instância de recurso. Se definido como false, os registros de utilização serão agregados no nível do recurso. O padrão é verdadeiro.
size
 query

integer

int32

Um número máximo opcional de registros a serem retornados. O padrão é 1000. A coleção de recursos retornada especificará um próximo link caso houvesse mais registros de utilização disponíveis.
start_time
 query

string

date-time

A hora inicial de quando a utilização foi limitada no sistema de cobrança.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
Authorization True

string

Token de portador de autorização
ms-correlationid

string

Usado para acompanhar solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação
ms-cv

string

Usado para acompanhar solicitações internamente. Se um ms-cv não for fornecido, o servidor gerará um novo para cada solicitação
ms-requestid

string

Usado para idempotency de solicitações. Se uma ms-requestid não for fornecida, o servidor gerará uma nova para cada solicitação

Respostas

Nome Tipo Description
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

A solicitação foi bem-sucedida. O corpo da resposta contém a coleção de recursos de registros de utilização do Azure.

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

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Os dados não estão disponíveis para a hora de início e término fornecidas. Nenhum conteúdo é retornado com um cabeçalho após a repetição.

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

Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro.

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

A solicitação não foi autenticada. Primeiro, o cliente precisa se autenticar com o serviço de API do parceiro.

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

A solicitação foi autenticada, mas foi recusada, pois o chamador não tem os direitos de invocá-la.

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

O recurso não foi encontrado ou não está disponível com os parâmetros de entrada especificados.

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

O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir isso.

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

Definições

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

Nome Tipo Description
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Nome Tipo Description
headers

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

method

string

uri

string

ResourceAttributes

Nome Tipo Description
etag

string

objectType

string

Nome Tipo Description
next

Link

previous

Link

self

Link

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

Nome Tipo Description
key

string

value

string

Utilizations.AzureInstanceData

Nome Tipo Description
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Nome Tipo Description
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Nome Tipo Description
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string