createLoadBalancerInstance
- 印刷する
- PDF
createLoadBalancerInstance
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
VPC環境で利用できます。
ロードバランサインスタンスを作成します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
GET | /createLoadBalancerInstance |
リクエストヘッダ
Load Balancer APIで共通して使用されるヘッダの詳細は、Load Balancerの共通ヘッダをご参照ください。
リクエストクエリパラメータ
パラメータの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
regionCode | String | Optional | 作成するロードバランサインスタンスのリージョンコード
|
loadBalancerTypeCode | String | Required | ロードバランサのタイプ
|
loadBalancerName | String | Optional | ロードバランサの名前
|
loadBalancerNetworkTypeCode | String | Optional | ロードバランサのネットワークタイプ
|
throughputTypeCode | String | Optional | 負荷処理性能タイプ
|
idleTimeout | Integer | Optional | 接続維持時間(秒)
|
vpcNo | String | Required | 作成するロードバランサの VPC番号
|
loadBalancerDescription | String | Optional | ロードバランサの説明(Byte)
|
subnetNoList.N | List<String> | Conditional | サブネットの番号リスト
|
loadBalancerSubnetList.N.subnetNo | String | Conditional | サブネット番号
|
loadBalancerSubnetList.N.publicIpInstanceNo | String | Optional | グローバル IPアドレスインスタンス番号
|
loadBalancerListenerList.N.protocolTypeCode | String | Optional | ロードバランサリスナーのプロトコルタイプ
|
loadBalancerListenerList.N.port | Integer | Optional | ロードバランサリスナーのポート
|
loadBalancerListenerList.N.targetGroupNo | String | Required | 各リスナーの基本ルールに適用されるターゲットグループ番号
|
loadBalancerListenerList.N.useHttp2 | Boolean | Optional | HTTP/2プロトコルの使用有無
|
loadBalancerListenerList.N.sslCertificateNo | String | Conditional | SSL証明書番号
|
loadBalancerListenerList.N.tlsMinVersionTypeCode | String | Optional | TLSの最小サポートバージョン
|
loadBalancerListenerList.N.cipherSuiteList.N | List<String> | Optional | クライアントとの暗号化ネゴシエーション時にロードバランサが提供する暗号ツールリスト
|
responseFormatType | String | Optional | レスポンス結果の形式
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location 'https://ncloud.apigw.ntruss.com/vloadbalancer/v2/createLoadBalancerInstance
?regionCode=KR
&loadBalancerTypeCode=APPLICATION
&loadBalancerName=YOUR_LOAD_BALANCER
&loadBalancerNetworkTypeCode=PRIVATE
&throughputTypeCode=SMALL
&idleTimeout=60
&vpcNo=*****
&subnetNoList.1=******
&loadBalancerListenerList.1.protocolTypeCode=HTTP
&loadBalancerListenerList.1.port=80
&loadBalancerListenerList.1.targetGroupNo=*******'
--header 'x-ncp-apigw-timestamp: {Timestamp}'
--header 'x-ncp-iam-access-key: {Access Key}'
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの詳細は、LoadBalancerInstanceListをご参照ください。
レスポンスステータスコード
NAVERクラウドプラットフォームでで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
<createLoadBalancerInstanceResponse>
<requestId>48df95ef-b0bc-4338-bbc8-7126965c0987</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<loadBalancerInstanceList>
<loadBalancerInstance>
<loadBalancerInstanceNo>********</loadBalancerInstanceNo>
<loadBalancerInstanceStatus>
<code>INIT</code>
<codeName>LB INIT state</codeName>
</loadBalancerInstanceStatus>
<loadBalancerInstanceOperation>
<code>CREAT</code>
<codeName>LB CREATE OP</codeName>
</loadBalancerInstanceOperation>
<loadBalancerInstanceStatusName>Creating</loadBalancerInstanceStatusName>
<loadBalancerDescription></loadBalancerDescription>
<createDate>2024-06-03T18:52:28+0900</createDate>
<loadBalancerName>YOUR_LOAD_BALANCER</loadBalancerName>
<loadBalancerDomain>***.com</loadBalancerDomain>
<loadBalancerIpList/>
<loadBalancerType>
<code>APPLICATION</code>
<codeName>Application Load Balancer</codeName>
</loadBalancerType>
<loadBalancerNetworkType>
<code>PRIVATE</code>
<codeName>Private</codeName>
</loadBalancerNetworkType>
<throughputType>
<code>SMALL</code>
<codeName>Small</codeName>
</throughputType>
<idleTimeout>60</idleTimeout>
<vpcNo>*****</vpcNo>
<regionCode>KR</regionCode>
<subnetNoList>
<subnetNo>******</subnetNo>
</subnetNoList>
<loadBalancerSubnetList>
<loadBalancerSubnet>
<zoneCode>KR-1</zoneCode>
<subnetNo>******</subnetNo>
<publicIpInstanceNo></publicIpInstanceNo>
</loadBalancerSubnet>
</loadBalancerSubnetList>
<loadBalancerListenerNoList>
<loadBalancerListenerNo>******</loadBalancerListenerNo>
</loadBalancerListenerNoList>
</loadBalancerInstance>
</loadBalancerInstanceList>
</createLoadBalancerInstanceResponse>
この記事は役に立ちましたか?