Compartilhar via


Manage billing - Get a customer's service costs summary

Recupera os custos de serviço incorridos pelas assinaturas do cliente.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/servicecosts/{billing_period}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
billing_period
path True

string

O período de cobrança para o qual os custos do serviço estão sendo consultados. Atualmente, há suporte apenas para "MostRecent".

customer_id
path True

string

A ID do locatário 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

ServiceCostsSummary

A solicitação foi bem-sucedida. O corpo da resposta contém os custos de atendimento ao cliente solicitados.

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.Link
Collections.ResourceAttributes
Collections.ResourceLinks
ServiceCostsSummary
ServiceCostsSummaryDetail
System.Collections.Generic.KeyValuePair[System.String,System.String]
Nome Tipo Description
body

string

headers

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

method

string

uri

string

Collections.ResourceAttributes

Nome Tipo Description
etag

string

objectType

string

Nome Tipo Description
next

Collections.Link

previous

Collections.Link

self

Collections.Link

ServiceCostsSummary

Nome Tipo Description
afterTaxTotal

number

attributes

Collections.ResourceAttributes

billingEndDate

string

billingStartDate

string

currencyCode

string

currencySymbol

string

customerId

string

details

ServiceCostsSummaryDetail[]

links

Collections.ResourceLinks

pretaxTotal

number

tax

number

ServiceCostsSummaryDetail

Nome Tipo Description
invoiceType

string

summary

ServiceCostsSummary

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

Nome Tipo Description
key

string

value

string