転送ルールのターゲット VServer グループを変更します。

デバッグ

OpenAPI Explorer を使用して、デバッグ操作を実行し、SDK コード例を生成します。

リクエストパラメータ

パラメーター データ型 必須/省略可能 値の例 説明
Action String 必須 SetRule

この操作の名前です。

値: SetRule

RegionId String Yes cn-hangzhou

SLB インスタンスが属するリージョンの ID です。

リージョン ID を照会するには、DescribeRegions を呼び出します。

RuleId String 必須 rule-3ejhktkaeu

転送ルールの ID です。

VServerGroupId String 必須 rsp-cige6j5e7p

転送ルールのターゲット VServer グループの ID です。

Cookie String 省略可能 23ffsa

任意。 バックエンドサーバー上に設定されている Cookie です。

Cookie の長さは 1 文字から 200 文字以内で、ASCII 英字および数字のみ使用することができます。 コンマ ( , )、セミコロン ( ; )、スペースは使用できません。また、$ で始めることもできません。

このパラメータは、 StickySession[on]StickySessionType[server] の場合に設定されている場合のみ要求され有効になります。

CookieTimeout Integer 省略可能 123

任意。 Cookie のタイムアウト時間です。

値の範囲: 1 ~ 86400。 単位:秒

このパラメータは、StickySession[on]StickySessionType[insert] に設定されている場合のみ要求され有効になります。

HealthCheck String いいえ off

任意。 ヘルスチェック機能を有効にするかどうかを示します。

有効値: on | off

このパラメータは、 ListenerSync[off] に設定されている場合のみ要求され有効になります。
HealthCheckConnectPort Integer 省略可能 80

任意。 ヘルスチェックに使用されるポートです。

値の範囲: 1 ~ 65535

このパラメータは、HealthCheck[on] に設定されている場合に有効になります。
HealthCheckDomain String 省略可能 domain

任意。 ヘルスチェックに使用されるドメイン名です。 有効値:

  • $_ip:バックエンドサーバーのプライベート IP です。 $ _ip が指定されているか、HealthCheckDomain が指定されていない場合、SLB はヘルスチェックのドメイン名としてバックエンドサーバーのプライベート IP アドレスを使用します。
  • domain:ドメイン名の長さは 1~80 文字で、英字、数字、ピリオド ( . )、ハイフン ( - ) のみを含むことができます。
このパラメータは、HealthCheck[on] に設定されている場合に有効になります。
HealthCheckHttpCode String 省略可能 http_2xx

任意。 ヘルスチェックが正常であるかどうかを示す HTTP ステータスコードです。 コンマ ( , ) を使用して複数の HTTP 状況コードを区切ります。

このパラメータは、 HealthCheck[on] に設定されている場合に要求されます。

有効値: http_2xx | http_3xx | http_4xx | http_5xx。 デフォルト値:http_2xx

このパラメータは、HealthCheck[on] に設定されている場合に有効になります。
HealthCheckInterval Integer 省略可能 20

任意。 連続した 2 回のヘルスチェックの時間間隔です。

このパラメータは、HealthCheck[on] に設定されている場合に要求されます。

値の範囲: 1 ~ 50。 単位:秒

このパラメータは、HealthCheck[on] に設定されている場合に有効になります。
HealthCheckTimeout Integer 省略可能 20

任意。 ヘルスチェックからの応答を待機する時間 (秒単位)。 指定した時間内にバックエンド ECS インスタンスが正しくレスポンスしなかった場合、ヘルスチェックは失敗です。

このパラメータは、HealthCheck[on] にの場合にのみ必要および有効になります。

値の範囲: 1~ 300。 単位:秒

HealthCheckURI String 省略可能 /example

任意。 ヘルスチェックに使用される URI です。 このパラメータは HealthCheck[on] の場合にのみ必要および有効になります。

HealthyThreshold Integer 省略可能 12

任意。 バックエンドサーバーが正常だとみなされるまでの連続したヘルスチェックの回数 (失敗から 成功 へ)。

このパラメータは、HealthCheck[on] の場合にのみ必要および有効になります。

値の範囲: 2 ~ 10

ListenerSync String いいえ off

任意。 転送ルールがヘルスチェック、セッション持続性、およびスケジューリングアルゴリズムの設定をリスナーから継承するかどうかを示します。

有効値: on | off

  • off:ルールは、リスナーから継承するのではなく、ヘルスチェックとセッションの持続性の設定を習慣化します
  • on:ルールはリスナーから設定を継承します。
RuleName String 省略可能 doctest

任意。 転送ルール名です。 説明の長さは 1〜80 文字で、文字、数字、ハイフン ( - )、スラッシュ ( / )、ピリオド ( . )、アンダースコア ( _ ) を使用できます。

リスナーでは、各ルールの名前は一意である必要があります。
Scheduler String 省略可能 wrr

このパラメータは、ListenerSync[off] に設定されている場合に要求され有効になります。

任意: スケジューリングのアルゴリズム。 有効な値:

  • wrr (デフォルト):重みの大きいバックエンドサーバーは、重みの小さいバックエンドサーバーより多くのリクエストを受け取ります。
  • wlc:重みが大きいサーバーほど、多くのリクエストを受け取ります。 2 つのバックエンドサーバーの重み値が同じ場合は、接続数が少ないサーバーがポーリングされる可能性が高くなります。
  • rr:リクエストは、バックエンドサーバーに均等かつ順次に配信されます。
StickySession String いいえ off

このパラメータは、 ListenerSync[off] に設定されている場合に要求され有効になります。

任意。 セッション維持を有効にするかしないかを示します。 有効な値:on | off

StickySessionType String 省略可能 insert

任意: Cookie の処理するために使用される方法。 このパラメータは、StickySession[on]に設定されている場合に要求され有効になります。

有効値:

  • insert: Cookie の挿入。

    SLB はバックエンドサーバーからの最初のレスポンスに Cookie を追加します (HTTP/HTTPS レスポンスパケットに SERVERID を挿入します)。 次のリクエストには Cookie が含まれ、リスナーはリクエストを同じバックエンドサーバーに配信します。

  • server: Cookie の書き換え

    新しい Cookie が設定されると、SLB は元の Cookie を上書きします。 次回クライアントが新しい Cookie で SLB にアクセスすると、リスナーはそのリクエストを前回記録されたバックエンドサーバーに配信します。

UnhealthyThreshold Integer No 1

任意。 バックエンドサーバーが異常だとみなされるまでの連続したヘルスチェックの回数 (成功から失敗へ)。

このパラメータは、HealthCheck[on] の場合にのみ必要および有効になります。

値の範囲: 2 から10

応答パラメーター

パラメーター データ型 値の例 説明
RequestId String 9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C

リクエストの ID です。

リクエストの例


http(s)://[Endpoint]/? Action=SetRule
&RegionId=cn-hangzhou
&RuleId=rule-3ejhktkaeu
&<CommonParameters>

レスポンスの例

XML 形式

<SetRuleResponse>
  <RequestId>9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C</RequestId>
</SetRuleResponse>

JSON 形式

{
	"RequestId":"9DEC9C28-AB05-4DDF-9A78-6B08EC9CE18C"
}

エラーコード

一般的なエラーコードを参照してください。