Documentation Index

Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Cluster LB Subnetの変更

Prev Next

VPC環境で利用できます。

クラスタに設定したロードバランサのサブネットが削除された場合、新しいロードバランサのサブネットを設定します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
PATCH /vnks/v2/clusters/{uuid}/lb-subnet (韓国リージョン)
PATCH /vnks/sgn-v2/clusters/{uuid}/lb-subnet (シンガポールリージョン)
PATCH /vnks/jpn-v2/clusters/{uuid}/lb-subnet (日本リージョン)

リクエストヘッダ

Ncloud Kubernetes Service APIで共通して使用されるヘッダの詳細は、Ncloud Kubernetes Serviceのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
uuid String Required クラスタの UUID

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
lbSubnetNo Integer Conditional ロードバランサのサブネットインスタンス番号
  • lbSubnetNoListを入力しなかった場合、必ず入力
  • lbSubnetNoList入力時、無視される
lbSubnetNoList Array Conditional ロードバランサのサブネットインスタンス番号リスト
  • lbSubnetNoを入力しなかった場合、必ず入力
  • マルチゾーン構成の場合、ゾーンごとに1つずつ、最大2つまで入力 (異なるゾーンのサブネットのみ許可)
  • 同じパラメータの繰り返し(lbSubnetNoList=1000&lbSubnetNoList=2000)またはコンマで区切って(lbSubnetNoList=1000,2000)入力
  • 最初の値は、単一ゾーンロードバランサおよびネットワークロードバランサの代表サブネットとして使用される
igwYn String Optional Publicロードバランサのサブネットかどうか
  • Y | N (デフォルト)
    • Y: Publicロードバランサのサブネット
    • N: Privateロードバランサのサブネット

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request PATCH 'https://nks.apigw.ntruss.com/vnks/v2/clusters/****a20e-e0fb-4dc9-af1b-97fd3f8d****/lb-subnet?lbSubnetNo=140000' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

マルチゾーンロードバランサのサブネットに変更するリクエストのサンプルコードは次の通りです。

curl --location --request PATCH 'https://nks.apigw.ntruss.com/vnks/v2/clusters/****a20e-e0fb-4dc9-af1b-97fd3f8d****/lb-subnet?lbSubnetNoList=140000&lbSubnetNoList=141000' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
uuid String - クラスタの UUID

レスポンスステータスコード

Ncloud Kubernetes Service APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Kubernetes Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
}