Ügyfél használati költségkeretének lekérése
A következőre vonatkozik: Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára
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 az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Ügyfélazonosí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, majd a Fiók listában. 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:
Hozzon létre egy új SpendingBudget objektumot a frissített összeggel.
Az IAggregatePartner.Customers gyűjtemény használatával hívja meg a ById() metódust a megadott ügyfélazonosítóval.
Az ügyfél használati költségkeretének lekéréséhez hívja meg a Get vagy a GetAsync metódust.
// 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érés
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 |
---|---|---|---|
ügyfél-bérlő-azonosító | Guid | I | 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écek.
Kérés törzse
A teljes erőforrás.
Példa kérése
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 sikeres, ez a módszer visszaadja a felhasználó költségkeretét a frissített összeggel.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint egyéb hibakeresési információkat. A kód, hibatípus és egyéb paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.
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": []
}
}
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: