CreateRule - - Alibaba Cloud ドキュメントセンター

指定されたリスナーの転送ルールを作成します。

操作説明

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

リダイレクト操作を設定する場合、HttpCode 以外のパラメーターを少なくとも 1 つ、デフォルト以外の値に設定する必要があります。
同じ転送ルールに複数の操作を設定する場合、Rewrite 操作には ForwardGroup 操作を付随させる必要があります。
CreateRule は非同期操作です。リクエストが送信されると、システムはリクエスト 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:CreateRule

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 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは自動的にリクエストの RequestId を ClientToken として使用します。各 API リクエストの RequestId は異なります。	5A2CFF0E-5718-45B5-9D4D-70B******
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値: true: ドライランを実行し、転送ルールは作成しません。システムは、必須パラメーター、リクエストフォーマット、およびサービス制限についてリクエストをチェックします。リクエストがチェックに失敗した場合、エラーメッセージが返されます。リクエストがチェックに合格した場合、`DryRunOperation` エラーコードが返されます。 false (デフォルト): リクエストを送信します。リクエストがチェックに合格した場合、`2xx` HTTP ステータスコードが返され、操作が実行されます。	false
Priority	integer	必須	ルールの優先度。値が小さいほど、優先度が高くなります。有効な値: 1～10000。説明同じリスナー内の各ルールの優先度は一意である必要があります。	10
Direction	string	任意	転送ルールの方向。有効な値: Request (デフォルト): 転送ルールはリクエスト転送ルールです。クライアントから ALB に送信されるリクエストの条件に一致し、操作を実行します。 Response: 転送ルールは応答転送ルールです。バックエンドサーバーグループから ALB に送信される応答の条件に一致し、操作を実行します。説明 Basic Edition の ALB インスタンスは Response タイプをサポートしていません。	Request
RuleActions	array<object>	必須	転送ルールの操作。
	array<object>	必須	ルールの操作。
FixedResponseConfig	object	任意	固定応答の設定。
Content	string	任意	固定応答。応答のサイズは最大 1 KB で、ASCII 文字のみを含めることができます。	dssacav
ContentType	string	任意	固定応答のフォーマット。有効な値: text/plain、text/css、text/html、application/javascript、および application/json。	text/plain
HttpCode	string	任意	応答の HTTP ステータスコード。2xx、4xx、または 5xx のステータスコードを指定できます。x は数字です。	200
ForwardGroupConfig	object	任意	リクエストが転送される vServer グループ。最大 5 つの vServer グループを指定できます。
ServerGroupTuples	array	任意	リクエストが転送される vServer グループ。最大 5 つの vServer グループを指定できます。
	object	任意	宛先 vServer グループ。
ServerGroupId	string	任意	宛先 vServer グループ。	sgp-k86c1ov501id6p****
Weight	integer	任意	重み。値が大きいほど、重みが高くなります。重みが大きい vServer グループには、より多くのリクエストが転送されます。有効な値: 0～100。宛先 vServer グループを 1 つだけ指定した場合、デフォルト値は 100 です。複数の宛先 vServer グループを指定した場合は、各 vServer グループの重みを指定する必要があります。	100
ServerGroupStickySession	object	任意	vServer グループのセッション維持。
Enabled	boolean	任意	セッション維持を有効にするかどうかを指定します。有効な値: true false (デフォルト)	false
Timeout	integer	任意	タイムアウト期間。単位: 秒。有効な値: 1～86400。デフォルト値: 1000。	100
InsertHeaderConfig	object	任意	挿入するヘッダーの設定。
Key	string	任意	挿入するヘッダーのキー。キーの長さは 1～40 文字で、文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。InsertHeaderConfig のキーは、別の 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 値が `32` から `127` までの印刷可能文字を含めることもできます。値はスペースで開始または終了することはできません。値は `\` にすることはできません。 ValueType* が ReferenceHeader に設定されている場合: リクエストヘッダーを参照できます。値は 1～128 文字の長さで、小文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。	UserDefined
ValueType	string	任意	ヘッダー値のタイプ。有効な値: UserDefined: カスタムヘッダー値を指定できます。 ReferenceHeader: リクエストヘッダーを参照できます。 SystemDefined: 値はシステム定義のヘッダー値です。	UserDefined
Order	integer	必須	操作の順序。有効な値: 1～50000。値が小さいほど、優先度が高くなります。値は空にすることも、異なる操作で同じにすることもできません。	1
RedirectConfig	object	任意	リダイレクトの設定。説明 httpCode を除く RedirectConfig のすべてのパラメーターをデフォルト値に設定することはできません。
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 文字の長さである必要があります。大文字と小文字が区別されます。アスタリスク () や疑問符 (?) などのワイルドカードを含めることができます。フォワードスラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: `$-_.+/&~@:'?`。`"%#;!()[]^,"\"` を含めることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカードを含めることができます。	/test
Port	string	任意	リクエストがリダイレクトされる宛先ポート。 ${port} (デフォルト): この値を他の文字と組み合わせて使用することはできません。その他の有効な値: 1～63335。	10
Protocol	string	任意	リクエストがリダイレクトされる宛先プロトコル。有効な値: ${protocol} (デフォルト): この値のみ使用できます。変更したり、他の文字と組み合わせたりすることはできません。 HTTP HTTPS 説明 HTTPS リスナーは HTTPS へのリダイレクトのみをサポートします。 HTTP リスナーは HTTP および HTTPS へのリダイレクトをサポートします。	HTTP
Query	string	任意	リクエストがリダイレクトされる宛先 URL のクエリ文字列。 ${query} (デフォルト): ${host}、${protocol}、および ${port} を参照できます。各変数は 1 回しか使用できません。これらの変数を一緒に使用したり、次の一覧で指定された文字列と組み合わせたりすることができます。その他の値: クエリ文字列は次の要件を満たす必要があります: クエリ文字列は 1～128 文字の長さである必要があります。印刷可能な文字を含めることができます。スペースや次の特殊文字を含めることはできません: `#[]{}\\|<>"`。小文字のみを含める必要があります。	${query}
RewriteConfig	object	任意	再書き込みの設定。説明同じ転送ルールに複数の操作を設定する場合、RewriteConfig 操作の ForwardGroup 操作タイプを設定する必要があります。
Host	string	任意	リクエストが再書き込みされる宛先ホスト。有効な値: ${host} (デフォルト): この値を他の文字と組み合わせて使用することはできません。その他の値: ホストは次の要件を満たす必要があります: ホストは 3～128 文字の長さで、小文字、数字、ハイフン (-)、ピリオド (.)、アスタリスク ()、等号 (=)、チルダ (~)、アンダースコア (_)、プラス記号 (+)、バックスラッシュ (\)、サーカムフレックス (^)、感嘆符 (!)、ドル記号 ($)、アンパサンド (&)、縦棒 (\|)、丸括弧 (())、角括弧 ([])、および疑問符 (?) を含めることができます。ホストには少なくとも 1 つのピリオド (.) を含める必要があります。ピリオドは最初または最後の文字にすることはできません。一番右のドメインラベルには、文字とワイルドカードのみを含めることができます。数字やハイフン (-) を含めることはできません。一番左の `domainlable` はアスタリスク () にすることができます。ハイフン (-) はドメインラベルの最初または最後の文字にすることはできません。アスタリスク (*) と疑問符 (?) はドメインラベルのどこでも使用できます。	www.example.com
Path	string	任意	リクエストが再書き込みされる宛先パス。有効な値: ${path} (デフォルト): ${host}、${protocol}、および ${port} を参照できます。各変数は 1 回しか使用できません。これらの変数を一緒に使用したり、次の一覧で指定された文字列と組み合わせたりすることができます。その他の値: パスは次の要件を満たす必要があります: パスは 1～128 文字の長さである必要があります。大文字と小文字が区別されます。アスタリスク () や疑問符 (?) などのワイルドカードを含めることができます。フォワードスラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: `$-_.+/&~@:'?`。`"%#;!()[]^,"\"` を含めることはできません。アスタリスク (*) や疑問符 (?) などのワイルドカードを含めることができます。	/tsdf
Query	string	任意	リクエストが再書き込みされる宛先 URL のクエリ文字列。 ${query} (デフォルト): ${host}、${protocol}、および ${port} を参照できます。各変数は 1 回しか使用できません。これらの変数を一緒に使用したり、次の一覧で指定された文字列と組み合わせたりすることができます。その他の値: クエリ文字列は次の要件を満たす必要があります: クエリ文字列は 1～128 文字の長さである必要があります。印刷可能な文字を含めることができます。スペースや次の特殊文字を含めることはできません: `#[]{}\\|<>"`。小文字のみを含める必要があります。	${query}
Type	string	必須	操作タイプ。有効な値: ForwardGroup: 複数の vServer グループにリクエストを転送します。 Redirect: リクエストをリダイレクトします。 FixedResponse: 固定応答を返します。 Rewrite: リクエストを再書き込みします。 InsertHeader: ヘッダーを挿入します。 RemoveHeader: ヘッダーを削除します。 TrafficLimit: トラフィックを制限します。 TrafficMirror: トラフィックをミラーリングします。 Cors: オリジン間リソース共有 (CORS) を有効にします。説明転送ルールには、ForwardGroup (転送)、Redirect (リダイレクト)、または FixedResponse (固定応答) 操作を含める必要があります。これらの操作を他のタイプの操作と併用する場合は、これらの操作が最後に実行されるようにする必要があります。	ForwardGroup
TrafficLimitConfig	object	任意	トラフィックの速度制限の設定。
QPS	integer	任意	クエリ/秒 (QPS)。有効な値: 1～1000000。	100
PerIpQps	integer	任意	単一 IP アドレスの QPS。有効な値: 1～1000000。説明 QPS と PerIpQps パラメーターの両方を指定する場合、PerIpQps の値は QPS の値より小さくする必要があります。	80
TrafficMirrorConfig	object	任意	トラフィックミラーリングの設定。
TargetType	string	任意	トラフィックがミラーリングされる宛先。有効な値: ForwardGroupMirror: トラフィックを vServer グループにミラーリングします。	ForwardGroupMirror
MirrorGroupConfig	object	任意	トラフィックがミラーリングされる vServer グループ。
ServerGroupTuples	array	任意	トラフィックがミラーリングされる vServer グループ。
	object	任意	トラフィックがミラーリングされる vServer グループ。
ServerGroupId	string	任意	vServer グループの ID。	sgp-00mkgijak0w4qgz9****
RemoveHeaderConfig	object	任意	削除する HTTP ヘッダーの設定。
Key	string	任意	削除するヘッダーのキー。キーの長さは 1～40 文字で、文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。キーは別の RemoveHeaderConfig で使用することはできません。リクエスト方向 (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`。	test
CorsConfig	object	任意	CORS の設定。
AllowOrigin	array	任意	許可されたオリジン。アスタリスク (``) を 1 つ指定するか、1 つ以上の値を指定できます。値は `http://` または `https://` で始まり、その後にドメイン名またはレベル 1 のワイルドカードドメイン名が続く必要があります。例: `http://.test.abc.example.com`。ポートを指定することも、指定しないこともできます。ポートは 1～65535 の整数である必要があります。
	string	任意	許可されたオリジン。	http://example.com
AllowMethods	array	任意	クロスオリジンリクエストで許可される HTTP メソッド。
	string	任意	クロスオリジンリクエストで許可される HTTP メソッド。有効な値: GET POST PUT DELETE HEAD OPTIONS PATCH	GET
AllowHeaders	array	任意	クロスオリジンリクエストで許可されるヘッダー。
	string	任意	許可されるヘッダー。アスタリスク (`*`) を指定するか、1 つ以上の値を指定できます。複数の値はカンマ (,) で区切ります。値には、文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。アンダースコアとハイフンは、最初または最後の文字にすることはできません。値の長さは最大 32 文字です。	test_123
ExposeHeaders	array	任意	公開できるヘッダー。
	string	任意	公開できるヘッダー。アスタリスク (`*`) を指定するか、1 つ以上の値を指定できます。複数の値はカンマ (,) で区切ります。値には、文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。アンダースコアとハイフンは、最初または最後の文字にすることはできません。値の長さは最大 32 文字です。	test_123
AllowCredentials	string	任意	認証情報を許可するかどうかを指定します。有効な値: on off	on
MaxAge	integer	任意	ブラウザでのプリフライトリクエストの最大キャッシュ時間。単位: 秒。有効な値: -1～172800。	1000
RuleConditions	array<object>	必須	転送ルールの条件。
	array<object>	必須	転送ルールの条件。
CookieConfig	object	任意	Cookie の設定。
Values	array	任意	Cookie。
	object	任意	クッキー。
Key	string	任意	Cookie のキー。キーは 1～100 文字の長さである必要があります。印刷可能な文字と、アスタリスク (*) や疑問符 (?) などのワイルドカードを含めることができます。小文字のみを含める必要があります。スペースや次の特殊文字を含めることはできません: `;#[]{}\\|<>&"`。	test
Value	string	任意	Cookie の値。値は 1～100 文字の長さである必要があります。印刷可能な文字と、アスタリスク (*) や疑問符 (?) などのワイルドカードを含めることができます。小文字のみを含める必要があります。スペースや次の特殊文字を含めることはできません: `;#[]{}\\|<>&"`。	test
HeaderConfig	object	任意	ヘッダーの設定。
Key	string	任意	ヘッダーのキー。キーは 1～40 文字の長さである必要があります。文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。 Cookie または Host にすることはできません。	Port
Values	array	任意	ヘッダー値。
	string	任意	HTTP ヘッダー値。同じ転送ルール条件でヘッダー値を同じにすることはできません。値は 1～128 文字の長さである必要があります。 ASCII 値が 32 から `127` までの印刷可能な文字、アスタリスク (*)、および疑問符 (?) を含めることができます。`"` を含めることはできません。値はスペースで開始または終了することはできません。値は `\` にすることはできません。	5006
HostConfig	object	任意	ホストの設定。
Values	array	任意	ホスト名。
	string	任意	ホスト名。転送ルール条件では 1 つのホスト名のみ指定できます。値は別のホスト名の値と同じにすることはできません。ホスト名は 3～128 文字の長さで、小文字、数字、ハイフン (-)、ピリオド (.)、アスタリスク ()、等号 (=)、チルダ (~)、アンダースコア (_)、プラス記号 (+)、バックスラッシュ (\)、サーカムフレックス (^)、感嘆符 (!)、ドル記号 ($)、アンパサンド (&)、縦棒 (\|)、丸括弧 (())、角括弧 ([])、および疑問符 (?) を含めることができます。ホスト名には少なくとも 1 つのピリオド (.) を含める必要があります。ピリオドは最初または最後の文字にすることはできません。一番右のドメインラベルには、文字とワイルドカードのみを含めることができます。数字やハイフン (-) を含めることはできません。一番左の `domainlable` はアスタリスク () にすることができます。ハイフン (-) はドメインラベルの最初または最後の文字にすることはできません。アスタリスク () と疑問符 (?) はドメインラベルのどこでも使用できます。完全一致およびワイルドカード一致の場合、値はチルダ (~) で始めることはできません。正規表現一致 (大文字と小文字を区別しない) の場合、値はアスタリスク () で始めることはできません。	www.example.edu
MethodConfig	object	任意	リクエストメソッドの設定。
Values	array	任意	リクエストメソッド。
	string	任意	リクエストメソッド。有効な値: HEAD、GET、POST、OPTIONS、PUT、PATCH、および DELETE。	PUT
PathConfig	object	任意	転送パスの設定。
Values	array	任意	転送パス。
	string	任意	転送パス。有効な値: パスは 1～128 文字の長さである必要があります。大文字と小文字が区別されます。ワイルドカード文字としてアスタリスク () と疑問符 (?) を含めることができます。 URL が正規表現でない場合、フォワードスラッシュ (/) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: `$-_.+/&~@:'?`。`"%#;!()[]^,"\"` を含めることはできません。ワイルドカード文字としてアスタリスク () と疑問符 (?) を含めることができます。 URL が正規表現である場合、チルダ (~) で始まる必要があります。文字、数字、および次の特殊文字を含めることができます: `.-_/=?~^$:()[]+\|`。	/test
QueryStringConfig	object	任意	クエリ文字列の設定。
Values	array	任意	クエリ文字列。
	object	任意	クエリ文字列。
Key	string	任意	クエリ文字列のキー。キーは 1～100 文字の長さである必要があります。印刷可能な文字、アスタリスク (*)、および疑問符 (?) を含めることができます。小文字のみを含める必要があります。スペースや次の特殊文字を含めることはできません: `#[]{}\\|<>&"`。	test
Value	string	任意	クエリ文字列の値。値は 1～128 文字の長さである必要があります。小文字、印刷可能な文字、アスタリスク (*)、および疑問符 (?) を含めることができます。スペースや次の特殊文字を含めることはできません: `#[]{}\\|<>&"`。	test
ResponseStatusCodeConfig	object	任意	応答ステータスコードの設定。
Values	array	任意	応答ステータスコード。
	string	任意	応答ステータスコード。	test
ResponseHeaderConfig	object	任意	ヘッダー条件の設定。
Key	string	任意	ヘッダーのキー。キーは 1～40 文字の長さである必要があります。文字、数字、ハイフン (-)、アンダースコア (_) を含めることができます。 Cookie または Host にすることはできません。	test
Values	array	任意	ヘッダー値。
	string	任意	ヘッダー値。値は 1～128 文字の長さである必要があります。 ASCII 値が 32 から `127` までの印刷可能な文字、小文字、アスタリスク (*)、および疑問符 (?) を含めることができます。`"` を含めることはできません。値はスペースで開始または終了することはできません。値は `\` にすることはできません。	50006
Type	string	必須	転送ルールのタイプ。有効な値: Host Path Header: HTTP ヘッダー。 QueryString Method: リクエストメソッド。 Cookie SourceIp: ソース IP アドレス。 ResponseHeader: 応答 HTTP ヘッダー。 ResponseStatusCode: 応答ステータスコード。	Host
SourceIpConfig	object	任意	ソース IP ベースのトラフィックマッチングの設定。このパラメーターは必須であり、Type が SourceIP に設定されている場合にのみ有効になります。
Values	array	任意	トラフィックマッチングのためのソース IP アドレス。
	string	任意	1 つ以上の IP アドレスまたは CIDR ブロック。	192.168.0.0/32
RuleName	string	必須	転送ルールの名前。名前は 2～128 文字の長さである必要があります。文字または漢字で始まり、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。	rule-doc
Tag	array<object>	任意	タグ。
	object	任意	タグ。
Key	string	任意	タグキー。タグキーは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。	env
Value	string	任意	タグ値。タグ値は最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。	product

レスポンスフィールド

フィールド	型	説明	例
	object	返されたデータ。
JobId	string	非同期タスクの ID。	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	リクエスト ID。	365F4154-92F6-4AE4-92F8-7FF34B540750
RuleId	string	転送ルールの ID。	rule-a3x3pg1yohq3lq****

例

成功レスポンス

JSONJSON

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540750",
  "RuleId": "rule-a3x3pg1yohq3lq****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	IncorrectStatus.Listener	The status of %s [%s] is incorrect.
400	OperationDenied.SameGroupForForwardAndMirrorAction	The operation is not allowed because of %s.
400	OperationDenied.IpGroupCanNotUsedForMirrorAction	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.Protocol	The %s is mismatched for %s and %s.
400	Mismatch.VpcId	The %s is mismatched for %s and %s.
400	OperationDenied.RewriteMissingForwardGroup	The operation is not allowed because of RewriteMissingForwardGroup.
400	ResourceInConfiguring.Listener	The specified listener is being configured, please try again later.
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.

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

変更履歴

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