すべてのプロダクト
Search
ドキュメントセンター

Server Load Balancer:AScript組み込み変数

最終更新日:May 08, 2025

AScriptは、Application Load Balancer(ALB)コンソールで利用可能な設定よりも複雑な転送ルール構成機能を提供する、使いやすいプログラマブルスクリプト機能です。このトピックでは、AScript組み込み変数と対応する NGINX 変数について説明します。

組み込み変数

次の表に、AScript組み込み変数を示します。

組み込み変数

説明

NGINX 変数

$arg_{name}

name パラメーターの値(query string内)。query string は、HTTP リクエストのリクエストパラメーターを表します。

ngx.var.arg_{name}

説明

{name} フィールドのハイフン(-)はアンダースコア(_)に置き換える必要があります。たとえば、X-USER-ID$arg_x_user_id に変更する必要があります。

$http_{name}

リクエストヘッダーの name フィールドの値。

ngx.var.http_{name}

説明

{name} フィールドのハイフン(-)はアンダースコア(_)に置き換える必要があります。たとえば、X-USER-ID$http_x_user_id に変更する必要があります。

$cookie_{name}

リクエスト Cookie ヘッダーの name フィールドの値。

ngx.var.cookie_{name}

説明

{name} フィールドのハイフン(-)はアンダースコア(_)に置き換える必要があります。たとえば、X-USER-ID$cookie_x_user_id に変更する必要があります。

$scheme

プロトコルタイプ。

ngx.var.scheme

$server_protocol

プロトコルのバージョン。

ngx.var.server_protocol

$host

元のホスト。

ngx.var.host

$uri

元の URI。

ngx.var.raw_uri

$args

$args は、疑問符(?)を除く、HTTP リクエストのすべてのリクエストパラメーターを表します。たとえば、リクエストの URI が http://www.a.com/1k.file?k1=v1&k2=v2 であるとします。

  • $arg_k1 は k1 パラメーターの値 v1 を返します。

  • $args はクエリ文字列全体 k1=v1&k2=v2 を返すために使用されます。疑問符(?)は除外されます。

ngx.var.args

$request_method

リクエストメソッドを示します。

ngx.var.request_method

$request_uri

uri+'?'+args の内容。

ngx.var.request_uri

$remote_addr

リクエストを送信するクライアントの IP アドレス。

ngx.var.remote_addr

説明
  • 変数の前のドル記号($)は、変数が組み込み変数であることを指定するために使用されます。ビジネス要件に基づいてドル記号を削除できます。

  • パラメーターと同じ方法で組み込み変数に値を割り当てないでください。

  • スクリプトには最大 200 個のグローバル変数と無制限の数のローカル変数を指定できます。スクリプトで 200 を超えるグローバル変数を指定するには、カスタム関数を作成し、関数内でグローバル変数をローカル変数として使用します。