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

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 do URI

Name	Em	Necessá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 recuperar a utilização.
end_time	query		string date-time	A hora final de quando a utilização foi medida no sistema de faturamento.
granularity	query		string	A granularidade do tempo de uso do recurso. Pode ser diário ou horário. Defalt é diário.
seek_operation	query		string	A operação de busca para executar. Apenas Next é suportado.
show_details	query		boolean	Se definido como true, os registros de utilização serão divididos pelos níveis de instância de recurso. Se definido como false, os registros de utilização serão agregados no nível do recurso. O padrão é true.
size	query		integer int32	Um número máximo opcional de registos a devolver. 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 medida no sistema de faturamento.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Authorization	True	string	Token de portador de autorização
ms-correlationid		string	Usado para rastrear 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 rastrear 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 idempotência de solicitações. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada solicitação

Respostas

Name	Tipo	Description
200 OK	Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]	O pedido foi bem-sucedido. 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 de fim indicada. Nenhum conteúdo é retornado com um cabeçalho de repetição posterior. 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		O pedido não foi autenticado. O cliente precisa se autenticar com o serviço de API do parceiro primeiro. Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden		O pedido foi autenticado, mas foi recusado, uma vez que o autor da chamada não tem o direito de o invocar. Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found		O recurso não é encontrado ou não está disponível com os parâmetros de entrada fornecidos. 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 tentar novamente. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definições

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	Tipo	Description
attributes	ResourceAttributes
items	Utilizations.AzureUtilizationRecord[]
links	ResourceLinks
totalCount	integer

Link

Name	Tipo	Description
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

ResourceAttributes

Name	Tipo	Description
etag	string
objectType	string

ResourceLinks

Name	Tipo	Description
next	Link
previous	Link
self	Link

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

Name	Tipo	Description
key	string
value	string

Utilizations.AzureInstanceData

Name	Tipo	Description
additionalInfo	object
location	string
orderNumber	string
partNumber	string
resourceUri	string
tags	object

Utilizations.AzureResource

Name	Tipo	Description
category	string
id	string
name	string
region	string
subcategory	string

Utilizations.AzureUtilizationRecord

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