Mendapatkan data penggunaan untuk langganan menurut meter

Artikel
01/29/2024

Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud for US Government

Anda dapat menggunakan kumpulan sumber daya MeterUsageRecord untuk mendapatkan rekaman penggunaan meteran pelanggan untuk layanan atau sumber daya Azure tertentu selama periode penagihan saat ini. Kumpulan sumber daya ini mewakili total agregat untuk setiap meter untuk siklus penagihan saat ini, di seluruh paket Azure Anda.

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial App+User.
ID pelanggan (customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan , lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan . ID Microsoft sama dengan ID pelanggan (customer-tenant-id).
ID langganan

Rute baru ini setara subscriptions/{subscription-id}/usagerecords/resourcesdengan , yang akan terus berfungsi hanya untuk langganan Microsoft Azure (MS-AZR-0145P). Rute baru ini akan mendukung langganan Microsoft Azure (MS-AZR-0145P) dan paket Azure. Untuk mendapatkan informasi ini untuk paket Azure, Anda perlu beralih ke rute baru ini. Selain properti yang disebutkan di bagian berikut, responsnya sama dengan rute lama.

C#

Untuk mendapatkan catatan penggunaan meteran pelanggan untuk layanan atau sumber daya Azure tertentu selama periode penagihan saat ini:

Gunakan koleksi IAggregatePartner.Customers Anda untuk memanggil metode ById().

Panggil properti Langganan, dan UsageRecords, lalu properti Meter. Selesaikan dengan memanggil metode Get() atau GetAsync().

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

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

Misalnya, lihat sampel berikut:

Sampel: Aplikasi pengujian konsol
Proyek: PartnerSDK.FeatureSamples
Kelas: GetSubscriptionUsageRecordsByMeter.cs

Permintaan REST

Minta sintaks

Metode	URI Permintaan
GET	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/meterusagerecords HTTP/1.1

Parameter URI

Tabel ini mencantumkan parameter kueri yang diperlukan untuk mendapatkan informasi penggunaan berperingkat pelanggan.

Nama	Jenis	Diperlukan	Deskripsi
customer-tenant-id	guid	Y	GUID yang sesuai dengan pelanggan.
subscription-id	guid	Y	GUID yang sesuai dengan pengidentifikasi sumber daya langganan Pusat Mitra, yang mewakili langganan Microsoft Azure (MS-AZR-0145P) atau paket Azure. Untuk sumber daya langganan paket Azure, berikan id paket* sebagai id langganan dalam rute ini.*

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

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: 47c36033-af5d-4457-80a4-512c1626fac4

Respons REST

Jika berhasil, metode ini mengembalikan sumber daya PagedResourceCollection<MeterUsageRecord> dalam isi respons.

Respons keberhasilan dan kode kesalahan

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat Kode Kesalahan.

Contoh respons untuk langganan Microsoft Azure (MS-AZR-0145P)

Dalam contoh ini, pelanggan membeli 145P Azure PayG.

Untuk pelanggan dengan langganan Microsoft Azure (MS-AZR-0145P), tidak akan ada perubahan pada respons API.

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

{
    "totalCount": 1,
    "items": [
        {
            "status": "active",
            "offerId": "MS-AZR-0145P",
            "resourceId": "11111111-F347-41B6-B02C-187B1B778A43",
            "id": "11111111-F347-41B6-B02C-187B1B778A43",
            "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"
    }
}

Contoh respons REST untuk paket Azure

Dalam contoh ini, pelanggan membeli paket Azure.

Untuk pelanggan dengan paket Azure, ada perubahan berikut dalam respons API:

currencyLocale diganti dengan currencyCode
usdTotalCost adalah bidang baru

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

Bagikan melalui