Udostępnij za pośrednictwem


Manage billing - Get a customer's service costs summary

Pobiera koszty usług poniesione przez subskrypcje klienta.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
billing_period
path True

string

Okres rozliczeniowy, dla którego są wykonywane zapytania dotyczące kosztów usług. Obecnie obsługiwany jest tylko element "MostRecent".

customer_id
path True

string

Identyfikator dzierżawy klienta.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Authorization True

string

Token elementu nośnego autoryzacji

ms-correlationid

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano identyfikatora ms-correlationid, serwer wygeneruje nowy dla każdego żądania

ms-cv

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano ms-cv, serwer wygeneruje nowy dla każdego żądania

ms-requestid

string

Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, serwer wygeneruje nowy dla każdego żądania

Odpowiedzi

Nazwa Typ Opis
200 OK

ServiceCostsSummary

Żądanie zakończyło się pomyślnie. Treść odpowiedzi zawiera żądane koszty obsługi klienta.

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

400 Bad Request

Brak danych wejściowych lub nieprawidłowy. Treść odpowiedzi udostępni szczegóły błędu.

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

401 Unauthorized

Żądanie nie zostało uwierzytelnione. Klient musi najpierw uwierzytelnić się za pomocą usługi interfejsu API partnera.

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

403 Forbidden

Żądanie zostało uwierzytelnione, ale zostało odrzucone, ponieważ obiekt wywołujący nie ma praw do jego wywołania.

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

404 Not Found

Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi.

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

500 Internal Server Error

Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Osoby wywołujące mogą ponowić próbę.

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

Definicje

Nazwa Opis
Collections.Link
Collections.ResourceAttributes
Collections.ResourceLinks
ServiceCostsSummary
ServiceCostsSummaryDetail
System.Collections.Generic.KeyValuePair[System.String,System.String]
Nazwa Typ Opis
body

string

headers

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

method

string

uri

string

Collections.ResourceAttributes

Nazwa Typ Opis
etag

string

objectType

string

Nazwa Typ Opis
next

Collections.Link

previous

Collections.Link

self

Collections.Link

ServiceCostsSummary

Nazwa Typ Opis
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

Nazwa Typ Opis
invoiceType

string

summary

ServiceCostsSummary

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

Nazwa Typ Opis
key

string

value

string