Abrufen des Budgets für Nutzungsausgaben eines Kunden

Artikel
06/27/2024

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

Sie können das Ausgabenbudget (das AusgabenBudget-Objekt ) in der Kundennutzungszusammenfassung (die Ressource "CustomerUsageSummary ") aktualisieren.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die KUNDEN-ID 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 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 bezeichner des angegebenen Kunden 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	Type	Erforderlich	Beschreibung
customer-tenant-id	guid	Y	Der Wert ist eine GUID-formatierte Kundenmandanten-ID , die es dem Händler ermöglicht, die Ergebnisse für einen bestimmten Kunden zu filtern, 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 Erfolg oder Fehler und andere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

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": []
        }
    }
}

Teilen über