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

:CreateRules

最終更新日:Oct 10, 2025

転送ルールをバッチで作成します。

操作説明

この操作を呼び出して転送ルールを作成する際は、次の点にご注意ください:

  • Redirect 操作を設定する場合、HttpCode パラメーターを除くすべてのパラメーターの値を指定する必要があります。

  • 転送ルールに複数の操作を設定する場合、Rewrite 操作は ForwardGroup 操作タイプで設定する必要があります。

  • CreateRules は非同期操作です。リクエストが送信されると、システムはリクエスト ID を返し、バックグラウンドで転送ルールを作成します。ListRules 操作を呼び出して、転送ルールの作成ステータスをクエリできます:
    • 転送ルールが Provisioning ステータスの場合、作成中です。

    • 転送ルールが Available ステータスの場合、作成済みです。

  • 転送ルールは、次の最大数の条件 (RuleConditions) と操作 (RuleActions) をサポートします:
    • 条件: Basic Edition は 5 個、Standard Edition は 10 個、WAF 有効エディションは 10 個。

    • 操作: Basic Edition は 3 個、Standard Edition は 5 個、WAF 有効エディションは 5 個。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

alb:CreateRules

create

*LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

*ServerGroup

acs:alb:{#regionId}:{#accountId}:servergroup/{#servergroupId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ListenerId

string

必須

Application Load Balancer (ALB) リスナーの ID。

lsn-l16uo9y******

ClientToken

string

任意

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアントから値を生成して、異なるリクエスト間で値が一意になるようにします。トークンには ASCII 文字のみを含めることができます。

説明

このパラメーターを指定しない場合、システムはリクエストの RequestIdClientToken として自動的に使用します。各リクエストの RequestId は一意です。

5A2CFF0E-5718-45B5-9D4D-70B3FF3898

DryRun

boolean

任意

ドライランを実行するかどうかを指定します。有効値:

  • true: ドライランを実行します。システムは、必須パラメーター、リクエストフォーマット、およびサービス制限を確認します。リクエストがドライランに失敗した場合、エラーメッセージが返されます。リクエストがドライランに合格した場合、DryRunOperation エラーコードが返されます。

  • false (デフォルト): 通常のリクエストを送信します。リクエストがチェックに合格すると、2xx HTTP ステータスコードが返され、転送ルールが作成されます。

false

Rules

array<object>

必須

転送ルール。

array<object>

必須

転送ルール。

Priority

integer

必須

転送ルールの優先度。

1

RuleActions

array

必須

転送ルールの操作。

array<object>

必須

転送ルールの操作。

FixedResponseConfig

object

任意

固定レスポンスを返す操作の設定。

Content

string

任意

固定レスポンス。レスポンスのサイズは最大 1 KB で、ASCII 文字のみを含めることができます。

test

ContentType

string

任意

固定レスポンスのフォーマット。

有効値: text/plaintext/csstext/htmlapplication/javascript、および application/json

text/plain

HttpCode

string

任意

レスポンスの HTTP ステータスコード。有効値は 2xx4xx5xx です。x は数字です。

200

ForwardGroupConfig

object

任意

リクエストを vServer グループに転送する操作の設定。

ServerGroupTuples

array

任意

宛先 vServer グループ。

object

任意

宛先 vServer グループ。

ServerGroupId

string

任意

vServer グループ ID。

sgp-ffm94ovy7lqw******

Weight

integer

任意

重み。値が大きいほど、重みが高くなります。重みが大きい vServer グループには、より多くのリクエストが転送されます。有効値: 0100

  • 宛先 vServer グループを 1 つだけ指定した場合、このパラメーターのデフォルト値は 100 です。

  • 複数の宛先 vServer グループを指定する場合は、各 vServer グループの重みを指定する必要があります。

100

ServerGroupStickySession

object

任意

vServer グループのセッション維持。

Enabled

boolean

任意

セッション維持を有効にするかどうかを指定します。有効値:

  • true: セッション維持を有効にします。

  • false (デフォルト): セッション維持を無効にします。

false

Timeout

integer

任意

タイムアウト期間。単位: 秒。有効値: 186400。デフォルト値: 1000

30

InsertHeaderConfig

object

任意

ヘッダーを挿入する操作の設定。

Key

string

任意

挿入するヘッダーのキー。キーの長さは 1~40 文字で、文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。InsertHeaderConfig のヘッダーキーは同じにできません。

説明

次のヘッダーキーはサポートされていません (大文字と小文字は区別されません): slb-idslb-ipx-forwarded-forx-forwarded-protox-forwarded-eipx-forwarded-portx-forwarded-client-srcportconnectionupgradecontent-lengthtransfer-encodingkeep-alivetehostcookieremoteipauthority、および x-forwarded-host

key

Value

string

任意

挿入するヘッダーの値。

  • ValueTypeSystemDefined に設定されている場合、次のいずれかの値を指定できます:
    • ClientSrcPort: クライアントポート。

    • ClientSrcIp: クライアント IP アドレス。

    • Protocol: クライアントリクエストのプロトコル (HTTP または HTTPS)。

    • SLBId: ALB インスタンスの ID。

    • SLBPort: ALB インスタンスのリスニングポート。

  • ValueTypeUserDefined に設定されている場合、カスタムヘッダー値を指定できます。値は 1~128 文字の長さで、アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。また、ASCII 値が ch >= 32 && ch < 127 の印刷可能文字を含めることもできます。値はスペースで開始または終了することはできません。値は \ で終了することはできません。値に " を含めることはできません。

  • ValueTypeReferenceHeader に設定されている場合、リクエストヘッダーのフィールドを参照できます。値は 1~128 文字の長さで、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

value

ValueType

string

任意

ヘッダー値のタイプ。有効値:

  • UserDefined: カスタムヘッダー値を指定できます。

  • ReferenceHeader: リクエストヘッダーのフィールドを参照できます。

  • SystemDefined: 値はシステム定義の値です。

SystemDefined

Order

integer

必須

操作の順序。有効値: 1~50000。操作は昇順で実行されます。値は一意である必要があります。

1

RedirectConfig

object

任意

リダイレクト操作の設定。

説明

httpCode を除く RedirectConfig のすべてのパラメーターにデフォルト値を使用することはできません。

Host

string

任意

宛先ホスト名。有効値:

  • ${host} (デフォルト): この値に他の文字を追加することはできません。

  • その他の値。値は次の要件を満たす必要があります:
    • ホスト名は 3~128 文字の長さで、小文字、数字、ハイフン (-)、ピリオド (.)、ワイルドカード文字 (*)、等号 (=)、チルダ (~)、アンダースコア (_)、プラス記号 (+)、バックスラッシュ (\)、曲折アクセント記号 (^)、感嘆符 (!)、ドル記号 ($)、アンパサンド (&)、縦棒 (|)、括弧 (())、角括弧 ([])、および疑問符 (?) を含めることができます。

    • ホスト名には少なくとも 1 つのピリオド (.) を含める必要があります。ピリオド (.) は最初の文字または最後の文字にすることはできません。

    • 右端のドメインラベルには、文字とワイルドカード文字のみを含めることができます。数字やハイフン (-) を含めることはできません。左端の domainlable はアスタリスク (*) にすることができます。

    • ハイフン (-) はドメインラベルの最初の文字または最後の文字にすることはできません。

    • アスタリスク (*) や疑問符 (?) などのワイルドカード文字は、ドメインラベルの任意の位置に配置できます。

${host}

HttpCode

string

任意

リダイレクトメソッド。有効値: 301302303307、および 308

301

Path

string

任意

宛先パス。有効値:

  • ${path} (デフォルト): ${host}${protocol}、および ${port} を参照できます。各変数は 1 回しか参照できません。これらの変数を一緒に使用したり、次のリストで指定されている文字列と組み合わせたりできます。

  • その他の値。値は次の要件を満たす必要があります:
    • 値は 1~128 文字の長さで、大文字と小文字が区別され、アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。

    • 値はスラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: $-_.+/&~@:'*?“%#;!()[]^,”\" を含めることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。

/

Port

string

任意

宛先ポート。

  • ${port} (デフォルト): この値を他の文字と一緒に使用することはできません。

  • その他の値: 1~63335

443

Protocol

string

任意

宛先プロトコル。有効値:

  • ${protocol} (デフォルト): この値のみを使用できます。変更したり、他の文字を追加したりすることはできません。

  • HTTP

  • HTTPS

説明
  • HTTPS リスナーは HTTPS へのリダイレクトのみをサポートします。

  • HTTP リスナーは HTTP および HTTPS へのリダイレクトをサポートします。

HTTPS

Query

string

任意

宛先クエリ文字列。

  • ${query} (デフォルト): ${host}${protocol}、および ${port} を参照できます。各変数は 1 回しか参照できません。これらの変数を一緒に使用したり、次のリストで指定されている文字列と組み合わせたりできます。

  • その他の値。値は次の要件を満たす必要があります:
    • 値は 1~128 文字の長さである必要があります。

    • 値には印刷可能文字を含めることができます。スペースや次の特殊文字を含めることはできません: #[]{}\|<>"。値に文字が含まれている場合、文字は小文字である必要があります。

${query}

RewriteConfig

object

任意

書き換え操作の設定。

説明

転送ルールに複数の操作を設定する場合、RewriteConfig 操作は ForwardGroup 操作タイプで使用する必要があります。

Host

string

任意

内部リダイレクトの宛先ホスト名。有効値:

  • ${host} (デフォルト): この値に他の文字を追加することはできません。

  • その他の値。値は次の要件を満たす必要があります:

    • ホスト名は 3~128 文字の長さで、小文字、数字、ハイフン (-)、ピリオド (.)、ワイルドカード文字 (*)、等号 (=)、チルダ (~)、アンダースコア (_)、プラス記号 (+)、バックスラッシュ (\)、曲折アクセント記号 (^)、感嘆符 (!)、ドル記号 ($)、アンパサンド (&)、縦棒 (|)、括弧 (())、角括弧 ([])、および疑問符 (?) を含めることができます。

    • ホスト名には少なくとも 1 つのピリオド (.) を含める必要があります。ピリオド (.) は最初の文字または最後の文字にすることはできません。

    • 右端のドメインラベルには、文字とワイルドカード文字のみを含めることができます。数字やハイフン (-) を含めることはできません。左端の domainlable はアスタリスク (*) にすることができます。

    • ハイフン (-) はドメインラベルの最初の文字または最後の文字にすることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカード文字は、ドメインラベルの任意の位置に配置できます。

www.rewrite.alb

Path

string

任意

宛先パス。有効値:

  • ${path} (デフォルト): ${host}${protocol}、および ${port} を参照できます。各変数は 1 回しか参照できません。これらの変数を一緒に使用したり、次のリストで指定されている文字列と組み合わせたりできます。

  • その他の値。値は次の要件を満たす必要があります:
    • 値は 1~128 文字の長さで、大文字と小文字が区別され、アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。

    • 値はスラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: $-_.+/&~@:'*?“%#;!()[]^,”\" を含めることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカード文字を含めることができます。

/tea

Query

string

任意

内部リダイレクトのクエリ文字列。

  • ${query} (デフォルト): ${host}${protocol}、および ${port} を参照できます。各変数は 1 回しか参照できません。これらの変数を一緒に使用したり、次のリストで指定されている文字列と組み合わせたりできます。

  • その他の値。値は次の要件を満たす必要があります:
    • 値は 1~128 文字の長さである必要があります。

    • 値には印刷可能文字を含めることができます。スペースや次の特殊文字を含めることはできません: #[]{}\|<>"。値に文字が含まれている場合、文字は小文字である必要があります。

${query}

Type

string

必須

操作タイプ。有効値:

  • ForwardGroup: リクエストを複数の vServer グループに転送します。

  • Redirect: リクエストをリダイレクトします。

  • FixedResponse: 固定レスポンスを返します。

  • Rewrite: リクエストを書き換えます。

  • InsertHeader: ヘッダーを挿入します。

  • RemoveHeader: ヘッダーを削除します。

  • TrafficLimit: トラフィックをスロットリングします。

  • TrafficMirror: トラフィックをミラーリングします。

  • Cors: オリジン間リソース共有 (CORS) を有効にします。

説明

転送ルールには、ForwardGroupRedirect、または FixedResponse 操作を含める必要があります。これらの操作を他の操作タイプで使用する場合は、これらの操作が最後に実行されるように設定する必要があります。

ForwardGroup

TrafficLimitConfig

object

任意

トラフィックの速度制限設定。

QPS

integer

任意

1 秒あたりのクエリ数 (QPS)。有効値: 11000000

5000

PerIpQps

integer

任意

単一 IP アドレスの QPS。有効値: 1~1000000

説明

QPS と PerIpQps の両方を指定する場合、PerIpQps の値は QPS の値より小さくする必要があります。

100

TrafficMirrorConfig

object

任意

トラフィックミラーリングの設定。

TargetType

string

任意

トラフィックがミラーリングされる宛先のタイプ。有効値:

  • ForwardGroupMirror: トラフィックを vServer グループにミラーリングします。

ForwardGroupMirror

MirrorGroupConfig

object

任意

トラフィックがミラーリングされる vServer グループ。

ServerGroupTuples

array

任意

トラフィックがミラーリングされる vServer グループ。

object

任意

トラフィックがミラーリングされる vServer グループ。

ServerGroupId

string

任意

vServer グループの ID。

sgp-u9cmf16iu69******

RemoveHeaderConfig

object

任意

HTTP ヘッダーを削除するための設定。

Key

string

任意

削除するヘッダーのキー。キーの長さは 1~40 文字で、文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。RemoveHeader のヘッダーキーは同じにできません。

  • Direction が Request に設定されている場合、次のヘッダーキーはサポートされていません (大文字と小文字は区別されません): slb-idslb-ipx-forwarded-forx-forwarded-protox-forwarded-eipx-forwarded-portx-forwarded-client-srcportconnectionupgradecontent-lengthtransfer-encodingkeep-alivetehostcookieremoteipauthority、および x-forwarded-host

  • Direction が Response に設定されている場合、次のヘッダーキーはサポートされていません (大文字と小文字は区別されません): connectionupgradecontent-length、および transfer-encoding

key

CorsConfig

object

任意

CORS の設定。

AllowOrigin

array

任意

許可されるオリジン。

string

任意

許可されるオリジンのリスト。アスタリスク (*) を 1 つだけ指定するか、1 つ以上の値を指定できます。

  • 値は http:// または https:// で始まり、その後に有効なドメイン名またはレベル 1 のワイルドカードドメイン名が続く必要があります。例: http://*.test.abc.example.com

  • ポートを指定することも、指定しないこともできます。ポート番号は 165535 の範囲である必要があります。

http://www.test.com

AllowMethods

array

任意

クロスオリジンリクエストで許可される HTTP メソッド。

string

任意

クロスオリジンリクエストで許可される HTTP メソッド。有効値:

  • GET

  • POST

  • PUT

  • DELETE

  • HEAD

  • OPTIONS

  • PATCH

GET

AllowHeaders

array

任意

クロスオリジンリクエストで許可されるヘッダー。

string

任意

クロスオリジンリクエストで許可されるヘッダー。アスタリスク (*) または 1 つ以上の値を指定できます。複数の値はカンマ (,) で区切ります。値は 1~32 文字の長さで、文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。アンダースコア (_) とハイフン (-) は最初の文字または最後の文字にすることはできません。

AllowHeader

ExposeHeaders

array

任意

公開できるヘッダー。

string

任意

公開できるヘッダー。アスタリスク (*) または 1 つ以上の値を指定できます。複数の値はカンマ (,) で区切ります。値は 1~32 文字の長さで、文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。アンダースコア (_) とハイフン (-) は最初の文字または最後の文字にすることはできません。

ExposeHeader

AllowCredentials

string

任意

資格情報を許可するかどうかを指定します。有効値:

  • on: はい。

  • off: いいえ。

列挙値:

  • off :

    off

  • on :

    on

on

MaxAge

integer

任意

ブラウザでのプリフライトリクエストの最大キャッシュ時間。単位: 秒。

有効値: -1172800

600

RuleConditions

array

必須

転送ルールの条件。

array<object>

必須

転送ルールの条件。

CookieConfig

object

任意

Cookie ベースのルーティング条件。

Values

array

任意

Cookie のキーと値のペア。

object

任意

Cookie のキーと値のペア。

Key

string

任意

Cookie のキー。

  • キーは 1~100 文字の長さである必要があります。

  • 印刷可能文字、ワイルドカード文字 (* および ?)、および小文字を含めることができます。

  • スペースや次の特殊文字を含めることはできません: ;#[]{}\|<>&"

key

Value

string

任意

Cookie の値。

  • 値は 1~100 文字の長さである必要があります。

  • 印刷可能文字、ワイルドカード文字 (* および ?)、および小文字を含めることができます。

  • スペースや次の特殊文字を含めることはできません: ;#[]{}\|<>&"

value

HeaderConfig

object

任意

ヘッダーベースのルーティング条件。

Key

string

任意

リクエストヘッダーのキー。

  • キーは 1~40 文字の長さである必要があります。

  • 文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

  • キーは Cookie または Host にすることはできません。

port

Values

array

任意

リクエストヘッダーの値。

string

任意

リクエストヘッダーの値。同じヘッダーキーの値は同じにできません。

  • 値は 1~128 文字の長さである必要があります。

  • ASCII 値が ch >= 32 && ch < 127 の印刷可能文字、アスタリスク (*)、および疑問符 (?) を含めることができます。" を含めることはできません。

  • 値はスペースで開始または終了することはできません。値は \ で終了することはできません。

5006

HostConfig

object

任意

ホストベースのルーティング条件。

Values

array

任意

ホスト名。

string

任意

ホスト名。1 つの条件に指定できるホスト名は 1 つだけで、他の条件のホスト名と同じにすることはできません。

  • ホスト名は 3~128 文字の長さで、小文字、数字、ハイフン (-)、ピリオド (.)、アスタリスク (*)、等号 (=)、チルダ (~)、アンダースコア (_)、プラス記号 (+)、バックスラッシュ (\)、曲折アクセント記号 (^)、感嘆符 (!)、ドル記号 ($)、アンパサンド (&)、縦棒 (|)、括弧 (())、角括弧 ([])、および疑問符 (?) を含めることができます。

  • ホスト名には少なくとも 1 つのピリオド (.) を含める必要があります。ピリオド (.) は最初の文字または最後の文字にすることはできません。

  • 右端のドメインラベルには、文字とワイルドカード文字のみを含めることができます。数字やハイフン (-) を含めることはできません。左端の domainlable はアスタリスク (*) にすることができます。

  • ハイフン (-) はドメインラベルの最初の文字または最後の文字にすることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカード文字は、ドメインラベルの任意の位置に配置できます。

  • 完全一致およびワイルドカード一致の場合、値はチルダ (~) で始めることはできません。

  • 正規表現一致の場合、値はアスタリスク (*) で始めることはできません。

www.example.com

MethodConfig

object

任意

メソッドベースのルーティング条件。

Values

array

任意

HTTP リクエストメソッド。

string

任意

リクエストメソッド。

有効値: HEADGETPOSTOPTIONSPUTPATCH、および DELETE

PUT

PathConfig

object

任意

パスベースのルーティング条件。

Values

array

任意

パス。

string

任意

転送パス。パスは次の要件を満たす必要があります:

  • パスは 1~128 文字の長さで、大文字と小文字が区別され、ワイルドカード文字 (* および ?) を含めることができます。

  • 正規表現ではない URL は、スラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: $-_.+/&~@:'*?“%#;!()[]^,”\" を含めることはできません。ワイルドカード文字 (* および ?) を含めることができます。

  • 正規表現である URL は、チルダ (~) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: .-_/=?~^*$:()[]+|

/test

QueryStringConfig

object

任意

クエリ文字列ベースのルーティング条件。

Values

array

任意

クエリ文字列のキーと値のペア。

object

任意

クエリ文字列のキーと値のペア。

Key

string

任意

クエリ文字列のキー。

  • キーは 1~100 文字の長さである必要があります。

  • 印刷可能文字、ワイルドカード文字 (* および ?)、および小文字を含めることができます。スペースや次の特殊文字を含めることはできません: #[]{}\|<>&"

key

Value

string

任意

クエリ文字列の値。

  • 値は 1~128 文字の長さである必要があります。

  • 小文字、印刷可能文字、ワイルドカード文字 (* および ?) を含めることができます。スペースや次の特殊文字を含めることはできません: #[]{}\|<>&"

value

ResponseHeaderConfig

object

任意

レスポンスヘッダーの設定。

Key

string

任意

レスポンスヘッダーのキー。

  • キーは 1~40 文字の長さである必要があります。

  • 文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。

  • キーは Cookie または Host にすることはできません。

key

Values

array

任意

レスポンスヘッダーの値。

string

任意

レスポンスヘッダーの値。

  • 値は 1~128 文字の長さである必要があります。

  • ASCII 値が ch >= 32 && ch < 127 の印刷可能文字、小文字、ワイルドカード文字 (* および ?) を含めることができます。" を含めることはできません。

  • 値はスペースで開始または終了することはできません。値は \ で終了することはできません。

value

ResponseStatusCodeConfig

object

任意

レスポンスステータスコードの設定。

Values

array

任意

レスポンスステータスコード。

string

任意

レスポンスステータスコード。

200

Type

string

必須

条件のタイプ。有効値:

  • Host: 条件はホスト名に基づいています。

  • Path: 条件はパスに基づいています。

  • Header: 条件はリクエストヘッダーに基づいています。

  • QueryString: 条件はクエリ文字列に基づいています。

  • Method: 条件はリクエストメソッドに基づいています。

  • Cookie: 条件は Cookie に基づいています。

  • SourceIp: 条件はソース IP アドレスに基づいています。

  • ResponseHeader: 条件はレスポンスヘッダーに基づいています。

  • ResponseStatusCode: 条件はレスポンスステータスコードに基づいています。

列挙値:

  • Cookie :

    Cookie

  • Path :

    Path

  • ResponseHeader :

    ResponseHeader

  • SourceIp :

    SourceIp

  • Header :

    Header

  • ResponseStatusCode :

    ResponseStatusCode

  • QueryString :

    QueryString

  • Host :

    Host

  • Method :

    Method

SourceIp

SourceIpConfig

object

任意

ソース IP アドレスベースのルーティング条件。

Values

array

任意

ソース IP アドレスまたは CIDR ブロック。

string

任意

1 つ以上の IP アドレスまたは CIDR ブロックを追加します。

転送ルールには最大 5 つのソース IP アドレスを追加できます。

192.168.XX.XX/32

RuleName

string

必須

転送ルールの名前。

rule-443-64

Direction

string

任意

転送ルールの方向。

列挙値:

  • Response :

    Response

  • Request :

    Request

Request

Tag

array

任意

タグ。

object

任意

タグ。

Key

string

任意

タグキー。タグキーは最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

test_tag_key

Value

string

任意

タグ値。タグ値は最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

test_tag_value

レスポンスフィールド

フィールド

説明

object

複数の転送ルールを作成します。

JobId

string

非同期タスクの ID。

72dcd26b-f12d-4c27-b3af-18f6aed5****

RequestId

string

リクエスト ID。

365F4154-92F6-4AE4-92F8-7FF34B540710

RuleIds

array<object>

転送ルール。

object

転送ルール。

RuleId

string

転送ルール ID。

rule-a3x3pg1yohq3lq****

Priority

integer

転送ルールの優先度。有効値: 1~10000。値が小さいほど、優先度が高くなります。

説明

同じリスナーに対して作成された転送ルールの優先度は一意である必要があります。

10

成功レスポンス

JSONJSON

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "RuleIds": [
    {
      "RuleId": "rule-a3x3pg1yohq3lq****",
      "Priority": 10
    }
  ]
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IncorrectStatus.Listener The status of %s [%s] is incorrect.
400 OperationDenied.IpGroupCanNotUsedForMirrorAction The operation is not allowed because of %s.
400 OperationDenied.SameGroupForForwardAndMirrorAction The operation is not allowed because of %s.
400 OperationDenied.GRPCServerGroup The operation is not allowed because of %s.
400 Conflict.Priority There is already %s having the same configuration with %s.
400 ResourceQuotaExceeded.LoadBalancerRulesNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 ResourceQuotaExceeded.ServerGroupAttachedNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 ResourceQuotaExceeded.LoadBalancerServersNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 ResourceQuotaExceeded.ServerAddedNum The quota of %s is exceeded for resource %s, usage %s/%s.
400 QuotaExceeded.RuleWildcardsNum The quota of %s is exceeded, usage %s/%s.
400 QuotaExceeded.RuleMatchEvaluationsNum The quota of %s is exceeded, usage %s/%s.
400 QuotaExceeded.RuleActionsNum The quota of %s is exceeded, usage %s/%s.
400 Mismatch.VpcId The %s is mismatched for %s and %s.
400 Mismatch.Protocol The %s is mismatched for %s and %s.
400 OperationDenied.RewriteMissingForwardGroup The operation is not allowed because of RewriteMissingForwardGroup.
400 OperationDenied.MirrorActionSupportHttpGroupOnly The operation is not allowed because of MirrorActionSupportHttpGroupOnly.
400 OperationDenied.ProtocolMustSameForForwardGroupAction The operation is not allowed because of ProtocolMustSameForForwardGroupAction.
404 ResourceNotFound.Listener The specified resource %s is not found.
404 ResourceNotFound.ServerGroup The specified resource %s is not found.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。