Manage billing - Get a customer's service costs summary
Ruft die Dienstkosten ab, die von den Abonnements des Kunden anfallen.
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/servicecosts/{billing_period}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
billing_period
|
path | True |
string |
Der Abrechnungszeitraum, für den die Servicekosten abgefragt werden. Derzeit wird nur "MostRecent" unterstützt. |
customer_id
|
path | True |
string |
Die Kundenmandanten-ID. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Authorization | True |
string |
Autorisierungs-Bearertoken |
ms-correlationid |
string |
Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue. |
|
ms-cv |
string |
Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn kein ms-cv bereitgestellt wird, generiert der Server für jede Anforderung eine neue. |
|
ms-requestid |
string |
Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Anforderung war erfolgreich. Der Antworttext enthält die angeforderten Kundendienstkosten. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
400 Bad Request |
Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
401 Unauthorized |
Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
403 Forbidden |
Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
404 Not Found |
Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
500 Internal Server Error |
Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer versuchen dies möglicherweise erneut. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
Definitionen
Collections.Link
Name | Typ | Beschreibung |
---|---|---|
body |
string |
|
headers |
System. |
|
method |
string |
|
uri |
string |
Collections.ResourceAttributes
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
|
objectType |
string |
Collections.ResourceLinks
Name | Typ | Beschreibung |
---|---|---|
next | ||
previous | ||
self |
ServiceCostsSummary
Name | Typ | Beschreibung |
---|---|---|
afterTaxTotal |
number |
|
attributes | ||
billingEndDate |
string |
|
billingStartDate |
string |
|
currencyCode |
string |
|
currencySymbol |
string |
|
customerId |
string |
|
details | ||
links | ||
pretaxTotal |
number |
|
tax |
number |
ServiceCostsSummaryDetail
Name | Typ | Beschreibung |
---|---|---|
invoiceType |
string |
|
summary |
System.Collections.Generic.KeyValuePair[System.String,System.String]
Name | Typ | Beschreibung |
---|---|---|
key |
string |
|
value |
string |