Mendapatkan ringkasan penggunaan untuk semua langganan pelanggan
Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Anda dapat menggunakan sumber daya CustomerUsageSummary untuk mendapatkan penggunaan layanan atau sumber daya Azure tertentu selama periode penagihan saat ini.
Catatan
Umumnya, data penggunaan harian yang tidak ditagih tersedia melalui API atau portal Pusat Mitra setelah 24 jam. Bergantung pada lokasi Anda dan kapan meter melaporkan penggunaan, penundaan tambahan mungkin terjadi.
Terkadang, Anda mungkin tidak melihat data penggunaan terbaru yang tidak ditagih dari awal bulan hingga data penggunaan yang ditagih bulan sebelumnya dikirimkan. Ini untuk memastikan data penggunaan yang ditagih dikirimkan secara efisien dalam SLA. Setelah menerima data penggunaan yang ditagih, Anda dapat mulai mengambil semua data penggunaan yang tidak diperbarui dari awal bulan.
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
).
C#
Untuk mendapatkan ringkasan penggunaan untuk semua langganan pelanggan:
Gunakan koleksi IAggregatePartner.Customers Anda untuk memanggil metode ById().
Panggil properti UsageSummary, diikuti dengan metode Get() atau GetAsync():
// IAggregatePartner partnerOperations; // var selectedCustomerId as string; var usageSummary = partnerOperations.Customers.ById(selectedCustomerId).UsageSummary.Get();
Misalnya, lihat yang berikut ini:
- Sampel: Aplikasi pengujian konsol
- Proyek: PartnerSDK.FeatureSamples
- Kelas: GetCustomerUsageSummary.cs
Permintaan REST
Minta sintaks
Metode | URI Permintaan |
---|---|
DAPATKAN | {baseURL}/v1/customers/{customer-tenant-id}/usagesummary HTTP/1.1 |
Parameter URI
Tabel ini mencantumkan parameter kueri yang diperlukan untuk mendapatkan informasi penggunaan yang dinilai pelanggan.
Nama | Jenis | Wajib | Deskripsi |
---|---|---|---|
customer-tenant-id | Guid | Y | GUID yang sesuai dengan pelanggan. |
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}/usagesummary 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 CustomerUsageSummary dalam isi respons.
Kode kesalahan dan keberhasilan respons
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 penawaran Azure PayG 145P.
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
{
"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"
}
}
Contoh respons untuk paket Azure
Dalam contoh ini, pelanggan membeli paket Azure.
Untuk pelanggan dengan paket Azure, ada perubahan berikut pada 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: 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"
}
}
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