Freigeben über


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

ServiceCostsSummary

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

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

string

headers

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

method

string

uri

string

Collections.ResourceAttributes

Name Typ Beschreibung
etag

string

objectType

string

Name Typ Beschreibung
next

Collections.Link

previous

Collections.Link

self

Collections.Link

ServiceCostsSummary

Name Typ Beschreibung
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 Typ Beschreibung
invoiceType

string

summary

ServiceCostsSummary

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

Name Typ Beschreibung
key

string

value

string