Partilhar via


Azure spending - Get subscription usage records for a customer

Recupera registos de utilização de todas as subscrições de um determinado cliente para o período de faturação em curso.

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

Parâmetros do URI

Name Em Necessário Tipo Description
customer_id
path True

string

A identificação do cliente.

Cabeçalho do Pedido

Name Necessário Tipo Description
Authorization True

string

Ficha do Portador de Autorização

ms-correlationid

string

Usado para rastrear pedidos internamente. Se um ms-correlaid não for fornecido, o servidor gerará um novo para cada pedido

ms-cv

string

Usado para rastrear pedidos internamente. Se um ms-cv não for fornecido, o servidor gerará um novo para cada pedido

ms-requestid

string

Usado para idempoteência de pedidos. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada pedido

Respostas

Name Tipo Description
200 OK

Collections.PagedResourceCollection[UsageManagement.SubscriptionMonthlyUsageRecord]

O pedido foi bem sucedido. O corpo de resposta contém todos os registos de utilização de subscrições.

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

400 Bad Request

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

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

401 Unauthorized

O pedido não foi autenticado. O cliente precisa de autenticar primeiro com o serviço API do parceiro.

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

403 Forbidden

O pedido foi autenticado, mas foi recusado, uma vez que o chamador não tem o direito de o invocar.

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

404 Not Found

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

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

500 Internal Server Error

O serviço API do parceiro ou uma das suas dependências não cumpriu o pedido. Os chamadores podem voltar a tentar isto.

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

Definições

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

Collections.PagedResourceCollection[UsageManagement.SubscriptionMonthlyUsageRecord]

Name Tipo Description
attributes

ResourceAttributes

continuationToken

string

items

UsageManagement.SubscriptionMonthlyUsageRecord[]

links

ResourceLinks

totalCount

integer

Name Tipo Description
headers

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

method

string

uri

string

ResourceAttributes

Name Tipo Description
etag

string

objectType

string

Name Tipo Description
next

Link

previous

Link

self

Link

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

Name Tipo Description
key

string

value

string

UsageManagement.SubscriptionMonthlyUsageRecord

Name 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