Aktualisieren des Nutzungsausgabenbudgets eines Kunden

Artikel
10/07/2024

Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government

Aktualisieren Sie das Ausgabenbudget , das für die Nutzung eines Kunden zugewiesen ist.

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#

Um das Budget für die Nutzungsausgaben eines Kunden zu aktualisieren, erstellen Sie zunächst ein neues SpendingBudget-Objekt mit dem aktualisierten Betrag. Verwenden Sie dann die IAggregatePartner.Customers-Auflistung , und rufen Sie die ById() -Methode mit der angegebenen Kunden-ID auf. Greifen Sie dann auf die UsageBudget-Eigenschaft zu, und übergeben Sie das aktualisierte Nutzungsbudget an die Patch() - oder PatchAsync()- Methode.

// 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.Patch(newUsageBudget);

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
PATCH	{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

PATCH 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: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

{
     "Amount": 100,
     "Attributes": {
          "ObjectType": "SpendingBudget"
     }
}

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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    {
        "amount": 100,
        "usageSpendingBudget": 100,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/usagebudget",
            "method":"PATCH",
            "headers":[]
        }
    }
}

Teilen über