HTTPS リスナーの設定を変更します。
操作説明
Classic Load Balancer (CLB) インスタンスが作成されていること。詳細については、「 CreateLoadBalancer 」を参照してください。
HTTPS リスナーが作成されていること。詳細については、「 CreateLoadBalancerHTTPSListener 」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
slb:SetLoadBalancerHTTPSListenerAttribute |
update |
acl
*certificate
*loadbalancer
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
任意 |
Classic Load Balancer (CLB) インスタンスのリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID を照会できます。 |
cn-hangzhou |
| LoadBalancerId |
string |
必須 |
Classic Load Balancer (CLB) インスタンスの ID。 |
lb-sjhfdji**** |
| ListenerPort |
integer |
必須 |
Classic Load Balancer (CLB) インスタンスが使用するフロントエンドポート。 有効な値: 1 ~ 65535。 |
80 |
| Bandwidth |
integer |
任意 |
リスナーのピーク帯域幅。単位: Mbit/s。 有効な値:
|
-1 |
| XForwardedFor |
string |
任意 |
|
on |
| Scheduler |
string |
任意 |
スケジューリングアルゴリズム。有効な値:
|
wrr |
| StickySession |
string |
任意 |
セッション維持を有効にするかどうかを指定します。有効な値:
|
on |
| StickySessionType |
string |
任意 |
Cookie をハンドルするメソッド。有効な値:
クライアントが初めて Server Load Balancer にアクセスすると、Server Load Balancer は応答に Cookie を挿入します (HTTP/HTTPS 応答に SERVERID を挿入)。次回、クライアントがこの Cookie を含むリクエストを送信すると、Server Load Balancer は以前に記録されたバックエンドサーバーにリクエストを転送します。
Server Load Balancer は、ユーザーがカスタム Cookie を定義していることを検出すると、元の Cookie を書き換えます。次回、クライアントが新しい Cookie を含むリクエストを送信すると、Server Load Balancer は以前に記録されたバックエンドサーバーにリクエストを転送します。 説明
このパラメーターは、StickySession が on に設定されている場合に必須です。 |
挿入 |
| CookieTimeout |
integer |
任意 |
Cookie のタイムアウト期間。 有効な値: 1 ~ 86400 (秒)。 説明
このパラメーターは、StickySession が on に設定され、StickySessionType が insert (挿入) に設定されている場合に必須です。 |
500 |
| Cookie |
string |
任意 |
サーバーで設定された Cookie。 値の長さは 1 ~ 200 文字で、ASCII 文字と数字のみを含めることができます。コンマ (,)、セミコロン (;)、またはスペースを含めることはできず、ドル記号 ($) で始めることはできません。 説明
このパラメーターは、StickySession が on に設定され、StickySessionType が server に設定されている場合に必須です。 |
testCookie |
| HealthCheck |
string |
任意 |
ヘルスチェックを有効にするかどうかを指定します。有効な値:
|
on |
| HealthCheckMethod |
string |
任意 |
HTTP ヘルスチェックで使用されるヘルスチェックメソッド。有効な値: head および get。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
get |
| HealthCheckDomain |
string |
任意 |
ヘルスチェックに使用されるドメイン名。有効な値:
説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
172.XX.XX.16 |
| HealthCheckURI |
string |
任意 |
ヘルスチェックに使用される URI。 値の長さは 1 ~ 80 文字で、文字、数字、ハイフン (-)、スラッシュ (/)、ピリオド (.)、パーセント記号 (%)、疑問符 (?)、ナンバー記号 (#)、およびアンパサンド (&) を含めることができます。URI はスラッシュ (/) のみを含めることはできませんが、スラッシュ (/) で始める必要があります。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
/test/index.html |
| HealthyThreshold |
integer |
任意 |
バックエンドサーバーが正常 (fail から success) と見なされるまでに必要な連続したヘルスチェック成功回数。 有効な値: 2 ~ 10。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
4 |
| UnhealthyThreshold |
integer |
任意 |
バックエンドサーバーが異常 (success から fail) と見なされるまでに必要な連続したヘルスチェック失敗回数。 有効な値: 2 ~ 10。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
4 |
| HealthCheckTimeout |
integer |
任意 |
ヘルスチェックからの応答を待機する時間。バックエンド ECS インスタンスが指定された時間内に応答しない場合、ヘルスチェックは失敗します。単位: 秒。有効な値: 1 ~ 300。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
3 |
| HealthCheckInterval |
integer |
任意 |
2 回の連続するヘルスチェックの間隔。単位: 秒。 有効な値: 1 ~ 50。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
5 |
| HealthCheckConnectPort |
integer |
任意 |
ヘルスチェックに使用されるポート。 有効な値: 1 ~ 65535。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
8080 |
| HealthCheckHttpCode |
string |
任意 |
ヘルスチェックの成功を示す HTTP ステータスコード。複数の HTTP ステータスコードはコンマ (,) で区切ります。 有効な値: http_2xx、http_3xx、http_4xx、および http_5xx。 説明
このパラメーターは、HealthCheck が on に設定されている場合にのみ効果があります。 |
http_2xx,http_3xx |
| ServerCertificateId |
string |
任意 |
サーバー証明書の ID。 |
idkp-123-cn-te**** |
| CACertificateId |
string |
任意 |
CA 証明書の ID。
|
139a00604ad-cn-east-**** |
| VServerGroup |
string |
任意 |
vServer グループを使用するかどうかを指定します。有効な値:
|
on |
| VServerGroupId |
string |
任意 |
vServer グループの ID。 |
rsp-cige6j**** |
| XForwardedFor_SLBIP |
string |
任意 |
|
on |
| XForwardedFor_SLBID |
string |
任意 |
|
on |
| XForwardedFor_proto |
string |
任意 |
|
on |
| Gzip |
string |
任意 |
特定のファイルタイプに対して
|
on |
| AclId |
string |
任意 |
リスナーにバインドされているアクセスコントロールリスト (ACL) の ID。 このパラメーターは、AclStatus が on に設定されている場合に必須です。 |
acl-a2do9e413e0spzasx**** |
| AclType |
string |
任意 |
アクセスの制御のタイプ。有効な値:
ホワイトリストが有効になっているが、コントロールポリシーグループに IP アドレスが追加されていない場合、SLB リスナーはすべてのリクエストを転送します。
ブラックリストが有効になっているが、コントロールポリシーグループに IP アドレスが追加されていない場合、SLB リスナーはすべてのリクエストを転送します。 説明
このパラメーターは、AclStatus が on に設定されている場合にのみ効果があります。 |
white |
| AclStatus |
string |
任意 |
アクセスの制御を有効にするかどうかを指定します。有効な値:
|
off |
| IdleTimeout |
integer |
任意 |
アイドル接続タイムアウト期間。有効な値: 1 ~ 60。単位: 秒。デフォルト値: 15。 指定されたタイムアウト期間中にアクセスリクエストが受信されない場合、Server Load Balancer は現在の接続を一時的に切断し、次のリクエストが到着したときに新しい接続を再確立します。 |
23 |
| RequestTimeout |
integer |
任意 |
リクエストタイムアウト期間。有効な値: 1 ~ 180。単位: 秒。デフォルト値: 60。 指定されたタイムアウト期間中にバックエンドサーバーから応答が受信されない場合、Server Load Balancer は待機を停止し、HTTP 504 エラーコードをクライアントに返します。 |
223 |
| EnableHttp2 |
string |
任意 |
|
off |
| TLSCipherPolicy |
string |
任意 |
HTTPS で利用可能な TLS プロトコルバージョンとサポートされている暗号化アルゴリズムスイートを含むセキュリティポリシー。
|
tls_cipher_ポリシー_1_2 |
| Description |
string |
任意 |
カスタムリスナー名。 名前の長さは 1 ~ 256 文字で、中国語の文字、英字、数字、ハイフン (-)、スラッシュ (/)、ピリオド (.)、およびアンダースコア (_) を含めることができます。 |
https_80 |
| XForwardedFor_SLBPORT |
string |
任意 |
|
off |
| XForwardedFor_ClientSrcPort |
string |
任意 |
|
off |
| DryRun |
boolean |
任意 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
CEF72CEB-54B6-4AE8-B225-F876FF7BA984 |
例
成功レスポンス
JSONJSON
{
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | ParamDuplicateError | The specified parameter value of XForwardedFor_ClientCertSubjectDNAlias is duplicate. Please change to a different one. | XForwardedFor_ClientCertClientVerifyAlias パラメーターが重複しています。 |
| 400 | IpVersionConflict | The ip version of this LoadBalancer and the Acl is conflict. | 指定された SLB インスタンスの IP バージョンは、ACL でサポートされている IP タイプと競合しています。 |
| 400 | InvalidParameter.IdleTimeout | The specified IdleTimeout exceeds the limit. | 指定された IdleTimeout が無効です。パラメーターの制約を確認し、修正後に再試行してください。 |
| 400 | InvalidParameter.RequestTimeout | The specified RequestTimeout exceeds the limit. | 指定された RequestTimeout は無効です。パラメーターの制約を確認して、再試行してください。 |
| 400 | ListenerForwardNotSupport | X-Forward-For is not supported to a ipv6 instance. | IPv6 SLB インスタンスは X-Forwarded-For をサポートしていません。 |
| 400 | InvalidParameter.RegionNotSupport | The region does not support the parameter: %s. | 指定されたパラメーターは、現在のリージョンではサポートされていません。 |
| 400 | InvalidParameter.SpecNotSupport | The loadBalancer of shared spec does not support the parameter: %s. | 指定されたパラメーターは、共有リソース SLB インスタンスではサポートされていません。 |
| 400 | OperationFailed.ServerGroupInUse | The VServerGroup or MasterSlaveServerGroup can not be close for this listener. | 現在のリスナーリストではサーバーグループの無効化がサポートされていないため、操作に失敗しました。 |
| 400 | InvalidParameter.VServerGroupId | The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener. | HTTP または HTTPS リスナーは、プライマリ/セカンダリサーバーグループをサポートしていません。 |
| 400 | MissingParam.HealthCheckDomain | The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1. | HealthCheckDomain パラメーターがありません。 |
| 400 | InvalidParameter.HealthCheckHttpVersion | The param HealthCheckHttpVersion is invalid. | 指定された HealthCheckHttpVersion が無効です。パラメーターの制約を確認し、修正後に再試行してください。 |
| 400 | Duplicated.AclEntry | %s. | %s |
| 400 | CertificateNotExist | The specified CertificateId does not exist. | 指定された証明書は存在しません。 |
| 400 | InvalidTLSPolicyId.NotExist | The specified TLS cipher policy does not exist. | 指定された TLS セキュリティポリシーは存在しません。 |
| 400 | TLSPolicyConfiguring | The specified TLS cipher policy is configuring. | 指定された TLSCipherPolicy は変更中です。 |
| 400 | TLSCipherPolicyVipRelationOverLimit | The number of listeners associated with a policy has exceeded. | リスナーに関連付けられている TLSCipherPolicy インスタンスの数がクォータ制限に達しました。 |
| 400 | TooManyCertificates | The number of certificates must not be greater than one. | 指定できる証明書の数は 1 つまでです。 |
| 400 | CertificateTypeMismatched | The certificate type does not match. | 指定された証明書のタイプが一致しません。 |
| 400 | MissingParam.ServerCertificates | Server certificates are required. | ServerCertificates パラメーターがありません。 |
| 400 | CnCertificateNotSupport | The cn certificate is not support. | 中国国密アルゴリズム (SM) 証明書はサポートされていません。 |
| 400 | InvalidParam.CertificateBindingType | The param CertificateBindingType is invalid. | 指定された CertificateBindingType は無効です。パラメーターの制約を確認し、修正してから再試行してください。 |
| 400 | InvalidParamSize.ServerCertificates | The size of param ServerCertificates is invalid. | 指定された ServerCertificates の長さは無効です。パラメーターの制約を確認して、再試行してください。 |
| 400 | TooManyCertificates.ServerCertificates | The number of certificates must not be greater than one. | 指定できる証明書の数は 1 つまでです。 |
| 400 | AclListenerOverLimit | This acl has reached the limit of binding to listeners. | 指定された ACL に関連付けられるリスナーの数がクォータ制限に達しました。 |
| 400 | QuotaLimitExceeds.AclAttachedToListener | The number of Acl bound listeners has reached the quota limit | ACL に関連付けられているリスナーの数がクォータ制限に達しました。 |
| 400 | QuotaLimitExceeds.TotalAclEntry | The number of Acl entries has reached the quota limit. | ACL エントリの数がクォータ制限に達しました。 |
| 400 | QuotaLimitExceeds.AclListenerOverLimit | This acl has reached the limit of binding to listeners. | 指定された ACL に関連付け可能なリスナーの数がクォータ制限に達しました。 |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | ドライランリクエストの検証に合格しました。 |
| 404 | ResourceNotFound.Certificate | The specified resource is not found. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。