Memperbarui anggaran pengeluaran penggunaan pelanggan
Berlaku untuk: Pusat Mitra | Pusat Mitra untuk Microsoft Cloud for US Government
Perbarui anggaran pengeluaran yang dialokasikan untuk penggunaan pelanggan.
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, pertama-tama buat objek SpendingBudget baru dengan jumlah yang diperbarui. Kemudian gunakan koleksi IAggregatePartner.Customers dan panggil metode ById() dengan ID pelanggan yang ditentukan. Kemudian akses properti UsageBudget dan teruskan anggaran penggunaan yang diperbarui ke metode Patch() atau PatchAsync().
// 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.Patch(newUsageBudget);
Permintaan REST
Minta sintaks
Metode | Meminta URI |
---|---|
PATCH | {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
PATCH 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"
{
"Amount": 100,
"Attributes": {
"ObjectType": "SpendingBudget"
}
}
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, 10 Nov 2015 19:09:59 GMT
{
{
"amount": 100,
"usageSpendingBudget": 100,
"attributes":{
"objectType":"SpendingBudget"
}
},
"links":{
"self":{
"uri":"/v1/customers/<customer-tenant-id>/usagebudget",
"method":"PATCH",
"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