Batas layanan untuk Azure Communication Services
Dokumen ini menjelaskan batasan API Azure Communication Services dan kemungkinan resolusi.
Pola dan arsitektur pembatasan
Ketika Anda mencapai batasan layanan, Anda menerima kode status HTTP 429 (Terlalu banyak permintaan). Secara umum, berikut ini adalah praktik terbaik untuk menangani pembatasan:
- Mengurangi jumlah operasi per permintaan.
- Kurangi frekuensi panggilan.
- Hindari percobaan ulang segera karena semua permintaan bertambah berdasarkan batas penggunaan Anda.
Anda dapat menemukan panduan yang lebih umum tentang cara menyiapkan arsitektur layanan Anda untuk menangani pembatasan dan batasan dalam dokumentasi Arsitektur Azure untuk pola pembatasan. Batas pembatasan dapat ditingkatkan melalui permintaan ke Dukungan Azure.
- Buka portal Azure dan masuk.
- Pilih Bantuan+Dukungan.
- Klik Buat permintaan dukungan baru.
- Dalam kotak teks Jelaskan masalah Anda, masukkan
Technicallalu klik Buka. - Dari menu dropdown Pilih layanan, pilih Batas Layanan dan Langganan (Kuota) lalu klik Berikutnya.
- Pada deskripsi Masalah, pilih Jenis masalah, Langganan, dan Jenis kuota lalu klik Berikutnya.
- Tinjau solusi yang Direkomendasikan jika tersedia, lalu klik Berikutnya.
- Tambahkan Detail tambahan sesuai kebutuhan, lalu klik Berikutnya.
- Di Tinjau + buat periksa informasi, buat perubahan sesuai kebutuhan, lalu klik Buat.
Anda dapat mengikuti dokumentasi untuk membuat permintaan ke Dukungan Azure.
Memperoleh nomor telepon
Sebelum memperoleh nomor telepon, pastikan langganan Anda memenuhi persyaratan geografis dan langganan . Jika tidak, Anda tidak dapat membeli nomor telepon. Batasan berikut berlaku untuk membeli nomor melalui SDK Nomor Telepon dan portal Azure.
| Operasi | Cakupan | Jangka waktu | Batas (jumlah permintaan) |
|---|---|---|---|
| Membeli nomor telepon | Penyewa Azure | - | 1 |
| Cari nomor telepon | Penyewa Azure | satu minggu | 5 |
Tindakan yang harus diambil
Untuk informasi selengkapnya, lihat halaman konsep jenis nomor telepon dan halaman gambaran umum konsep telepon.
Jika Anda ingin membeli lebih banyak nomor telepon atau melakukan pemesanan khusus, ikuti petunjuk di sini. Jika Anda ingin mentransfer nomor telepon bebas telunjuk dari akun eksternal ke akun Azure Communication Services mereka, ikuti instruksi di sini.
Identitas
| Operasi | Jangka waktu (detik) | Batas (jumlah permintaan) |
|---|---|---|
| Membuat identitas | 30 | 1000 |
| Menghapus identitas | 30 | 500 |
| Mengeluarkan token akses | 30 | 1000 |
| Mencabut token akses | 30 | 500 |
| createUserAndToken | 30 | 1000 |
| exchangeTokens | 30 | 500 |
Tindakan yang harus diambil
Sebaiknya peroleh identitas dan token sebelum membuat utas obrolan atau memulai panggilan. Misalnya, ketika halaman web dimuat atau aplikasi dimulai.
Untuk informasi selengkapnya, lihat halaman gambaran umum konsep identitas.
SMS
Saat mengirim atau menerima pesan dalam volume tinggi, Anda mungkin menerima 429 kesalahan. Kesalahan ini menunjukkan Anda mencapai batasan layanan, dan pesan Anda diantrekan untuk dikirim setelah jumlah permintaan berada di bawah ambang batas.
Batas Tarif SMS:
| Operasi | Jenis Nomor | Cakupan | Jangka waktu (dtk) | Batas (jml permintaan) | Unit pesan per menit |
|---|---|---|---|---|---|
| Mengirim Pesan | Bebas Pulsa | Per Nomor | 60 | 200 | 200 |
| Mengirim Pesan | Kode Pendek | Per Nomor | 60 | 6000 | 6000 |
| Mengirim Pesan | ID Pengirim Alfanumerik | Per sumber daya | 60 | 600 | 600 |
Tindakan yang harus diambil
Jika Anda memiliki persyaratan yang melebihi batas tarif, kirimkan permintaan ke Dukungan Azure untuk mengaktifkan throughput yang lebih tinggi.
Untuk informasi selengkapnya tentang SMS SDK dan layanan, lihat halaman gambaran umum SMS SDK atau halaman FAQ SMS.
Anda dapat mengirim pesan email dalam jumlah terbatas. Jika Anda melebihi batas berikut untuk langganan Anda, permintaan Anda akan ditolak. Anda dapat mencoba permintaan ini lagi, setelah waktu Coba Lagi-Setelah berlalu. Ambil tindakan sebelum mencapai batas dengan meminta untuk menaikkan batas volume pengiriman Anda jika diperlukan.
Batas Tarif
| Operasi | Cakupan | Jangka waktu (menit) | Batas (jumlah email) |
|---|---|---|---|
| Kirim Email | Per Langganan | 1 | 30 |
| Kirim Email | Per Langganan | 60 | 100 |
| Dapatkan Status Email | Per Langganan | 1 | 60 |
| Dapatkan Status Email | Per Langganan | 60 | 200 |
| Operasi | Cakupan | Jangka waktu (menit) | Batas (jumlah email) |
|---|---|---|---|
| Kirim Email | Per Langganan | 1 | 5 |
| Kirim Email | Per Langganan | 60 | 10 |
| Dapatkan Status Email | Per Langganan | 1 | 10 |
| Dapatkan Status Email | Per Langganan | 60 | 20 |
Batas Ukuran
| Nama | Batas |
|---|---|
| Jumlah penerima dalam Email | 50 |
| Total ukuran permintaan email (termasuk lampiran) | 10 MB |
Mengirim lampiran yang lebih besar dari 10 MB
Untuk mengirim lampiran file melalui email hingga 30 MB, selesaikan permintaan dukungan.
Jika Anda perlu mengirim lampiran file email yang lebih besar dari 30 MB, Anda dapat menggunakan solusi alternatif ini. Simpan file di akun Azure Blob Storage dan sertakan tautan ke file di email Anda. Anda dapat mengamankan file dengan Tanda Tangan Akses Bersama (SAS). SAS menyediakan akses yang didelegasikan dengan aman ke sumber daya di akun penyimpanan Anda. Dengan menggunakan SAS, Anda memiliki kontrol terperinci atas bagaimana klien dapat mengakses data Anda.
Manfaat menggunakan akun Azure Blob Storage:
- Anda dapat menangani file skala besar.
- Anda dapat menggunakan kunci SAS untuk mengelola akses file dengan tepat.
Untuk informasi selengkapnya, lihat:
- Pengantar Azure Blob Storage
- Berikan akses terbatas ke sumber daya Azure Storage menggunakan tanda tangan akses bersama (SAS)
Tindakan yang harus diambil
Untuk menambah kuota email Anda, ikuti instruksi di Penambahan kuota untuk domain email.
Catatan
Permintaan penambahan kuota email mungkin memakan waktu hingga 72 jam untuk dievaluasi dan disetujui, terutama untuk permintaan yang masuk pada jumat sore.
Obrolan
Batas Ukuran
| Nama | Batas |
|---|---|
| Jumlah peserta dalam utas | 250 |
| Batch peserta - CreateThread | 200 |
| Batch peserta - AddParticipant | 200 |
| Ukuran halaman - ListMessages | 200 |
| Ukuran Pesan | 28 KB |
| Jumlah sumber daya Azure Communication Services per Azure Bot | 1000 |
Batas Tarif
| Operasi | Cakupan | Batas per 10 detik | Batas per menit |
|---|---|---|---|
| Membuat utas obrolan | per Pengguna | 10 | - |
| Menghapus utas obrolan | per Pengguna | 10 | - |
| Memperbarui utas obrolan | per utas Obrolan | 5 | - |
| Menambahkan peserta/menghapus peserta | per utas Obrolan | 10 | 30 |
| Mendapatkan utas obrolan / Mencantumkan utas obrolan | per Pengguna | 50 | - |
| Mendapatkan pesan obrolan | per Pengguna per utas obrolan | 50 | - |
| Mendapatkan pesan obrolan | per utas Obrolan | 250 | - |
| Mencantumkan pesan obrolan | per Pengguna per utas obrolan | 50 | 200 |
| Mencantumkan pesan obrolan | per utas Obrolan | 250 | 400 |
| Dapatkan tanda terima baca (batas 20 peserta*) | per Pengguna per utas obrolan | 5 | - |
| Dapatkan tanda terima baca (batas 20 peserta*) | per utas Obrolan | 100 | - |
| Mencantumkan peserta utas obrolan | per Pengguna per utas obrolan | 10 | - |
| Mencantumkan peserta utas obrolan | per utas Obrolan | 250 | - |
| Mengirim pesan / memperbarui pesan / menghapus pesan | per utas Obrolan | 10 | 30 |
| Mengirim tanda terima dibaca | per Pengguna per utas obrolan | 10 | 30 |
| Kirim indikator pengetikan | per Pengguna per utas obrolan | 5 | 15 |
| Kirim indikator pengetikan | per utas Obrolan | 10 | 30 |
Catatan
* Tanda terima baca dan indikator pengetikan tidak didukung pada utas obrolan dengan lebih dari 20 peserta.
Penyimpanan obrolan
Azure Communication Services menyimpan pesan obrolan sesuai dengan kebijakan penyimpanan yang Anda tetapkan saat membuat utas obrolan.
Penting
Fungsionalitas yang dijelaskan dalam artikel ini saat ini dalam pratinjau publik. Versi pratinjau ini disediakan tanpa perjanjian tingkat layanan, dan tidak disarankan untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.
Anda dapat memilih antara retensi pesan yang tidak terbatas atau penghapusan otomatis antara 30 dan 90 hari melalui kebijakan penyimpanan pada Api Buat Utas Obrolan. Atau, Anda dapat memilih untuk tidak menetapkan kebijakan retensi pada utas obrolan.
Jika Anda memiliki kebutuhan kepatuhan yang ketat, kami sarankan Anda menghapus utas obrolan menggunakan Utas Obrolan Penghapusan API. Setiap utas yang dibuat sebelum kebijakan retensi baru tidak terpengaruh kecuali Anda secara khusus mengubah kebijakan untuk utas tersebut.
Catatan
Jika Anda tidak sengaja menghapus pesan, pesan tersebut tidak dapat dipulihkan oleh sistem. Selain itu, jika Anda mengirimkan permintaan dukungan untuk utas obrolan yang dihapus setelah kebijakan retensi menghapus utas tersebut, utas tersebut tidak dapat lagi diambil dan tidak ada informasi tentang utas tersebut yang tersedia. Jika diperlukan, buka tiket dukungan secepat mungkin dalam jendela 30 hari setelah Anda membuat utas sehingga kami dapat membantu Anda.
Panggilan suara dan video
Batasan Panggilan PSTN
| Nama | Cakupan | Batas |
|---|---|---|
| Jumlah default panggilan bersamaan* keluar | per Angka | 2 |
Catatan
* Tidak ada batasan panggilan bersamaan masuk. Anda juga dapat mengirimkan permintaan ke Dukungan Azure untuk meningkatkan batas panggilan bersamaan keluar, yang ditinjau oleh tim pemeriksaan kami.
Batasan maksimum panggilan
| Nama | Batas |
|---|---|
| Jumlah peserta | 350 |
Memanggil dukungan streaming SDK
SDK Panggilan Azure Communication Services mendukung konfigurasi streaming berikut:
| Batas | Web | Windows/Android/iOS |
|---|---|---|
| Maksimum # aliran lokal keluar yang dapat Anda kirim secara bersamaan | satu video atau satu berbagi layar | satu video + satu berbagi layar |
| Maksimum # aliran jarak jauh masuk yang dapat Anda render secara bersamaan | sembilan video + satu berbagi layar | sembilan video + satu berbagi layar |
SDK Panggilan tidak memberlakukan batas ini, tetapi pengguna Anda mungkin mengalami penurunan performa jika Anda melebihi batas ini.
Memanggil batas waktu SDK
Batas waktu berikut berlaku untuk SDK Panggilan Azure Communication Services:
| Perbuatan | Waktu habis dalam detik |
|---|---|
| Menyambungkan kembali/menghilangkan peserta | 120 |
| Menambahkan atau menghapus modalitas baru dari panggilan (Mulai/hentikan berbagi video atau layar) | 40 |
| Batas waktu operasi Transfer Panggilan habis | 60 |
| 1:1 waktu pendirian panggilan habis | 85 |
| Batas waktu pembentukan panggilan grup | 85 |
| Batas waktu pembentukan panggilan PSTN | 115 |
| Mempromosikan panggilan 1:1 ke batas waktu panggilan grup | 115 |
Tindakan yang harus diambil
Untuk informasi selengkapnya tentang SDK dan layanan panggilan suara dan video, lihat halaman gambaran umum SDK panggilan atau masalah yang diketahui. Anda juga dapat mengirimkan permintaan ke Dukungan Azure untuk meningkatkan beberapa batasan, peninjauan tertunda oleh tim pemeriksaan kami.
Router Pekerjaan
Saat mengirim atau menerima permintaan dalam volume tinggi, Anda mungkin menerima ThrottleLimitExceededException kesalahan. Kesalahan ini menunjukkan Anda mencapai batasan layanan, dan permintaan Anda gagal hingga token wadah untuk menangani permintaan diisi ulang setelah waktu tertentu.
Batas Tarif untuk Job Router:
| Operasi | Cakupan | Jangka waktu (detik) | Batas (jumlah permintaan) | Waktu habis dalam detik |
|---|---|---|---|---|
| Permintaan Umum | Per Sumber Daya | 10 | 1000 | 10 |
Tindakan yang harus diambil
Jika Anda perlu mengirim volume pesan yang melebihi batas tarif, kirim email kepada kami di acs-ccap@microsoft.com.
Interoperabilitas Teams dan Microsoft Graph
Dengan menggunakan skenario interoperabilitas Teams, Anda kemungkinan akan menggunakan beberapa API Microsoft Graph untuk membuat rapat.
Setiap layanan yang ditawarkan melalui Microsoft Graph memiliki batasan yang berbeda; batas khusus layanan dijelaskan di sini secara lebih rinci.
Tindakan yang harus diambil
Ketika Anda menerapkan penanganan kesalahan, gunakan kode galat HTTP 429 untuk mendeteksi pembatasan. Respons yang gagal mencakup Retry-After header respons. Mundur dari permintaan menggunakan penundaan Retry-After adalah cara tercepat untuk pulih dari pembatasan karena Microsoft Graph terus mencatat penggunaan sumber daya saat klien sedang dibatasi.
Anda dapat menemukan informasi selengkapnya tentang batas pembatasan Microsoft Graph dalam dokumentasi Microsoft Graph.
Langkah berikutnya
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk