createLoadBalancerListener

VPC環境で利用できます。

概要

ロードバランサに新しいリスナーを作成します。

リクエスト

リクエストパラメータ

パラメータ名	要否	タイプ	制約事項	説明
regionCode	No	String		- リージョンコードロードバランサリスナーを作成するロードバランサインスタンスのリージョン(Region)を決定 regionCodeは、getRegionListアクションを通じて取得デフォルト：getRegionList照会結果の最初のリージョンを選択
loadBalancerInstanceNo	Yes	String		- ロードバランサインスタンス番号 loadBalancerInstanceNoは、getLoadBalancerInstanceListアクションを通じて取得
protocolTypeCode	Yes	String		- リスナーのプロトコルタイプコード選択したロードバランサのタイプに応じて使用可能なリスナープロトコルタイプの制限 `APPLICATION : HTTP / HTTPS` `NETWORK : TCP / UDP` `NETWORK_PROXY : TCP / TLS` UDPプロトコルはSGN(シンガポール)リージョンでのみ利用できる
port	Yes	Integer	最小： 1, 最大： 65534	- リスナーのポート過去に登録されたリスナーのポートと重複不可
targetGroupNo	Yes	String		- ターゲットグループ番号選択したターゲットグループはリスナーのデフォルトルールに適用他のロードバランサで使用中のターゲットグループは利用不可ロードバランサのタイプとターゲットグループのプロトコルタイプに応じて使用可能なターゲットグループが制限 `NETWORK : TCP / UDP` `NETWORK_PROXY : PROXY_TCP` `APPLICATION : HTTP / HTTPS` - targetGroupNoは、getTargetGroupListアクションを通じて取得
useHttp2	No	Boolean		- HTTP/2プロトコルの使用の有無オプション： true \| false デフォルト： false リスナーのプロトコルタイプがHTTPSである場合にのみ有効
sslCertificateNo	Conditional	String		- SSL証明書番号リスナーのプロトコルタイプがHTTPSまたはTLSである場合、SSL証明書の設定は必須 sslCertificateNoは、GET https://certificatemanager.apigw.ntruss.com/api/v1/certificatesアクションを通じて取得
tlsMinVersionTypeCode	No	String		- TLS最小サポートバージョンタイプコードリスナーのプロトコルタイプがHTTPSまたはTLSである場合にのみ有効オプション： `TLSV10 (TLSv1.0)` `TLSV11 (TLSv1.1)` `TLSV12 (TLSv1.2)` デフォルト： TLSV10
cipherSuiteList.N	No	List<String>		- 暗号スイートリストロードバランサがクライアントとの暗号化ネゴシエーションで提供する暗号化機能を選択リスナーのプロトコルタイプがHTTPS / TLSである場合にのみ指定できるオプション： `TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA` `TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256` `TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256` `TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA` `TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384` `TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384` `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA` `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256` `TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256` `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA` `TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384` `TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384` `TLS_RSA_WITH_AES_128_CBC_SHA` `TLS_RSA_WITH_AES_128_CBC_SHA256` `TLS_RSA_WITH_AES_128_GCM_SHA256` `TLS_RSA_WITH_AES_256_CBC_SHA` `TLS_RSA_WITH_AES_256_CBC_SHA256` `TLS_RSA_WITH_AES_256_GCM_SHA384` `TLS_DHE_RSA_WITH_AES_128_CBC_SHA` `TLS_DHE_RSA_WITH_AES_128_CBC_SHA256` `TLS_DHE_RSA_WITH_AES_256_CBC_SHA` `TLS_DHE_RSA_WITH_AES_256_CBC_SHA256` デフォルト： Select All
responseFormatType	No	String		- レスポンス結果のフォーマットタイプオプション： xml \| json デフォルト： xml

レスポンス

レスポンスデータのタイプ

LoadBalancerListenerListタイプ

LoadBalancerListenerList extends CommonResponse
private Integer totalRows;
private List loadBalancerListenerList = new ArrayList<>();

LoadBalancerListener
private String loadBalancerInstanceNo;
private String loadBalancerListenerNo;
private CommonCode protocolType;
private Integer port;
private Boolean useHttp2;
private String sslCertificateNo;
private CommonCode tlsMinVersionType;
private LoadBalancerRuleNoList loadBalancerRuleNoList;
private CipherSuiteList cipherSuiteList;

LoadBalancerRuleNoList
private List<String> loadBalancerRuleNoList = new ArrayList<>();

CipherSuiteList
private List<String> cipherSuiteList = new ArrayList<>();

例

リクエスト例

ncloud vloadbalancer createLoadBalancerListener --regionCode KR --loadBalancerInstanceNo ***887 --protocolTypeCode HTTP --port 80 --targetGroupNo ***095

レスポンス例

<createLoadBalancerListenerResponse>
  <requestId>55fc050c-3006-4472-bd96-2cb3b1547a53</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <loadBalancerListenerList>
    <loadBalancerListener>
      <loadBalancerInstanceNo>***887</loadBalancerInstanceNo>
      <loadBalancerListenerNo>***961</loadBalancerListenerNo>
      <protocolType>
        <code>HTTP</code>
        <codeName>HTTP protocol</codeName>
      </protocolType>
      <port>80</port>
      <useHttp2>false</useHttp2>
      <sslCertificateNo></sslCertificateNo>
      <tlsMinVersionType/>
      <loadBalancerRuleNoList>
        <loadBalancerRuleNo>***444</loadBalancerRuleNo>
      </loadBalancerRuleNoList>
      <cipherSuiteList/>
    </loadBalancerListener>
  </loadBalancerListenerList>
</createLoadBalancerListenerResponse>