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 akan 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.
- Masuk ke portal Azure
- Pilih Bantuan+Dukungan
- Klik Buat permintaan dukungan baru
- Dalam Deskripsi masalah, pilih Jenis masalah sebagai Teknis dan tambahkan detailnya.
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 di bawah ini berlaku untuk pembelian 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 ongkos 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 |
| Menerbitkan 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 akan diantrekan untuk dikirim setelah jumlah permintaan berada di bawah ambang batas.
Batas Tarif SMS:
| Operasi | Cakupan | Jangka waktu (detik) | Batas (jumlah permintaan) | Unit pesan per menit |
|---|---|---|---|---|
| Mengirim Pesan | Per Nomor | 60 | 200 | 200 |
Tindakan yang harus diambil
Jika Anda perlu mengirim volume pesan yang melebihi batas tarif, kirim email kepada kami di phone@microsoft.com.
Untuk informasi selengkapnya tentang SMS SDK dan layanan, lihat halaman gambaran umum SMS SDK atau halaman FAQ SMS .
Mengirim pesan dalam volume tinggi memiliki serangkaian batasan jumlah pesan email yang dapat Anda kirim. Jika Anda mencapai batas ini, pesan Anda tidak akan diantrekan untuk dikirim. Anda dapat mengirimkan permintaan ini lagi, setelah waktu Retry-After kedaluwarsa.
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 |
Batas Ukuran
| Nama | Batasan |
|---|---|
| Jumlah penerima dalam Email | 50 |
| Total ukuran permintaan email (termasuk lampiran) | 10 MB |
Tindakan yang harus diambil
Penyiapan kotak pasir ini dirancang untuk membantu pengembang mulai membangun aplikasi. Setelah aplikasi siap untuk produksi, Anda dapat secara bertahap meminta untuk meningkatkan volume pengiriman. Jika Anda perlu mengirim lebih banyak pesan daripada batas tarif yang diizinkan, kirimkan permintaan dukungan untuk menaikkan batas pengiriman email yang Anda inginkan. Tim peninjau akan mempertimbangkan reputasi pengirim Anda secara keseluruhan, yang mencakup faktor-faktor seperti tingkat kegagalan pengiriman email Anda, reputasi domain Anda, dan laporan spam dan penyalahgunaan, saat menentukan status persetujuan.
Obrolan
Batas Ukuran
| Nama | Batasan |
|---|---|
| Jumlah peserta dalam utas | 250 |
| Batch peserta - CreateThread | 200 |
| Batch peserta - AddParticipant | 200 |
| Ukuran halaman - ListMessages | 200 |
Batas Operasi
| Operasi | Di-bucket oleh | Batas per 10 detik | Batas per menit |
|---|---|---|---|
| Membuat utas obrolan | Pengguna | 10 | - |
| Menghapus utas obrolan | Pengguna | 10 | - |
| Memperbarui utas obrolan | Utas obrolan | 5 | - |
| Menambahkan peserta/menghapus peserta | Utas obrolan | 10 | 30 |
| Mendapatkan utas obrolan / Mencantumkan utas obrolan | Pengguna | 50 | - |
| Dapatkan pesan obrolan | Utas pengguna dan obrolan | 50 | - |
| Dapatkan pesan obrolan | Utas obrolan | 250 | - |
| Mencantumkan pesan obrolan | Utas pengguna dan obrolan | 50 | 200 |
| Mencantumkan pesan obrolan | Utas obrolan | 250 | 400 |
| Dapatkan tanda terima baca | Utas pengguna dan obrolan | 5 | - |
| Dapatkan tanda terima baca | Utas obrolan | 250 | - |
| Mencantumkan peserta utas obrolan | Utas pengguna dan obrolan | 10 | - |
| Mencantumkan peserta utas obrolan | Utas obrolan | 250 | - |
| Mengirim pesan / memperbarui pesan / menghapus pesan | Utas obrolan | 10 | 30 |
| Mengirim tanda terima dibaca | Utas pengguna dan obrolan | 10 | 30 |
| Kirim indikator pengetikan | Utas pengguna dan obrolan | 5 | 15 |
| Kirim indikator pengetikan | Utas obrolan | 10 | 30 |
Penyimpanan obrolan
Azure Communication Services menyimpan pesan obrolan tanpa batas waktu sampai dihapus oleh pelanggan.
Mulai dari CY24 Q1, pelanggan harus memilih antara retensi pesan yang tidak terbatas atau penghapusan otomatis setelah 90 hari. Pesan yang ada tetap tidak terpengaruh, tetapi pelanggan dapat memilih periode retensi 90 hari jika diinginkan.
Catatan
Pesan yang dihapus secara tidak sengaja tidak dapat dipulihkan oleh sistem.
Panggilan suara dan video
Batasan Panggilan PSTN
| Nama | Batasan |
|---|---|
| Jumlah panggilan bersamaan keluar | 2 |
Batasan maksimum panggilan
| Nama | Batasan |
|---|---|
| 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 | 9 video + satu berbagi layar | 9 video + satu berbagi layar |
Meskipun SDK Panggilan tidak akan memberlakukan batas ini, pengguna Anda mungkin mengalami penurunan performa jika terlampaui.
Memanggil batas waktu SDK
Batas waktu berikut berlaku untuk SDK Panggilan Azure Communication Services:
| Tindakan | 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.
Interoperabilitas Teams dan Microsoft Graph
Dengan menggunakan skenario interoperabilitas Teams, Anda mungkin 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. Penundaan permintaan menggunakan Retry-After penundaan 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 .
Network Traversal
| Operasi | Jangka waktu (detik) | Batas (jumlah permintaan) |
|---|---|---|
| Terbitkan Kredensial TURN | 5 | 30000 |
| Masalah Konfigurasi Relai | 5 | 30000 |
Tindakan yang harus diambil
Sebaiknya peroleh token sebelum memulai transaksi lain, seperti membuat koneksi relai.
Untuk informasi selengkapnya, lihat halaman gambaran umum konsep traversal jaringan .
Langkah berikutnya
Lihat opsi bantuan dan dukungan .