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

Name Em Necessário Tipo Description
billing_period
path True

string

O período de faturação para o qual os custos do serviço estão a ser consultados. Atualmente, apenas "MostRecent" é suportado.

customer_id
path True

string

O ID do locatário do cliente.

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

ServiceCostsSummary

O pedido foi bem-sucedido. O corpo de 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

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

string

headers

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

method

string

uri

string

Collections.ResourceAttributes

Name Tipo Description
etag

string

objectType

string

Name Tipo Description
next

Collections.Link

previous

Collections.Link

self

Collections.Link

ServiceCostsSummary

Name 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

Name Tipo Description
invoiceType

string

summary

ServiceCostsSummary

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

Name Tipo Description
key

string

value

string