Perbarui kelebihan

Berlaku untuk

• Pusat Mitra

Peran yang sesuai

• Admin global
• Agen admin

Catatan

Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru.

Digunakan untuk mengatur kelebihan untuk pelanggan tertentu ke langganan konsumsi. Juga dapat digunakan untuk menghapus kelebihan dengan mengaturnya ke false. Kelebihan penggunaan memungkinkan pelanggan untuk terus menggunakan layanan jika mereka menggunakan layanan di luar batas yang dinyatakan. Kelebihan penggunaan mendefinisikan kelebihan konsumsi langganan bayar sesuai pemakaian akan bertambah.

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).

• Setidaknya satu langganan kelebihan penggunaan yang memenuhi syarat yang dibeli untuk pelanggan.

Permintaan REST

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

Minta sintaks

Metode	URI Permintaan
TARUH	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk mengembalikan kelebihan pelanggan.

Nama	Tipe	Wajib	Deskripsi
customer-tenant-id	Guid	Y	GUID yang sesuai dengan penyewa pelanggan.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Nama	Tipe	Deskripsi
azureEntitlementId	Guid	GUID yang menentukan langganan konsumsi untuk kelebihan penggunaan.
partnerId	Guid	PartnerID dari Reseller Tidak Langsung. Hanya berlaku untuk model dua tingkat (Penyedia Tidak Langsung).
overageEnabled	bool	Menunjukkan apakah kelebihan pemakaian harus diaktifkan untuk langganan konsumsi tertentu.

Contoh permintaan

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

Respons REST

Jika berhasil, metode ini mengembalikan kelebihan penggunaan untuk pelanggan.

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 tanggapan

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}