Abrufen des Nutzungsausgabenbudgets eines Kunden
Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government
Sie können das Ausgabenbudget (das SpendingBudget-Objekt ) in der Kundennutzungszusammenfassung (die CustomerUsageSummary-Ressource ) aktualisieren.
Voraussetzungen
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung sowohl mit eigenständigen App- als auch mit App+Benutzeranmeldeinformationen.
Eine Kunden-ID (
customer-tenant-id
). Wenn Sie die ID des Kunden nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich Kunden und dann den Kunden aus der Kundenliste und dann Konto auswählen. Suchen Sie auf der Kontoseite des Kunden im Abschnitt Kundenkontoinfo nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id
).
C#
So aktualisieren Sie das Budget für die Nutzungsausgaben eines Kunden:
Erstellen Sie ein neues SpendingBudget-Objekt mit dem aktualisierten Betrag.
Verwenden Sie die IAggregatePartner.Customers-Auflistung , um die ById() -Methode mit dem angegebenen Kundenbezeichner aufzurufen.
Rufen Sie die Get- oder GetAsync-Methode auf, um das Nutzungsbudget des Kunden abzurufen.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// Create a new spending budget with the udpated amount.
var newUsageBudget = new SpendingBudget()
{
Amount = 100
};
// Update the customer's usage budget.
var usageBudget = partnerOperations.Customers.ById(selectedCustomerId).UsageBudget.Get();
REST-Anforderung
Anforderungssyntax
Methode | Anforderungs-URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1 |
URI-Parameter
Verwenden Sie den folgenden Abfrageparameter, um das Abrechnungsprofil zu aktualisieren.
Name | Typ | Erforderlich | BESCHREIBUNG |
---|---|---|---|
customer-tenant-id | guid | J | Der Wert ist eine GUID-formatierte Customer-Tenant-ID , mit der der Wiederverkäufer die Ergebnisse für einen bestimmten Kunden filtern kann, der zum Händler gehört. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Die vollständige Ressource.
Anforderungsbeispiel
GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/usagebudget HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"
REST-Antwort
Bei erfolgreicher Ausführung gibt diese Methode das Ausgabenbudget eines Benutzers mit dem aktualisierten Betrag zurück.
Erfolgs- und Fehlercodes der Antwort
Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.
Antwortbeispiel
HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
{
"amount": 100,
"usageSpendingBudget": 100,
"attributes":{
"objectType":"SpendingBudget"
}
},
"links":{
"self":{
"uri":"/v1/customers/<customer-tenant-id>/usagebudget",
"method":"GET",
"headers":[]
}
}
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für