CreateRules API で ALB 転送ルールを一括作成する - Application Load Balancer - Alibaba Cloud - Server Load Balancer

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

操作説明

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

Redirect 操作を設定する場合、HttpCode を除くすべてのパラメーターをデフォルト値に設定することはできません。
同じ転送ルールに複数の操作を設定する場合、Rewrite 操作は ForwardGroup 操作タイプと併用する必要があります。
CreateRules 操作は非同期です。リクエスト送信後、システムはインスタンス ID を返しますが、転送ルールはまだ作成されていません。作成タスクはバックグラウンドで実行中です。 ListRules を呼び出して、転送ルールの作成ステータスをクエリできます。
- 転送ルールが プロビジョニング 状態の場合、転送ルールは作成中です。
- 転送ルールが Available 状態の場合、転送ルールは作成済みです。
転送ルールに追加できる条件 (RuleConditions) および操作 (RuleActions) の最大値は以下の通りです。
- 条件: Basic Edition は 5、標準エディションは 10、WAF Enhanced Edition は 10。
- 操作: Basic Edition は 3、標準エディションは 5、WAF Enhanced Edition は 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 文字のみを使用できます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API 呼び出しごとに異なる場合があります。	5A2CFF0E-5718-45B5-9D4D-70B3FF3898
DryRun	boolean	任意	実際のリクエストを実行せずに、ドライランのみを実行するかどうかを指定します。有効な値: true: ドライランのみを実行します。システムは、パラメーター値の欠落、不正なリクエスト構文、サービスの制限など、リクエストの潜在的な問題を確認します。ドライランに失敗した場合、エラーコードが返されます。ドライランに成功した場合、`DryRunOperation` エラーコードが返されます。 false (デフォルト): ドライランを実行し、実際のリクエストを実行します。ドライランに成功した場合、`HTTP 2xx` 状態コードが返され、操作が実行されます。	false
Rules	array<object>	必須	転送ルールのリスト。
	array<object>	必須	転送ルール。
Priority	integer	必須	転送ルールの優先度。	1
RuleActions	array<object>	必須	転送ルールの操作のリスト。
	array<object>	必須	転送ルールの操作。
FixedResponseConfig	object	任意	固定応答操作の構成。
Content	string	任意	固定レスポンス。レスポンスのサイズは最大 1 KB で、ASCII 文字のみを含めることができます。	test
ContentType	string	任意	固定レスポンスのフォーマット。有効値: text/plain、text/css、text/html、application/javascript、および application/json。	text/plain
HttpCode	string	任意	レスポンスの HTTP ステータスコード。有効値は 2xx、4xx、5xx です。x は数字です。	200
ForwardGroupConfig	object	任意	転送グループ操作の構成。
ServerGroupTuples	array<object>	任意	宛先 vServer グループ。
	object	任意	宛先 vServer グループ。
ServerGroupId	string	任意	vServer グループ ID。	sgp-ffm94ovy7lqw******
Weight	integer	任意	重み。値が大きいほど、重みが高くなります。重みが大きい vServer グループには、より多くのリクエストが転送されます。有効値: 0～100。宛先 vServer グループを 1 つだけ指定した場合、このパラメーターのデフォルト値は 100 です。複数の宛先 vServer グループを指定する場合は、各 vServer グループの重みを指定する必要があります。	100
ServerGroupStickySession	object	任意	vServer グループのセッション維持。
Enabled	boolean	任意	セッション維持を有効にするかどうかを指定します。有効値: true: セッション維持を有効にします。 false (デフォルト): セッション維持を無効にします。	false
Timeout	integer	任意	タイムアウト期間。単位: 秒。有効値: 1～86400。デフォルト値: 1000。	30
InsertHeaderConfig	object	任意	ヘッダー挿入操作の構成。
Key	string	任意	挿入するヘッダーのキー。キーの長さは 1～40 文字で、文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。InsertHeaderConfig のヘッダーキーは同じにできません。説明次のヘッダーキーはサポートされていません (大文字と小文字は区別されません): `slb-id`、`slb-ip`、`x-forwarded-for`、`x-forwarded-proto`、`x-forwarded-eip`、`x-forwarded-port`、`x-forwarded-client-srcport`、`connection`、`upgrade`、`content-length`、`transfer-encoding`、`keep-alive`、`te`、`host`、`cookie`、`remoteip`、`authority`、および `x-forwarded-host`。	key
Value	string	任意	挿入するヘッダーの値。 ValueType が SystemDefined に設定されている場合、次のいずれかの値を指定できます: ClientSrcPort: クライアントポート。 ClientSrcIp: クライアント IP アドレス。 Protocol: クライアントリクエストのプロトコル (HTTP または HTTPS)。 SLBId: ALB インスタンスの ID。 SLBPort: ALB インスタンスのリスニングポート。 ValueType が UserDefined に設定されている場合、カスタムヘッダー値を指定できます。値は 1～128 文字の長さで、アスタリスク () や疑問符 (?) などのワイルドカード文字を含めることができます。また、ASCII 値が `ch >= 32 && ch < 127` の印刷可能文字を含めることもできます。値はスペースで開始または終了することはできません。値は `\` で終了することはできません。値に `"` を含めることはできません。 ValueType* が ReferenceHeader に設定されている場合、リクエストヘッダーのフィールドを参照できます。値は 1～128 文字の長さで、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。	value
ValueType	string	任意	ヘッダー値のタイプ。有効値: UserDefined: カスタムヘッダー値を指定できます。 ReferenceHeader: リクエストヘッダーのフィールドを参照できます。 SystemDefined: 値はシステム定義の値です。	SystemDefined
Order	integer	必須	転送ルールの操作が実行される順序。有効な値: 1 ～ 50000。操作は値の昇順で実行されます。このパラメーターは空にできず、値を重複させることはできません。	1
RedirectConfig	object	任意	リダイレクトのセット。説明 RedirectConfig のパラメーターについて、httpCode を除くすべてのパラメーターをデフォルト値に設定することはできません。
Host	string	任意	宛先ホスト名。有効値: ${host} (デフォルト): この値に他の文字を追加することはできません。その他の値。値は次の要件を満たす必要があります: ホスト名は 3～128 文字の長さで、小文字、数字、ハイフン (-)、ピリオド (.)、ワイルドカード文字 ()、等号 (=)、チルダ (~)、アンダースコア (_)、プラス記号 (+)、バックスラッシュ (\)、曲折アクセント記号 (^)、感嘆符 (!)、ドル記号 ($)、アンパサンド (&)、縦棒 (\|)、括弧 (())、角括弧 ([])、および疑問符 (?) を含めることができます。ホスト名には少なくとも 1 つのピリオド (.) を含める必要があります。ピリオド (.) は最初の文字または最後の文字にすることはできません。右端のドメインラベルには、文字とワイルドカード文字のみを含めることができます。数字やハイフン (-) を含めることはできません。左端の `domainlable` はアスタリスク () にすることができます。ハイフン (-) はドメインラベルの最初の文字または最後の文字にすることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカード文字は、ドメインラベルの任意の位置に配置できます。	${host}
HttpCode	string	任意	リダイレクトメソッド。有効値: 301、302、303、307、および 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: リクエストを複数の仮想サービスに転送します。 Redirect: リクエストをリダイレクトします。 FixedResponse: 固定応答を返します。 Rewrite: リクエストを再書き込みします。 InsertHeader: ヘッダーフィールドを挿入します。 RemoveHeader: ヘッダーフィールドを削除します。 TrafficLimit: トラフィックを速度制限します。 TrafficMirror: トラフィックをミラーリングします。 Cors: Cross-Origin リソース共有 (CORS) を有効にします。説明転送ルールには、ForwardGroup (転送)、Redirect (リダイレクト)、または FixedResponse (固定応答の返却) のいずれかの操作を含める必要があります。この操作が他の操作タイプと共存する場合、最後に実行する必要があります。	ForwardGroup
TrafficLimitConfig	object	任意	トラフィックの速度制限の構成。
QPS	integer	任意	1 秒あたりのクエリ数 (QPS)。有効値: 1～1000000。	5000
PerIpQps	integer	任意	単一 IP アドレスの QPS。有効値: 1～1000000。説明 QPS と PerIpQps の両方を指定する場合、PerIpQps の値は QPS の値より小さくする必要があります。	100
TrafficMirrorConfig	object	任意	トラフィックミラーリングの構成。
TargetType	string	任意	トラフィックがミラーリングされる宛先のタイプ。有効値: ForwardGroupMirror: トラフィックを vServer グループにミラーリングします。	ForwardGroupMirror
MirrorGroupConfig	object	任意	トラフィックがミラーリングされる vServer グループ。
ServerGroupTuples	array<object>	任意	トラフィックがミラーリングされる vServer グループ。
	object	任意	トラフィックがミラーリングされる vServer グループ。
ServerGroupId	string	任意	vServer グループの ID。	sgp-u9cmf16iu69******
RemoveHeaderConfig	object	任意	HTTP ヘッダーを削除するための構成。
Key	string	任意	削除するヘッダーのキー。キーの長さは 1～40 文字で、文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。RemoveHeader のヘッダーキーは同じにできません。 Direction が Request に設定されている場合、次のヘッダーキーはサポートされていません (大文字と小文字は区別されません): `slb-id`、`slb-ip`、`x-forwarded-for`、`x-forwarded-proto`、`x-forwarded-eip`、`x-forwarded-port`、`x-forwarded-client-srcport`、`connection`、`upgrade`、`content-length`、`transfer-encoding`、`keep-alive`、`te`、`host`、`cookie`、`remoteip`、`authority`、および `x-forwarded-host`。 Direction が Response に設定されている場合、次のヘッダーキーはサポートされていません (大文字と小文字は区別されません): `connection`、`upgrade`、`content-length`、および `transfer-encoding`。	key
CorsConfig	object	任意	CORS の構成。
AllowOrigin	array	任意	許可されるオリジン。
	string	任意	許可されるオリジンのリスト。アスタリスク () を 1 つだけ指定するか、1 つ以上の値を指定できます。値は `http://` または `https://` で始まり、その後に有効なドメイン名またはレベル 1 のワイルドカードドメイン名が続く必要があります。例: `http://.test.abc.example.com`。ポートを指定することも、指定しないこともできます。ポート番号は 1～65535 の範囲である必要があります。	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	任意	ブラウザでのプリフライトリクエストの最大キャッシュ時間。単位: 秒。有効値: -1～172800。	600
RuleConditions	array<object>	必須	転送ルールの条件のリスト。
	array<object>	必須	転送ルールの条件。
CookieConfig	object	任意	Cookie 条件の構成。
Values	array<object>	任意	Cookie のキーと値のペア。
	object	任意	Cookie のキーと値のペア。
Key	string	任意	Cookie のキー。キーは 1～100 文字の長さである必要があります。印刷可能文字、ワイルドカード文字 (* および ?)、および小文字を含めることができます。スペースや次の特殊文字を含めることはできません: `;#[]{}\\|<>&"`。	key
Value	string	任意	Cookie の値。値は 1～100 文字の長さである必要があります。印刷可能文字、ワイルドカード文字 (* および ?)、および小文字を含めることができます。スペースや次の特殊文字を含めることはできません: `;#[]{}\\|<>&"`。	value
HeaderConfig	object	任意	HTTP ヘッダー条件の構成。
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	任意	HTTP リクエストメソッド条件の構成。
Values	array	任意	HTTP リクエストメソッド。
	string	任意	リクエストメソッド。有効値: HEAD、GET、POST、OPTIONS、PUT、PATCH、および DELETE。	PUT
PathConfig	object	任意	パス条件の構成。
Values	array	任意	パス。
	string	任意	転送パス。パスは次の要件を満たす必要があります: パスは 1～128 文字の長さで、大文字と小文字が区別され、ワイルドカード文字 (* および ?) を含めることができます。正規表現ではない URL は、スラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: `$-_.+/&~@:'?`。`“%#;!()[]^,”\"` を含めることはできません。ワイルドカード文字 ( および ?) を含めることができます。正規表現である URL は、チルダ (~) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: `.-_/=?~^*$:()[]+\|`。	/test
QueryStringConfig	object	任意	クエリ文字列条件の構成。
Values	array<object>	任意	クエリ文字列のキーと値のペア。
	object	任意	クエリ文字列のキーと値のペア。
Key	string	任意	クエリ文字列のキー。キーは 1～100 文字の長さである必要があります。印刷可能文字、ワイルドカード文字 (* および ?)、および小文字を含めることができます。スペースや次の特殊文字を含めることはできません: `#[]{}\\|<>&"`。	key
Value	string	任意	クエリ文字列の値。値は 1～128 文字の長さである必要があります。小文字、印刷可能文字、ワイルドカード文字 (* および ?) を含めることができます。スペースや次の特殊文字を含めることはできません: `#[]{}\\|<>&"`。	value
ResponseHeaderConfig	object	任意	応答 HTTP ヘッダーの構成。 [_single.params.R
Key	string	任意	レスポンスヘッダーのキー。キーは 1～40 文字の長さである必要があります。文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。キーは Cookie または Host にすることはできません。	key
Values	array	任意	レスポンスヘッダーの値。
	string	任意	レスポンスヘッダーの値。値は 1～128 文字の長さである必要があります。 ASCII 値が `ch >= 32 && ch < 127` の印刷可能文字、小文字、ワイルドカード文字 (* および ?) を含めることができます。`"` を含めることはできません。値はスペースで開始または終了することはできません。値は `\` で終了することはできません。	value
ResponseStatusCodeConfig	object	任意	The response status code configuration.
Values	array	任意	レスポンスステータスコード。
	string	任意	レスポンスステータスコード。	200
Type	string	必須	The type of forwarding condition. Valid values: Host: host. Path: path. Header: HTTP header field. QueryString: query string. Method: request method. Cookie: cookie. SourceIp: source IP address. ResponseHeader: response HTTP header field. ResponseStatusCode: response status code. 列挙値: Cookie : Cookie。 Path : Path。 ResponseHeader : ResponseHeader。 SourceIp : SourceIp。 Header : Header。 ResponseStatusCode : ResponseStatusCode。 QueryString : QueryString [parameters.3.schema.items.properties.RuleConditions.items.properties.Type.enumValue Host : Host Method : Method	SourceIp
SourceIpConfig	object	任意	The source IP-based service traffic matching configuration.
Values	array	任意	ソース IP アドレスまたは CIDR ブロック。
	string	任意	1 つ以上の IP アドレスまたは CIDR ブロックを追加します。転送ルールには最大 5 つのソース IP アドレスを追加できます。	192.168.XX.XX/32
RuleName	string	必須	The name of the forwarding rule.	rule-443-64
Direction	string	任意	The direction of the forwarding rule. 列挙値: Response : Response Request : Request	Request
Tag	array<object>	任意	The list of tags.
	object	任意	The tag.
Key	string	任意	The tag key. The tag key can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.	test_tag_key
Value	string	任意	The tag value. The tag value can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://.	test_tag_value

レスポンスフィールド

フィールド	型	説明	例
	object	Creates multiple forwarding rules.
JobId	string	The asynchronous task ID.	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	The request ID.	365F4154-92F6-4AE4-92F8-7FF34B540710
RuleIds	array<object>	転送ルールのリスト。
	object	転送ルールのリスト。
RuleId	string	The forwarding rule ID.	rule-a3x3pg1yohq3lq****
Priority	integer	The priority of the forwarding rule. Valid values: 1 to 10000. A smaller value indicates a higher priority. 説明 The priority of each rule within the same listener must be unique.	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.

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

変更履歴

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