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 |
Żą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. |
|
Collections. |
|
Collections. |
|
Service |
|
Service |
|
System. |
Collections.Link
Nazwa | Typ | Opis |
---|---|---|
body |
string |
|
headers |
System. |
|
method |
string |
|
uri |
string |
Collections.ResourceAttributes
Nazwa | Typ | Opis |
---|---|---|
etag |
string |
|
objectType |
string |
Collections.ResourceLinks
Nazwa | Typ | Opis |
---|---|---|
next | ||
previous | ||
self |
ServiceCostsSummary
Nazwa | Typ | Opis |
---|---|---|
afterTaxTotal |
number |
|
attributes | ||
billingEndDate |
string |
|
billingStartDate |
string |
|
currencyCode |
string |
|
currencySymbol |
string |
|
customerId |
string |
|
details | ||
links | ||
pretaxTotal |
number |
|
tax |
number |
ServiceCostsSummaryDetail
Nazwa | Typ | Opis |
---|---|---|
invoiceType |
string |
|
summary |
System.Collections.Generic.KeyValuePair[System.String,System.String]
Nazwa | Typ | Opis |
---|---|---|
key |
string |
|
value |
string |