Perbarui pemakaian data berlebih

Berlaku untuk

• Pusat Mitra

Peran yang sesuai

• 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 ikhtisar pengalaman perdagangan baru.

Digunakan untuk mengatur kelebihan bagi pelanggan tertentu untuk langganan berbasis 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 yang akan dikenakan biaya tambahan sesuai pemakaian.

Grup sumber daya selalu M365. Mitra dapat menambahkan tag dan lokasi ke grup sumber daya tetapi tidak dapat mengubahnya.

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 bisa mencarinya di Pusat Mitra dengan memilih Ruang Kerja Pelanggan, kemudian pilih pelanggan dari daftar, lalu pilih 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 tambahan yang memenuhi syarat dibeli untuk pelanggan.

Permintaan REST

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

Sintaks permintaan

Metode	URI Permintaan
PUT	{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	Panduan	Y	GUID yang sesuai dengan tenant pelanggan.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Partner Center.

Isi permintaan

Nama	Tipe	Deskripsi
azureEntitlementId	Panduan	Required. GUID yang menentukan langganan konsumsi untuk kelebihan penggunaan.
azureResourceGroup	object	Optional. Nilai nama tag dan lokasi grup sumber daya.
partnerId	Panduan	Hanya berlaku untuk model dua tingkat (Penyedia Tidak Langsung). PartnerID dari Reseller Tidak Langsung.
overageEnabled	bool	Required. 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: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "overageEnabled": true
}

Respons REST

Jika berhasil, metode ini mengembalikan kelebihan kepada 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: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}