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

:CreateLoadBalancerHTTPSListener

最終更新日:Mar 02, 2026

HTTPS リスナーを作成します。

操作説明

新しく作成されたリスナーは 停止中 の状態です。リスナーを作成した後は、StartLoadBalancerListener 操作を呼び出してリスナーを起動できます。リスナーが起動すると、トラフィックをバックエンドサーバーに転送できるようになります。

前提条件

Classic Load Balancer (CLB) インスタンスが作成済みである必要があります。詳細については、「CreateLoadBalancer」をご参照ください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

slb:CreateLoadBalancerHTTPSListener

create

*acl

acs:slb:{#regionId}:{#accountId}:acl/{#aclId}

*certificate

acs:slb:{#regionId}:{#accountId}:certificate/{#certificateId}

*loadbalancer

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

  • slb:tag
  • slb:tag
  • slb:tag
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

CLB インスタンスのリージョン ID です。

リージョン ID は、「リージョンとゾーン」の一覧または DescribeRegions 操作の呼び出しにより照会できます。

cn-hangzhou

LoadBalancerId

string

必須

CLB インスタンスの ID です。

lb-bp1o94dp5i6earr****

Bandwidth

integer

必須

リスナーの最大帯域幅です。単位:Mbit/s。

URL は以下の要件を満たす必要があります:

  • -1:トラフィック課金のインターネット向け CLB インスタンスの場合、このパラメーターは -1 に設定します。これは、リスナーの帯域幅が無制限であることを示します。

-1

ListenerPort

integer

必須

CLB インスタンスで使用されるフロントエンドポートです。

有効な値: 165535

80

BackendServerPort

integer

任意

CLB インスタンスで使用されるバックエンドポートです。有効な値: 165535

VServerGroupId パラメーターが設定されていない場合、このパラメーターは必須です。

80

Tag

array<object>

任意

タグです。

object

任意

タグです。

Key

string

任意

リソースのタグキーです。最大 20 個のタグキーを指定できます。

タグキーは空文字列にできません。長さは 1 ~ 64 文字で、aliyun または acs: で始めてはいけません。また、http://https:// を含めることはできません。

TestKey

Value

string

任意

リソースのタグ値です。最大 20 個のタグ値を指定できます。タグ値は空文字列にできません。

長さは最大 128 文字で、acs:aliyun で始めてはいけません。また、http://https:// を含めることはできません。

TestValue

XForwardedFor

string

任意

X-Forwarded-For ヘッダーを使用してクライアント IP アドレスを取得するかどうかを指定します。有効な値:

  • on

  • off

on

Scheduler

string

任意

スケジューリングアルゴリズムです。有効な値:

  • wrr:重みの高いバックエンドサーバーほど、より多くのリクエストを受信します。

  • rr:リクエストがバックエンドサーバーに順次分散されます。

wrr

StickySession

string

任意

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

  • on

  • off

on

StickySessionType

string

任意

Cookie を処理する方法です。有効な値:insert および server

  • insert:Cookie を挿入します。

    CLB は、クライアントに送信される最初の HTTP または HTTPS 応答パケットに Cookie(SERVERID)を挿入します。その後のクライアントからのリクエストにはこの Cookie が含まれており、リスナーはそのリクエストを記録されたバックエンドサーバーに配信します。

  • server:Cookie を再書き込みします。

    CLB がユーザー定義の Cookie を検出すると、元の Cookie をユーザー定義の Cookie で上書きします。その後のクライアントからのリクエストにはユーザー定義の Cookie が含まれており、リスナーはそのリクエストを記録されたバックエンドサーバーに配信します。

説明

StickySession パラメーターが on に設定されている場合、このパラメーターは必須です。

insert

CookieTimeout

integer

任意

Cookie のタイムアウト期間です。単位:秒。

有効な値: 186400

説明

StickySessionon に設定され、StickySessionTypeinsert に設定されている場合、このパラメーターは必須です。

500

Cookie

string

任意

サーバーに対して設定する Cookie です。

Cookie の長さは 1 ~ 200 文字で、ASCII 文字および数字のみを含むことができます。カンマ(,)、セミコロン(;)、空白文字を含めることはできず、ドル記号($)で始めてはいけません。

説明

StickySession パラメーターが on に設定され、StickySessionType パラメーターが server に設定されている場合、このパラメーターは必須です。

testCookie

HealthCheck

string

必須

ヘルスチェック機能を有効にするかどうかを指定します。有効な値:

  • on:有効

  • off:無効

on

HealthCheckMethod

string

任意

HTTP ヘルスチェックで使用されるヘルスチェック方法です。有効な値:head および get

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

get

HealthCheckDomain

string

任意

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

  • $_ip:バックエンドサーバーのプライベート IP アドレス。このパラメーターを設定しないか、$_ip に設定すると、CLB インスタンスは各バックエンドサーバーのプライベート IP アドレスを使用してヘルスチェックを行います。

  • domain:ドメイン名の長さは 1 ~ 80 文字で、英字、数字、ピリオド(.)、ハイフン(-)を含めることができます。

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

172.XX.XX.16

HealthCheckURI

string

任意

ヘルスチェックで使用される URI です。

URI の長さは 1 ~ 80 文字で、英字、数字、および以下の特殊文字(-/.%?#&)を含めることができます。先頭はスラッシュ(/)で始める必要がありますが、単一のスラッシュ(/)だけではいけません。

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

/test/index.html

HealthyThreshold

integer

任意

不健全なバックエンドサーバーが健全と見なされるまでに、連続してヘルスチェックに合格する必要がある回数です。この場合、ヘルスステータスは fail から success に変更されます。

有効な値: 210

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

4

UnhealthyThreshold

integer

任意

健全なバックエンドサーバーが不健全と見なされるまでに、連続してヘルスチェックに失敗する必要がある回数です。この場合、ヘルスステータスは success から fail に変更されます。

有効な値: 210

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

4

HealthCheckTimeout

integer

任意

ヘルスチェック応答のタイムアウト期間です。バックエンド ECS インスタンスが指定されたタイムアウト期間内に応答しない場合、その ECS インスタンスはヘルスチェックに失敗します。単位:秒。有効な値:1300

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

3

HealthCheckConnectPort

integer

任意

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

有効な値: 165535

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

8080

HealthCheckInterval

integer

任意

連続する 2 回のヘルスチェックの間隔です。単位:秒。

有効な値: 150

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

5

HealthCheckHttpCode

string

任意

ヘルスチェックが成功した場合の HTTP ステータスコードです。複数の HTTP ステータスコードをカンマ(,)で区切ります。

有効な値:http_2xxhttp_3xxhttp_4xxhttp_5xx

説明

HealthCheck パラメーターが on に設定されている場合にのみ、このパラメーターが有効になります。

http_2xx,http_3xx

ServerCertificateId

string

任意

サーバー証明書の ID です。

idkp-123-cn-test-****

VServerGroupId

string

任意

サーバーグループの ID です。

rsp-cige6j5e7p****

CACertificateId

string

任意

認証局(CA)証明書の ID です。

CA 証明書とサーバー証明書の両方がアップロードされている場合、相互認証が使用されます。

サーバー証明書のみがアップロードされている場合、片方向認証が使用されます。

139a00604ad-cn-east-hangzh****

XForwardedFor_SLBIP

string

任意

SLB-IP ヘッダーを使用してクライアントの仮想 IP アドレスを取得するかどうかを指定します。有効な値:

  • on

  • off

on

XForwardedFor_SLBID

string

任意

SLB-ID ヘッダーを使用して CLB インスタンスの ID を取得するかどうかを指定します。有効な値:

  • on

  • off

on

XForwardedFor_proto

string

任意

X-Forwarded-Proto ヘッダーを使用してリスナープロトコルを取得するかどうかを指定します。有効な値:

  • on

  • off

on

Gzip

string

任意

GZIP 圧縮を有効にして、特定の種類のファイルを圧縮するかどうかを指定します。有効な値:

  • on

  • off

on

AclId

string

任意

リスナーに関連付けられたネットワークアクセス制御リスト(ACL)の ID です。

説明

AclStatuson に設定されている場合、このパラメーターは必須です。

acl-a2do9e413e0spzasx****

AclType

string

任意

ネットワーク ACL のタイプです。有効な値:

  • white:ホワイトリスト。ネットワーク ACL 内の IP アドレスまたは CIDR ブロックからのリクエストのみが転送されます。ホワイトリストは、特定の IP アドレスからのみアプリケーションへのアクセスを許可したいシナリオに適用されます。ホワイトリストの構成が適切でない場合、サービスに悪影響を及ぼす可能性があります。ホワイトリストが構成された後は、ホワイトリストに追加された IP アドレスからのみリクエストがリスナーによって転送されます。

    ホワイトリストを有効化したが、ACL に IP アドレスを追加していない場合、リスナーはすべてのリクエストを転送します。

  • black:ブラックリスト。ネットワーク ACL 内の IP アドレスまたは CIDR ブロックからのすべてのリクエストが拒否されます。ブラックリストは、特定の IP アドレスからのアプリケーションへのアクセスを拒否したいシナリオに適用されます。

    リスナーにブラックリストが構成されているが、ブラックリストに IP アドレスが追加されていない場合、リスナーはすべてのリクエストを転送します。

説明

AclStatuson に設定されている場合、このパラメーターは必須です。

white

AclStatus

string

任意

アクセスの制御を有効にするかどうかを指定します。有効な値:

  • on:有効

  • off:無効

off

Description

string

任意

リスナーの名前です。

名前の長さは 1 ~ 256 文字で、英字、数字、ハイフン(-)、スラッシュ(/)、ピリオド(.)、アンダースコア(_)を含めることができます。

HTTPS_443

IdleTimeout

integer

任意

アイドル接続のタイムアウト期間です。有効な値:1 ~ 60。デフォルト値:15。単位:秒。

指定されたタイムアウト期間内にリクエストが受信されない場合、CLB は接続を閉じます。リクエストが受信されると、CLB は新しい接続を確立します。

12

RequestTimeout

integer

任意

リクエストのタイムアウト期間です。有効な値:1 ~ 180。デフォルト値:60。単位:秒。

指定されたタイムアウト期間内にバックエンドサーバーから応答が受信されない場合、CLB は HTTP 504 ステータスコードをクライアントに返します。

23

EnableHttp2

string

任意

HTTP/2 を有効にするかどうかを指定します。有効な値:

  • on:有効

  • off:無効

off

TLSCipherPolicy

string

任意

Transport Layer Security(TLS)セキュリティポリシーです。各セキュリティポリシーには、HTTPS で使用可能な TLS プロトコルバージョンおよび暗号スイートが含まれています。

  • tls_cipher_policy_1_0

    サポートされる TLS バージョン:TLS 1.0、TLS 1.1、TLS 1.2

    サポートされる暗号スイート:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA、DES-CBC3-SHA

  • tls_cipher_policy_1_1

    サポートされる TLS バージョン:TLS 1.1、TLS 1.2

    サポートされる暗号スイート:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA、DES-CBC3-SHA

  • tls_cipher_policy_1_2

    サポートされる TLS バージョン:TLS 1.2

    サポートされる暗号スイート:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、AES128-GCM-SHA256、AES256-GCM-SHA384、AES128-SHA256、AES256-SHA256、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA、AES128-SHA、AES256-SHA、DES-CBC3-SHA

  • tls_cipher_policy_1_2_strict

    サポートされる TLS バージョン:TLS 1.2

    サポートされる暗号スイート:ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA

  • tls_cipher_policy_1_2_strict_with_1_3

    サポートされる TLS バージョン:TLS 1.2、TLS 1.3

    サポートされる暗号スイート:TLS_AES_128_GCM_SHA256、TLS_AES_256_GCM_SHA384、TLS_CHACHA20_POLY1305_SHA256、TLS_AES_128_CCM_SHA256、TLS_AES_128_CCM_8_SHA256、ECDHE-ECDSA-AES128-GCM-SHA256、ECDHE-ECDSA-AES256-GCM-SHA384、ECDHE-ECDSA-AES128-SHA256、ECDHE-ECDSA-AES256-SHA384、ECDHE-RSA-AES128-GCM-SHA256、ECDHE-RSA-AES256-GCM-SHA384、ECDHE-RSA-AES128-SHA256、ECDHE-RSA-AES256-SHA384、ECDHE-ECDSA-AES128-SHA、ECDHE-ECDSA-AES256-SHA、ECDHE-RSA-AES128-SHA、ECDHE-RSA-AES256-SHA

tls_cipher_policy_1_1

XForwardedFor_SLBPORT

string

任意

XForwardedFor_SLBPORT ヘッダーを使用して CLB インスタンスのリスナーポートを取得するかどうかを指定します。有効な値:

  • on

  • off

off

XForwardedFor_ClientSrcPort

string

任意

XForwardedFor_ClientSrcPort ヘッダーを使用してクライアントポートを取得するかどうかを指定します。有効な値:

  • on

  • off

off

レスポンスフィールド

フィールド

説明

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.
400 IpVersionConflict The ip version of this LoadBalancer and the Acl is conflict.
400 InvalidParameter.IdleTimeout The specified IdleTimeout exceeds the limit.
400 InvalidParameter.RequestTimeout The specified RequestTimeout exceeds the limit.
400 ListenerForwardNotSupport X-Forward-For is not supported to a ipv6 instance.
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.
400 ListenerProcessing A previous configuration of the listener is pending,please try again later.
400 Certkey.Forbidden The specified certkey is not owned by the current user.
400 InvalidParameter.ListenerPortConflict There is conflict listener port exists.
400 ResourceNotAvailible.HttpsListener The specified Zone did not have enough resource.
400 AclNotExist Acl does not exist.
400 OperationUnsupported.CreateLoadBalancerLayer7Listener The slb instance does not support create HTTP or HTTPS listener.
400 InvalidParameter.VServerGroupId The MasterSlaveServerGroup can not be attached to HTTP or HTTPS listener.
400 MissingParam.HealthCheckDomain The HealthCheckDomain is required when HealthCheckHttpVersion is http1.1.
400 InvalidParameter.HealthCheckHttpVersion The param HealthCheckHttpVersion is invalid.
400 Duplicated.AclEntry %s.
400 CertificateNotExist The specified CertificateId does not exist.
400 OperationFailed.InsufficientResources The loadbalancer does not support this operation because of insufficient resources.
400 InvalidTLSPolicyId.NotExist The specified TLS cipher policy does not exist.
400 TLSPolicyConfiguring The specified TLS cipher policy is configuring.
400 TLSCipherPolicyVipRelationOverLimit The number of listeners associated with a policy has exceeded.
400 CertificateTypeMismatched The certificate type does not match.
400 MissingParam.ServerCertificates Server certificates are required.
400 TooManyCertificates The number of certificates must not be greater than one.
400 CnCertificateNotSupport The cn certificate is not support.
400 InvalidParam.CertificateBindingType The param CertificateBindingType is invalid.
400 InvalidParamSize.ServerCertificates The size of param ServerCertificates is invalid.
400 TooManyCertificates.ServerCertificates The number of certificates must not be greater than one.
400 SPEC_NOT_SUPPORT_PARAMETER Share spec does not support the feature.
400 LbNotSupportTcpssl You cannot create a TCP SSL type listener for the specified load balancer.
400 LbSupportTcpsslOnly The specified load balancer supports TCP SSL type listener only.
400 ListenerNotSupportRule You cannot create a rule for the specified listener.
400 Mismatch.SlbSpecTypeAndListenerProtocol The SlbSpecType and ListenerProtocol are mismatched.
400 InvalidParam.TagValue %s.
400 InvalidParam.TagKey %s.
400 SizeLimitExceeded.Tag %s.
400 MissingParam.TagKey The param MissingParam.TagKey is missing.
400 AclListenerOverLimit This acl has reached the limit of binding to listeners.
400 QuotaLimitExceeds.AclAttachedToListener The number of Acl bound listeners has reached the quota limit
400 QuotaLimitExceeds.TotalAclEntry The number of Acl entries has reached the quota limit.
400 QuotaLimitExceeds.AclListenerOverLimit This acl has reached the limit of binding to listeners.
404 ResourceNotFound.Certificate The specified resource is not found.

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

変更履歴

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