Előfizetés használati adatainak lekérése mérő szerint

2024-10-07

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

A MeterUsageRecord erőforrásgyűjtemény használatával lekérheti egy ügyfél mérőszám-használati rekordjait az adott Azure-szolgáltatásokhoz vagy -erőforrásokhoz az aktuális számlázási időszakban. Ez az erőforrásgyűjtemény a teljes Azure-csomagra vonatkozóan az aktuális számlázási ciklus egyes mérőinek összesített összegét jelöli.

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).
Előfizetés-azonosító

Ez az új útvonal egyenértékű subscriptions/{subscription-id}/usagerecords/resourcesa-vel, amely továbbra is csak a Microsoft Azure-előfizetések (MS-AZR-0145P) esetében fog működni. Ez az új útvonal a Microsoft Azure-előfizetéseket (MS-AZR-0145P) és az Azure-csomagokat is támogatja. Ahhoz, hogy megkapja ezeket az információkat az Azure-csomaghoz, át kell váltania erre az új útvonalra. A következő szakaszokban említett tulajdonságokon kívül a válasz ugyanaz, mint a régi útvonal.

C#

Egy adott Azure-szolgáltatáshoz vagy -erőforráshoz tartozó ügyfél fogyasztásmérő-használati rekordjainak lekérése az aktuális számlázási időszakban:

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

Hívja meg az Előfizetések tulajdonságot és a UsageRecords tulajdonságot, majd a Meters tulajdonságot . Fejezze be a Get() vagy a GetAsync() metódus meghívásával.

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// var selectedSubscriptionId as string;

var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Meters.Get();

Példaként tekintse meg a következő mintát:

Minta: Konzolteszt alkalmazás
Projekt: PartnerSDK.FeatureSamples
Osztály: GetSubscriptionUsageRecordsByMeter.cs

REST-kérelem

Kérés szintaxisa

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

URI-paraméterek

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étereket.

Név	Típus	Kötelező	Leírás
customer-tenant-id	guid	Y	Az ügyfélnek megfelelő GUID.
subscription-id	guid	Y	Egy Partnerközpont-előfizetési erőforrás azonosítójának megfelelő GUID, amely egy Microsoft Azure-előfizetést (MS-AZR-0145P) vagy Egy Azure-csomagot jelöl. Az Azure-csomag előfizetési erőforrásaihoz adja meg a csomagazonosítótelőfizetés-azonosítóként* ebben az útvonalban.*

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/{subscription-id}/meterusagerecords 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 PagedResourceCollection<MeterUsageRecord 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 145P Azure PayG-t vásárolt.

Microsoft Azure-előfizetéssel (MS-AZR-0145P) rendelkező ügyfelek esetén 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: Fri, 26 Feb 2016 20:31:45 GMT

{
    "totalCount": 4,
    "items": [
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNVX-005J-Data Transfer In (GB)",
            "meterName": "Data Transfer In",
            "category": "Bandwidth",
            "subcategory": "Bandwidth",
            "quantityUsed": 0.01129,
            "unit": "1 GB",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNVX-005J-Data Transfer Out (GB)",
            "meterName": "Data Transfer Out",
            "category": "Bandwidth",
            "subcategory": "Bandwidth",
            "quantityUsed": 0.000224,
            "unit": "1 GB",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNZ5-006G-10K Batch Write Operations",
            "meterName": "Batch Write Operations",
            "category": "Storage",
            "subcategory": "Tables",
            "quantityUsed": 0.2462,
            "unit": "10K",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        },
        {
            "subscriptionId": "{subscription-id}",
            "meterId": "DZH318Z0BNZ5-006G-Data Stored (GB/Month)",
            "meterName": "LRS Data Stored",
            "category": "Storage",
            "subcategory": "Tables",
            "quantityUsed": 0.002632,
            "unit": "1 GB/Month",
            "totalCost": 0,
            "currencyCode": "GBP",
            "usdTotalCost": 0,
            "lastModifiedDate": "2019-09-17T21:08:44.2566667+00:00",
            "attributes": {
                "objectType": "MeterUsageRecord"
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/<customer-tenant-id>/subscriptions/<subscription-id>/meterusagerecords",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}