Mendapatkan catatan penggunaan untuk semua pelanggan
Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud for US Government
Mitra dapat menggunakan kumpulan sumber daya CustomerMonthlyUsageRecord untuk mendapatkan catatan penggunaan untuk semua pelanggan mereka. Sumber daya ini mewakili catatan penggunaan untuk semua pelanggan. Itu termasuk pelanggan dengan langganan Microsoft Azure (MS-AZR-0145P) atau paket Azure.
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial Aplikasi+Pengguna.
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
).
C#
Untuk mendapatkan semua catatan penggunaan untuk semua pelanggan yang membeli layanan atau sumber daya Azure tertentu selama periode penagihan saat ini:
Gunakan koleksi IAggregatePartner.Customers Anda untuk memanggil metode ById().
Panggil properti UsageRecords, lalu panggil metode Get() atau GetAsync().
// IAggregatePartner partnerOperations; var usageRecords = partnerOperations.Customers.UsageRecords.Get();
Misalnya, lihat sampel berikut:
- Sampel: Aplikasi pengujian konsol
- Proyek: PartnerSDK.FeatureSamples
- Kelas: GetCustomerUsageRecords.cs
Permintaan REST
Minta sintaks
Metode | URI Permintaan |
---|---|
GET | {baseURL}/v1/customers/usagerecords HTTP/1.1 |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tidak ada.
Contoh permintaan
GET https://api.partnercenter.microsoft.com/v1/customers/usagerecords 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 CustomerMonthlyUsageRecord 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
Anda dapat menggunakan properti isUpgraded untuk mengidentifikasi pelanggan yang memiliki paket Azure. Jika nilai untuk isUpgradedbenar, itu berarti pelanggan memiliki paket Azure.
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": 25,
"items": [
{
"budget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"customerSpendingBudget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 0,
"isUpgraded": false,
"resourceId": "11111111-1843-4b3b-872f-206e08a08e51",
"id": "11111111-1843-4b3b-872f-206e08a08e51",
"resourceName": "LEGACY AZURE CUSTOMER SE",
"name": "LEGACY AZURE CUSTOMER SE",
"totalCost": 0,
"currencyLocale": "fr-FR",
"usdTotalCost": 0,
"lastModifiedDate": "2019-08-01T23:00:16.57+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"amount": 20,
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 602.84,
"isUpgraded": true,
"resourceId": "11111111-6fb9-4b05-8f15-b3d72e0596e6",
"id": "11111111-6fb9-4b05-8f15-b3d72e0596e6",
"resourceName": "Modern Azure Customer SE",
"name": "Modern Azure Customer SE",
"totalCost": 120.5682999999995904716,
"currencyCode": "SEK",
"usdTotalCost": 12.39999999999999985235,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 0,
"isUpgraded": true,
"resourceId": "11111111-5892-4326-8541-9da1fdb233fb",
"id": "11111111-5892-4326-8541-9da1fdb233fb",
"resourceName": "Test_Test_MA20190829_14",
"name": "Test_Test_MA20190829_14",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"amount": 97,
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 28.08,
"isUpgraded": true,
"resourceId": "11111111-641b-4c53-b7fc-0f2bfca8a581",
"id": "11111111-641b-4c53-b7fc-0f2bfca8a581",
"resourceName": "Modern Azure Customer UK",
"name": "Modern Azure Customer UK",
"totalCost": 27.23292827625710931604,
"currencyCode": "GBP",
"usdTotalCost": 33.280000000000001044,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/usagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk