Azure Communication Services のサービス制限

この記事では、Azure Communication Services API の制限事項と考えられる解決策について説明します。

スロットリングパターンとアーキテクチャ

サービスが制限に達した場合は、ユーザーに HTTP 状態コード 429 (要求が多すぎます) が返されます。 一般に、スロットリングについては次のベスト プラクティスに従ってください。

• 要求あたりの操作の数を減らす。
• 呼び出しの頻度を減らします。
• すべての要求が使用制限に加算されるため、すぐに再試行することは避けてください。

調整と制限を処理するようにサービス アーキテクチャを設定する方法に関するより一般的なガイダンスについては、調整パターンに関する Azure Architecture のドキュメントを参照してください。 調整制限を引き上げるには、Azure サポートに要求します。

1. Azure portal を開き、サインインします。
2. [ヘルプとサポート] を選択します。
3. [新しいサポート リクエストを作成します] を選択します。
4. [問題の説明] テキスト ボックスに「技術」と入力し、[移動] をクリックします。
5. [サービスの選択] ドロップダウン メニューから、[サービスとサブスクリプションの制限 (クォータ)] を選択し、[次へ] を選択します。
6. [問題] の説明で、[問題の種類]、[サブスクリプション]、[クォータの種類] 値を選択し、[次へ] を選択します。
7. 推奨される解決策が表示された場合はその内容を確認し、[次へ] を選択します。
8. 必要に応じて他の詳細を追加し、[次へ] を選択します。
9. [確認と作成] で、入力内容を確認し、必要があれば修正した後、[作成] を選択します。

[Azure サポートに要求する] の手順に従います。

電話番号を取得する

電話番号を取得する前に、サブスクリプションが地理的およびサブスクリプションの要件を満たしていることを確認してください。 そうでない場合、電話番号を購入することはできません。 電話番号 SDK と Azure portal を使用した番号の購入には、以下の制限事項が適用されます。

実行するアクション

詳細については、電話番号の種類とテレフォニーの概念に関するページを参照してください。

番号購入の制限を引き上げるには、Azure サポートに要求します。

1. Azure portal を開き、サインインします。
2. [ヘルプとサポート] を選択します。
3. [新しいサポート リクエストを作成します] を選択します。
4. [問題の説明] テキスト ボックスに「技術」と入力し、[移動] をクリックします。
5. [サービスの選択] ドロップダウン メニューから、[サービスとサブスクリプションの制限 (クォータ)] を選択し、[次へ] を選択します。
6. [問題] の説明で、[問題の種類]、[サブスクリプション]、[クォータの種類] 値を選択し、[次へ] を選択します。
7. 推奨される解決策が表示された場合はその内容を確認し、[次へ] を選択します。
8. 必要に応じて詳細を追加し、[次へ] を選択します。
9. [確認と作成] で、入力内容を確認し、必要があれば修正した後、[作成] を選択します。

アイデンティティ

実行するアクション

チャット スレッドを作成したり、通話を開始したりする前に、ID とトークンを取得することをお勧めします。 たとえば、Web ページの読み込み時やアプリケーションの起動時にこのタスクを実行します。

詳細については、「Azure Communication Services に対する認証」を参照してください。

SMS

大量のメッセージを送信または受信するときに、429 エラーが発生することがあり ます。 このエラーは、まもなくサービスの制限に達することを示しています。 メッセージはキューに入れられ、要求の数がしきい値を下回った後に送信されます。

SMS の転送率の制限:

実行するアクション

レート制限を超える要件がある場合は、より高いスループットを実現するための要求を Azure サポートに送信します。

SMS SDK とサービスの詳細については、SMS SDK の概要または SMS の FAQ に関するページを参照してください。

Email

送信できる電子メール メッセージの数には制限があります。 サブスクリプションに応じたメールのレート制限を超えた場合、要求が拒否されます。 再試行までの時間が経過した後に、これらの要求をもう一度試すことができるようになります。 必要に応じて、送信ボリュームの制限を引き上げるリクエストを行って、制限に達する前に対処してください。

Azure Communication Services のメール サービスは、高スループットをサポートするように設計されています。 ただし、このサービスには、お客様がオンボードを円滑に行い、新しいメール サービスに切り替えるときに発生する可能性のあるいくつかの問題を回避できるように、初期レート制限が設けられています。

メールの配信状態を注意深く監視しながら、2 週間から 4 週間かけて、Azure Communication Services Email を使用するメールの量を少しずつ増やすことをお勧めします。 このように段階的に増やすと、サード パーティのメール サービス プロバイダーはドメインのメール トラフィック用の IP の変更に適応できます。 少しずつ変更すると、送信者評価を保護し、メール配信の信頼性を維持する時間が得られます。

Azure Communication Services のメール サービスでは、1 時間あたり最大 100 万から 200 万メッセージの大量のメッセージがサポートされます。 高スループットは、次のような複数の要因に基づいて有効にすることができます。

• 顧客のピーク時のトラフィック
• ビジネス ニーズ
• 障害率を管理する機能
• ドメインの評価

失敗率の要件

高いメール クォータを有効にするには、メールの失敗率が 1% 未満である必要があります。 失敗率が高い場合は、クォータの引き上げを要求する前に問題を解決する必要があります。 お客様は、失敗率を積極的に監視する必要があります。

クォータの引き上げ後に失敗率が上がった場合、Azure Communication Services はお客様に連絡して、直ちに対処することを求め、解決のタイムラインを確認します。 極端なケースでは、指定されたタイムライン内で失敗率が管理されない場合、Azure Communication Services は、問題が解決されるまでサービスを減らしたり中断したりする可能性があります。

関連記事

Azure Communication Services には、失敗率の監視と管理に役立つ豊富なログと分析が用意されています。 詳細については、次の記事をご覧ください。

• Azure Communication Services 電子メールの送信者の評判を向上させます。
• 電子メールの分析情報。
• Azure Monitor の診断設定を使用してログを有効にします。
• 電子メール イベントを処理します。
• 管理クライアント ライブラリを使用して、Azure Communication Services のドメイン抑制リストを管理します。

メールのレート制限

カスタム ドメイン

次の表に Azure マネージド ドメインの制限を一覧表示します。

メールのサイズ制限

すべてのメッセージ サイズの制限に関して、base64 エンコードによってメッセージのサイズが大きくなることを検討してください。 メッセージの添付ファイルとその他のバイナリ データが Base64 エンコードされた後に発生するメッセージ サイズの増加を考慮して、サイズ値を大きくする必要があります。 Base64 エンコードはメッセージのサイズを約 33% 増加させるため、メッセージ サイズはエンコード前のメッセージ サイズより約 33% 大きくなります。 たとえば、最大メッセージ サイズの値を約 10 MB に指定した場合、実際の最大メッセージ サイズの値は約 7.5 MB になることが予想されます。

リソース制限

10 MB を超える添付ファイルを送信する

最大 30 MB の添付ファイルを電子メールで送信するには、サポート リクエストを行ってください。

30 MB を超える添付ファイルを電子メールで送信する必要がある場合は、この代替ソリューションを使用します。 ファイルを Azure Blob Storage アカウントに格納し、メールにファイルへのリンクを含めます。 Shared Access Signature (SAS) を使用してファイルをセキュリティで保護できます。 SAS を使うと、ストレージ アカウント内のリソースに対してセキュリティ保護された委任アクセスが可能になります。 SAS を使用すると、クライアントがデータにアクセスする方法をきめ細かく制御できます。

Blob Storage アカウントを使用する利点:

• 大規模なファイルを処理できます。
• SAS またはキーを使用して、ファイル アクセスを正確に管理できます。

詳細については、以下を参照してください:

• Azure Blob Storage の概要
• Shared Access Signatures を使用して Azure Storage リソースへの制限付きアクセスを許可する

50 人以上の受信者にメールを送信する

50 人以上の受信者にメールを送信する場合は、 サポートリクエストを行います。 ただし、SMTP 経由で 50 を超える受信者にメールを送信することはサポートされていません。

実行するアクション

メール クォータを増やすには、メール ドメインのクォータの引き上げに関する記事の手順に従ってください。

チャット

Azure Communication Services はチャットをサポートしています。

チャットのサイズ制限

チャットのレート制限

チャットの保存

Azure Communication Services では、チャット スレッドの作成時に設定したアイテム保持ポリシーに従ってチャット メッセージが保存されます。

チャット スレッド作成 API の保持ポリシーを使用して、無期限メッセージ保持と自動削除 (30 日から 90 日) のどちらかを選択できます。 また、チャット スレッドに対してアイテム保持ポリシーを未設定にしておくこともできます。

厳格なコンプライアンス要件に従う必要がある場合は、チャット スレッド削除 API を使用してチャット スレッドを削除することをお勧めします。 新しいアイテム保持ポリシーの適用以前に作成されたスレッドは、そのスレッドに適用するポリシーを変更しない限り影響を受けません。

音声およびビデオによる通話

Azure Communication Services は、音声およびビデオ通話をサポートしています。

PSTN 通話の制限事項

呼び出しの最大制限

Calling SDK ストリーミング サポート

Azuer Communication Services Calling SDK では、次のストリーミング構成がサポートされています。

Calling SDK ではこれらの制限は適用されませんが、これらの制限を超えるとパフォーマンスが低下する可能性があります。

Calling SDK のタイムアウト

Azure Communication Services Calling SDK では、次のタイムアウトが適用されます。

Virtual Rooms

ルーム サービスの調整ポリシーは、リソース ID を使用して要求をグループ化することによって決定されます。

実行するアクション

音声およびビデオの Calling SDK とサービスの詳細については、Calling SDK の概要またはSDK と API の既知の問題に関するページを参照してください。 一部の制限を引き上げる要求を Azure サポートに提出することもできます。 審査チームがすべての要求を審査します。

Job Router

大量の要求を送信または受信するときに、ThrottleLimitExceededException エラーが発生することがあり ます。 このエラーは、まもなくサービスの制限に達することを示しています。 要求の処理に使われるトークン バケットが一定時間後に補充されるまで、要求は失敗します。

Job Router のレート制限

実行するアクション

レート制限を超える量のメッセージを送信する必要がある場合は、acs-ccap@microsoft.com へメールでお問い合わせください。

Teams の相互運用性と Microsoft Graph

Teams 相互運用性シナリオを使用している場合は、おそらく、いくつかの Microsoft Graph API を使用して会議を作成することになります。

Microsoft Graph で提供される各サービスには、それぞれ異なる制限があります。 サービス固有の制限については、この Web ページで詳しく説明しています。

実行するアクション

エラー処理を実装するときに、HTTP エラーコード 429 を使用してスロットリングを検出します。 失敗した応答には、Retry-After 応答ヘッダーが含まれます。 Retry-After 遅延を使用して要求をオフにします。 クライアントが調整されている間も Microsoft Graph がリソースの使用状況を継続的にログに記録するため、調整から回復する最も簡単な方法です。

Microsoft Graph の調整の制限の詳細については、Microsoft Graph のドキュメントを参照してください。

関連記事

• ヘルプとサポートのオプション