Partilhar via


Azure spending - Get usage summary for customer's subscription

Recupera o resumo de uso de todos os recursos na assinatura de um determinado cliente para o período de cobrança atual.

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

Parâmetros do URI

Name Em Necessário Tipo Description
customer_id
path True

string

O ID do cliente.

subscription_id
path True

string

O ID da assinatura.

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

O pedido foi bem-sucedido. O corpo da resposta contém o resumo de uso.

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

Collections.PagedResourceCollection[UsageManagement.SubscriptionUsageSummary]

Name Tipo Description
attributes

ResourceAttributes

continuationToken

string

items

UsageManagement.SubscriptionUsageSummary[]

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.SubscriptionUsageSummary

Name Tipo Description
attributes

ResourceAttributes

billingEndDate

string

billingStartDate

string

currencyCode

string

currencyLocale

string

id

string

lastModifiedDate

string

links

ResourceLinks

name

string

resourceId

string

resourceName

string

totalCost

number

usdTotalCost

number