Ügyfél előfizetés-használati rekordjainak lekérése
A következőre vonatkozik: Partnerközpont | Partnerközpont Microsoft Cloud for US Government
A SubscriptionMonthlyUsageRecord erőforrásgyűjtemény használatával lekérheti egy adott Azure-szolgáltatás vagy -erőforrás ügyfélének előfizetés-használati rekordjait az aktuális számlázási időszakban. Ez az erőforrás az ügyfél összes előfizetését jelöli. Az Azure-csomaggal rendelkező ügyfelek esetében ez az erőforrás ezeknek a csomagoknak a listáját adja vissza (nem az egyes Azure-előfizetéseket).
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak az App+User hitelesítő adatokkal való hitelesítést támogatja.
Ü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#
Ha egy adott Azure-szolgáltatás vagy erőforrás ügyfélének előfizetés-használati rekordjait szeretné lekérni az aktuális számlázási időszakban, hajtsa végre az alábbi lépéseket:
Az IAggregatePartner.Customers gyűjtemény használatával hívja meg a ById() metódust.
Ezután hívja meg az Előfizetések tulajdonságot és a UsageRecords tulajdonságot . Fejezze be a Get() vagy a GetAsync() metódus meghívásával.
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.UsageRecords.Get();
Példaként tekintse meg a következőt:
- Minta: Konzolteszt alkalmazás
- Projekt: PartnerSDK.FeatureSamples
- Osztály: GetSubscriptionUsageRecords.cs
REST-kérelem
Kérés szintaxisa
Metódus | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/usagerecords HTTP/1.1 |
URI-paraméter
Ez a táblázat felsorolja az ügyfél minősített használati adatainak lekéréséhez szükséges lekérdezési paramétert.
Név | Típus | Kötelező | Leírás |
---|---|---|---|
customer-tenant-id | guid | Y | Az ügyfélnek megfelelő GUID. |
Kérésfejlécek
További információ: Partnerközpont REST-fejlécei.
A kérés törzse
Nincsenek.
Példa kérésre
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/usagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
REST-válasz
Ha sikerült, ez a metódus egy SubscriptionMonthlyUsageRecord erőforrást ad vissza a válasz törzsében.
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 a Hibakódok című témakörben találja.
Példa válasz a Microsoft Azure-előfizetésekre (MS-AZR-0145P)
Ebben a példában az ügyfél egy 145P-s Azure PayG-ajánlatot vásárolt.
A Microsoft Azure-előfizetéssel (MS-AZR-0145P) 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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"totalCount": 1,
"items": [
{
"status": "active",
"offerId": "MS-AZR-0145P",
"resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
"id": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
"resourceName": "Microsoft Azure",
"name": "Microsoft Azure",
"totalCost": 22.861172,
"currencyLocale": "fr-FR",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-01T23:04:41.193+00:00",
"attributes": {
"objectType": "SubscriptionMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/<customer-tenant-id>/subscriptions/usagerecords/",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
REST-válasz példa az Azure-csomaghoz
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ő változásokat tartalmazza:
- currencyLocale helyett currencyCode
- usdTotalCost egy új mező
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"totalCount": 2,
"items": [
{
"status": "active",
"partnerOnRecord": "some-id",
"offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
"resourceId": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
"id": "b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2",
"resourceName": "Azure plan",
"name": "Azure plan",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
"attributes": {
"objectType": "SubscriptionMonthlyUsageRecord"
}
},
{
"status": "active",
"partnerOnRecord": "some-id",
"offerId": "DZH318Z0BPS6:0001:DZH318Z0BML6",
"resourceId": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
"id": "c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3",
"resourceName": "Azure plan",
"name": "Azure plan",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-18T17:09:26.16+00:00",
"attributes": {
"objectType": "SubscriptionMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/<customer-tenant-id>/subscriptions/usagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}