Ügyfél használati költségkeretének lekérése

A következőre vonatkozik: Partnerközpont | Partnerközpont Microsoft Cloud for US Government

A költségkeretet (a SpendingBudget objektumot ) az ügyfélhasználat összegzésében (a CustomerUsageSummary erőforrásban) frissítheti.

Előfeltételek

• Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a különálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

• Ügyfél-azonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából az ügyféllistából, majd a Fiók lehetőség kiválasztásával. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

C#

Az ügyfél használati költségkeretének frissítése:

1. Hozzon létre egy új SpendingBudget objektumot a frissített összeggel.

2. Az IAggregatePartner.Customers gyűjtemény használatával hívja meg a ById() metódust a megadott ügyfélazonosítóval.

3. Hívja meg a Get vagy a GetAsync metódust az ügyfél használati költségkeretének lekéréséhez.

// 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-kérelem

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1

URI-paraméter

A számlázási profil frissítéséhez használja az alábbi lekérdezési paramétert.

Név	Típus	Kötelező	Leírás
customer-tenant-id	guid	Y	Az érték egy GUID formátumú ügyfél-bérlő-azonosító , amely lehetővé teszi, hogy a viszonteladó szűrje a viszonteladóhoz tartozó adott ügyfél eredményeit.

Kérésfejlécek

További információ: Partnerközpont REST-fejlécei.

A kérés törzse

A teljes erőforrás.

Példa kérésre

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-válasz

Ha ez a módszer sikeres, a felhasználó költségkeretét adja vissza a frissített összeggel.

Sikeres válasz és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát lásd: Hibakódok.

Példa válaszra

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