Edge Security Acceleration:ウェイティングルームを作成して開始する

パラメーター

説明

ウェイティングルーム名

ウェイティングルームに、promo_activity_room のように識別しやすい名前を設定します。

ホスト名とパス

ウェイティングルームがアクティブになる正確な URL を定義します。サイトには複数のホスト名 (ドメイン名) を設定できます。このルールは、指定した [ホスト名] と [パス] にのみ適用されます。

例：ホスト名が event.example.com で、パスが /route の場合、ウェイティングルームは event.example.com/route へのリクエストにのみ適用されます。

カスタム Cookie

ユーザーのキューステータスを識別し、追跡するために使用される認証情報です。Cookie 名には、__aliwaitingroom_ という固定のプレフィックスが付きます。サフィックスはカスタマイズできます。

例：__aliwaitingroom_promo_user。

パラメーター

説明

アクティブユーザーの総数

目的：オリジンサーバーに同時にアクセスできる同時接続ユーザー数の最大値を設定します。

説明：この値は、オリジンサーバーの実際の同時処理能力に基づいて設定します。オリジンにアクセスしているアクティブなユーザー数がこのしきい値に達すると、新しいユーザーリクエストはキューに送られます。

注意：最小値は 200 です。オリジンの実際の負荷が 200 未満の場合は、この値を 200 に設定し、1 分あたりの新規ユーザー数 パラメーターを使用して、受け入れレートをより正確に制御します。

1 分あたりの新規ユーザー数

目的：キューからオリジンサーバーへ毎分受け入れられる新規ユーザーの最大数を設定します。これにより、オリジンへの負荷の増加率を制御します。

説明：このパラメーターは、キューが処理される速さを決定します。たとえば、300 に設定した場合、毎分最大 300 人の新規ユーザーが待機ページからオリジンサーバーに移動できます。

注意：最小値は 200 です。この値は、アクティブユーザーの総数 以下である必要があります。

セッション持続時間

目的：ユーザーがキューを離れた後のセッションの有効期間を定義します。

説明：ユーザーがオリジンサーバーへのアクセスに成功した後、このパラメーターで設定された時間内に一時的に離脱 (ページのクローズなど) して戻ってきた場合、再度キューに並ぶ必要はありません。デフォルト値は 5 分です。

セッション更新の無効化

目的：オリジンサーバーとの対話中に、ユーザーのセッション有効期間が自動的に更新されるかどうかを決定します。

注意：このトグルの名前は、その動作とは逆の意味になります。望ましい結果に基づいてオプションを選択してください：

• オフ (デフォルト)：セッション更新を有効にします。ユーザーがオリジンサーバー上でアクティブである限り (継続的にリクエストを送信している限り)、セッションは有効期限切れにならず、キューに戻されることはありません。これはほとんどのシナリオに適しています。

• オン：セッション更新を無効にします。ユーザーのセッションは、オリジンサーバーに最初に入った瞬間から厳密に計時されます。時間が経過すると、ユーザーがまだアクティブに閲覧していても、再度キューに並ぶ必要があります。これは、タイムセールなど、ユーザーの単一訪問時間を厳密に制御する必要があるシナリオに適しています。

キューイング方式

目的：待機ページからユーザーを受け入れるためのポリシーを選択します。

• FIFO：リクエストが受信された順にユーザーを受け入れます。これは最も公平なメソッドであり、推奨されるデフォルトです。

• ランダム：キューからランダムにユーザーを選択してアクセスを許可します。これは、公平性が主要な関心事ではない抽選などのシナリオに適用できます。

• すべて拒否：すべての新規ユーザーは待機ページに送られ、受け入れられません。これは、イベント前のウォームアップ、システムメンテナンス、またはアクセスを閉鎖する必要がある緊急事態に役立ちます。

• パススルー：すべてのリクエストはキューをバイパスして、直接オリジンサーバーに送られます。このモードでは、ウェイティングルームは事実上無効になります。これは、イベント後に通常のアクセスを復元したり、機能テストに使用したりできます。

パラメーター

説明

タイプ

デフォルトウェイティングルーム：システムが提供する標準の待機ページです。推定待ち時間を自動的に表示します。[デフォルトの言語テンプレート] (英語、中国語 (簡体字)、または 中国語 (繁体字)) を選択できます。

カスタムウェイティングルーム：カスタム HTML ページをアップロードできます。この機能を使用するには、営業担当者にお問い合わせください。

• テンプレートを編集するか、直接 .html ファイル (最大 50 KB) をインポートできます。

• HTML 内で動的変数 (例：${waitTime}) を使用して、キュー情報を表示できます。

キューのプレビュー

リンクをクリックして、キューイングしている や すべてキューイング などのさまざまな状態で待機ページがどのように表示されるかをプレビューします。

JSON レスポンス

目的：アプリやミニアプリなど、ブラウザ以外のクライアントに構造化されたキューステータス情報を提供します。

このトグルを有効にします。クライアントのリクエストヘッダーに Accept: application/json が含まれている場合、ESA は HTML の待機ページの代わりに JSON 形式でキュー情報を返します。パラメーターの詳細については、「JSON レスポンスパラメーターの説明」をご参照ください。

対話フロー：

1. 最初のリクエスト：クライアントは Accept: application/json リクエストヘッダーを付けてターゲット URL にアクセスします。

2. Cookie の取得と保存：ESA のレスポンスヘッダーには Set-Cookie フィールドが含まれます。クライアントは、後続のリクエストの ID 認証情報として使用するために、この Cookie を保存する必要があります。

3. ステータスのポーリング：クライアントはリクエストにこの Cookie を含める必要があります。レスポンス本文の refreshIntervalSeconds フィールドで指定された間隔で定期的に同じ URL を再リクエストし、キューステータスを更新する必要があります。

4. オリジンへのアクセス：レスポンス本文の inWaitingRoom フィールドが false に変わると、クライアントはキューを離れます。その後、クライアントは Cookie を使用して通常どおりオリジンリソースにアクセスできます。

レスポンス例：

{
  "WaitingRoom": {
    "inWaitingRoom": true,
    "waitTime": 5,
    "waitTimeKnown": true,
    "waitTimeFormatted": "5 minutes",
    "queueIsFull": false,
    "queueAll": false,
    "lastUpdated": "2024-09-10T12:00:00.000Z",
    "refreshIntervalSeconds": 20
  }
}

キューステータスコード

キューにいる間にユーザーが受け取る HTTP レスポンスステータスコードをカスタマイズします。デフォルトは 200 です。必要に応じて、202 などの別のステータスコードに変更できます。