Használati összegzés lekérése az ügyfél összes előfizetéséhez
A következőre vonatkozik: Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára
A CustomerUsageSummary erőforrással lekérheti egy adott Azure-szolgáltatás vagy erőforrás ügyfél általi használatát az aktuális számlázási időszakban.
Megjegyzés:
A napi minősítéssel nem rendelkező használati adatok általában 24 óra elteltével érhetők el az API-n vagy a Partnerközpont portálján keresztül. A tartózkodási helytől és a fogyasztásmérők használatától függően további késések léphetnek fel.
Előfordulhat, hogy a hónap elejétől kezdve az előző havi számlázott használati adatok kézbesítéséig nem jelennek meg a legutóbbi nem korlátlan használati adatok. Ez annak biztosítása, hogy a számlázott használati adatok hatékonyan legyenek kézbesítve az SLA-on belül. Miután megkapta a számlázott használati adatokat, megkezdheti a hónap elejétől kezdődően az összes frissített nembilált használati adat lekérését.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.
Ü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 összes előfizetéséhez tartozó használati összegzés lekérése:
Az IAggregatePartner.Customers gyűjtemény használatával hívja meg a ById() metódust.
Hívja meg a UsageSummary tulajdonságot, amelyet a Get() vagy a GetAsync() metódus követ:
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();
Példaként tekintse meg a következőket:
- Minta: Konzoltesztelő alkalmazás
- Projekt: PartnerSDK.FeatureSamples
- Osztály: GetCustomerUsageSummary.cs
REST-kérés
Kérés szintaxisa
Metódus | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1 |
URI-paraméter
Ez a táblázat felsorolja az ügyfél névleges használati adatainak lekéréséhez szükséges lekérdezési paramétert.
Name | Type | Kötelező | Leírás |
---|---|---|---|
ügyfél-bérlő-azonosító | Guid | Y | Az ügyfélnek megfelelő GUID. |
Kérésfejlécek
További információ: Partnerközpont – REST fejlécek.
Kérés törzse
Nincs.
Példa kérése
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
REST-válasz
Ha sikeres, ez a metódus egy CustomerUsageSummary erőforrást ad vissza a válasz törzsében.
Válasz sikeresség é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. A kód, a hibatípus és a további 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.
Válaszpéldát a Microsoft Azure (MS-AZR-0145P) előfizetéshez
Ebben a példában az ügyfél egy 145P-s Azure PayG-ajánlatot vásárolt.
A Microsoft Azure (MS-AZR-0145P) előfizetéssel rendelkező ügyfelek esetében az API-válasz nem változik.
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"budget":{
"ammount":300.000000,
"attributes":{
"objectType":"SpendingBudget"
}
},
"id":"65726577-C208-40FD-9735-8C85AC9CAC68",
"name":"600 test",
"billingStartDate":"2016-02-06T00:00:00-08:00",
"billingEndDate":"2016-03-05T00:00:00-08:00",
"totalCost":0.0,
"currencyLocale":"en-US",
"lastModifiedDate":"2016-02-26T09:42:54.5130558+00:00",
"links":{
"self":{
"uri":"/customers/{customer-tenant-id}/usagesummary",
"method":"GET",
"headers":[]
}
},
"attributes":{
"objectType":"CustomerUsageSummary"
}
}
Példa válasz az Azure-csomagra
Ebben a példában az ügyfél vásárolt egy Azure-csomagot.
Az Azure-csomagokkal rendelkező ügyfelek esetében az API-válasz a következő módosításokat tartalmazza:
- currencyLocale helyett currencyCode
- usdTotalCost egy új mező
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"budget": {
"amount": 97,
"attributes": {
"objectType": "SpendingBudget"
}
},
"resourceId": "44908a11-641b-4c53-b7fc-0f2bfca8a581",
"resourceName": "Modern Azure Customer UK",
"billingStartDate": "2019-09-01T00:00:00+00:00",
"billingEndDate": "2019-10-01T00:00:00+00:00",
"totalCost": 28.82860766744404945074,
"currencyCode": "GBP",
"usdTotalCost": 35.23000000000000362337,
"lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
"attributes": {
"objectType": "CustomerUsageSummary"
}
}
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: