Hämta en kunds utgiftsbudget för användning

Artikel
06/27/2024

Gäller för: Partnercenter | Partnercenter för Microsoft Cloud for US Government

Du kan uppdatera utgiftsbudgeten (utgiftsbudgetobjektet) i kundanvändningssammanfattningen (customerUsageSummary-resursen).

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

C#

Så här uppdaterar du en kunds utgiftsbudget för användning:

Skapa ett nytt SpendingBudget-objekt med det uppdaterade beloppet.
Använd samlingen IAggregatePartner.Customers för att anropa metoden ById() med den angivna kundens identifierare.
Anropa metoden Get eller GetAsync för att hämta kundens användningsbudget.

// 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-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

URI-parameter

Använd följande frågeparameter för att uppdatera faktureringsprofilen.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	GUID	Y	Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Den fullständiga resursen.

Exempel på begäran

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

REST-svar

Om det lyckas returnerar den här metoden en användares utgiftsbudget med det uppdaterade beloppet.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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

Dela via