Získání rozpočtu na útratu využití zákazníka

Článek
06/27/2024

Platí pro: Partnerské centrum | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Rozpočet útraty (objekt SpendingBudget) můžete aktualizovat v souhrnu využití zákazníka (zdroj CustomerUsageSummary).

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

C#

Aktualizace rozpočtu na útratu využití zákazníka:

Vytvořte nový objekt SpendingBudget s aktualizovanou částkou.
Použijte kolekci IAggregatePartner.Customers k volání metody ById() s identifikátorem zadaného zákazníka.
Zavolejte metodu Get nebo GetAsync a získejte rozpočet využití zákazníka.

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

Požadavek REST

Syntaxe požadavku

metoda	Identifikátor URI žádosti
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

Parametr identifikátoru URI

K aktualizaci fakturačního profilu použijte následující parametr dotazu.

Name	Type	Požadováno	Popis
customer-tenant-id	identifikátor guid	Y	Hodnota je GUID formátované ID tenanta zákazníka, které umožňuje prodejci filtrovat výsledky pro daného zákazníka, který patří k prodejci.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Úplný prostředek.

Příklad požadavku

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"

Odpověď REST

V případě úspěchu vrátí tato metoda rozpočet útraty uživatele s aktualizovanou částkou.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím