Compartilhar via


Azure spending - Get subscription usage records for a customer

Recupera registros de uso de todas as assinaturas de um determinado cliente para o período de cobrança atual.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
customer_id
path True

string

A ID do cliente.

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

A solicitação foi bem-sucedida. O corpo da resposta contém todos os registros de uso de assinaturas.

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

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"

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"

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"

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"

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"

Definições

Nome Description
Collections.PagedResourceCollection[UsageManagement.SubscriptionMonthlyUsageRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
UsageManagement.SubscriptionMonthlyUsageRecord

Collections.PagedResourceCollection[UsageManagement.SubscriptionMonthlyUsageRecord]

Nome Tipo Description
attributes

ResourceAttributes

continuationToken

string

items

UsageManagement.SubscriptionMonthlyUsageRecord[]

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

UsageManagement.SubscriptionMonthlyUsageRecord

Nome Tipo Description
attributes

ResourceAttributes

currencyCode

string

currencyLocale

string

currencySymbol

string

id

string

lastModifiedDate

string

name

string

offerId

string

partnerOnRecord

string

resourceId

string

resourceName

string

status enum:
  • active
  • deleted
  • none
  • suspended
totalCost

number

usdTotalCost

number