Memperbarui anggaran pengeluaran penggunaan pelanggan

Artikel
01/29/2024

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

Bagikan melalui