Clusterの作成
- 印刷する
- PDF
Clusterの作成
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
VPC環境で利用できます。
入力された情報で新規クラスタを作成します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
POST | /clusters |
リクエストヘッダ
Ncloud Kubernetes Service APIリクエストで共通して使用されるヘッダの詳細は、Ncloud Kubernetes Serviceの共通リクエストヘッダをご参照ください。
リクエスト構文
リクエスト構文は次の通りです。
{
"name": "String",
"clusterType": "String",
"k8sVersion": "String",
"loginKeyName": "String",
"hypervisorCode": "String",
"regionCode": "String",
"zoneCode": "String",
"zoneNo": "Integer",
"publicNetwork": "Boolean",
"kubeNetworkPlugin": "String",
"vpcNo": "Integer",
"subnetNoList": [
"Integer"
],
"subnetLbNo": "Integer",
"lbPrivateSubnetNo": "Integer",
"lbPublicSubnetNo": "Integer",
"log": {
"audit": "Boolean"
},
"kmsKeyTag": "String",
"nodePool": [
{
"name": "String",
"nodeCount": "Integer",
"subnetNo": "Integer",
"subnetNoList": [
"Integer"
],
"softwareCode": "String",
"productCode": "String",
"labels": [
{
"key": "String",
"value": "String"
}
],
"taints": [
{
"key": "String",
"value": "String",
"effect": "String"
}
],
"serverSpecCode": "String",
"storageSize": "Integer",
"serverRoleId": "String"
}
]
}
リクエストボディ
リクエストボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
name | String | Required | クラスタ名
|
clusterType | String | Required | クラスタのタイプ |
k8sVersion | String | Optional | Kubernetesバージョン
|
loginKeyName | String | Required | 認証キー名
|
hypervisorCode | String | Optional | ハイパーバイザコード
|
regionCode | String | Required | リージョンコード
|
zoneCode | String | Conditional | ゾーンコード
|
zoneNo | String | Conditional | ゾーン番号
|
publicNetwork | Boolean | Optional | サブネットネットワークタイプ
true : Publicfalse : Private |
vpcNo | Integer | Required | クラスタを配置する VPC番号
|
subnetNoList[] | Array | Required | サブネット番号リスト
|
subnetLbNo | Integer | Conditional | @deprecated ロードバランサ専用の Private Subnet番号
|
lbPrivateSubnetNo | Integer | Conditional | クラスタに適用するロードバランサ専用の Private Subnet番号
|
lbPublicSubnetNo | Integer | Required | クラスタに適用するロードバランサ専用の Public Subnet番号
|
log | Object | Optional | |
log.audit | Boolean | Optional | Audit Logを設定
|
kmsKeyTag | String | Optional | Key Management Serviceの Key Tag |
nodePool[] | Array | Optional | 追加するノードプールリスト |
nodePool[].name | String | Optional | ノードプール名 |
nodePool[].nodeCount | Integer | Optional | ノード数 |
nodePool[].subnetNo | Integer | Optional | @deprecated サブネット番号 |
nodePool[].subnetNoList[] | Array | Optional | サブネット番号
|
nodePool[].softwareCode | String | Optional | サーバイメージコード
|
nodePool[].productCode | String | Optional | サービスタイプ
|
nodePool[].labels[] | Array | Optional | ノードラベルリスト |
nodePool[].labels[].key | String | Conditional | ラベルのキー
|
nodePool[].labels[].value | String | Conditional | ラベルの値
|
nodePool[].taints[] | Array | Optional | taintリスト |
nodePool[].taints[].key | String | Conditional | taintのキー
|
nodePool[].taints[].value | String | Optional | taintの値
|
nodePool[].taints[].effect | String | Conditional | taintの効果
|
nodePool[].serverSpecCode | String | Optional | サーバタイプ
|
nodePool[].storageSize | Integer | Optional | ストレージ容量
|
nodePool[].serverRoleId | String | Optional | ノードプールサーバのロールを付与するための ID
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request POST 'https://nks.apigw.ntruss.com/vnks/v2/clusters' \
--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}' \
--header 'Content-Type: application/json'
--data '{
"name": "String",
"clusterType": "String",
"k8sVersion": "String",
"loginKeyName": "String",
"hypervisorCode": "String",
"regionCode": "String",
"zoneCode": "String",
"zoneNo": "Integer",
"publicNetwork": "Boolean",
"kubeNetworkPlugin": "String",
"vpcNo": "Integer",
"subnetNoList": [
"Integer"
],
"subnetLbNo": "Integer",
"lbPrivateSubnetNo": "Integer",
"lbPublicSubnetNo": "Integer",
"log": {
"audit": "Boolean"
},
"nodePool": [
{
"name": "String",
"nodeCount": "Integer",
"subnetNo": "Integer",
"subnetNoList": [
"Integer"
],
"softwareCode": "String",
"productCode": "String",
"labels": [
{
"key": "String",
"value": "String"
}
],
"taints": [
{
"key": "String",
"value": "String",
"effect": "String"
}
],
"serverSpecCode": "String",
"storageSize": "Integer",
"serverRoleId": "String"
}
]
}'
レスポンス
レスポンス形式を説明します。
レスポンス構文
レスポンス構文は次の通りです。
{
"uuid": "String"
}
レスポンスボディ
レスポンスボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
uuid | String | - | クラスタの UUID |
レスポンスステータスコード
Ncloud Kubernetes Service APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Kubernetes Serviceのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"uuid": "****a20e-e0fb-4dc9-af1b-97fd3f8d****"
}
この記事は役に立ちましたか?