Mendapatkan anggaran pengeluaran penggunaan pelanggan
Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud for US Government
Anda dapat memperbarui anggaran pengeluaran (objek SpendingBudget ) dalam ringkasan penggunaan pelanggan (sumber daya CustomerUsageSummary ).
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan 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 memperbarui anggaran pengeluaran penggunaan pelanggan:
Buat objek SpendingBudget baru dengan jumlah yang diperbarui.
Gunakan koleksi IAggregatePartner.Customers untuk memanggil metode ById() dengan pengidentifikasi pelanggan yang ditentukan.
Panggil metode Get atau GetAsync untuk mendapatkan anggaran penggunaan pelanggan.
// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// Create a new spending budget with the udpated amount.
var newUsageBudget = new SpendingBudget()
{
Amount = 100
};
// Update the customer's usage budget.
var usageBudget = partnerOperations.Customers.ById(selectedCustomerId).UsageBudget.Get();
Permintaan REST
Minta sintaks
Metode | URI Permintaan |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/usagebudget HTTP/1.1 |
Parameter URI
Gunakan parameter kueri berikut untuk memperbarui profil penagihan.
Nama | Jenis | Diperlukan | Deskripsi |
---|---|---|---|
customer-tenant-id | guid | Y | Nilainya adalah id penyewa pelanggan berformat GUID yang memungkinkan penjual memfilter hasil untuk pelanggan tertentu yang termasuk dalam reseller. |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Sumber daya lengkap.
Contoh permintaan
GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/usagebudget HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"
Respons REST
Jika berhasil, metode ini mengembalikan anggaran pengeluaran pengguna dengan jumlah yang diperbarui.
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
HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
{
"amount": 100,
"usageSpendingBudget": 100,
"attributes":{
"objectType":"SpendingBudget"
}
},
"links":{
"self":{
"uri":"/v1/customers/<customer-tenant-id>/usagebudget",
"method":"GET",
"headers":[]
}
}
}
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