Create cluster

Available in VPC

Create a new cluster based on the entered information.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
POST	/vnks/v2/clusters (Korea Region)
POST	/vnks/sgn-v2/clusters (Singapore Region)
POST	/vnks/jpn-v2/clusters (Japan Region)

Request headers

For information about the headers common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service request headers.

Request syntax

The request syntax is as follows:

{
  "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"
  },
  "authType": "String",
  "bootstrapAccessEntry": "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"
    }
  ]
}

Request body

You can include the following data in the body of your request:

Field	Type	Required	Description
`name`	String	Required	Cluster name 3 to 30 characters, including letters, numbers, and the special character "-", and must begin with an English letter and end with an English letter or number.
`clusterType`	String	Required	Cluster type XEN 10 EA: SVR.VNKS.STAND.C002.M008.NET.SSD.B050.G002 50 EA: SVR.VNKS.STAND.C004.M016.NET.SSD.B050.G002 KVM 250 EA: SVR.VNKS.STAND.C004.M016.G003
`k8sVersion`	String	Optional	Kubernetes version See Get supported K8s versions.
`loginKeyName`	String	Required	Authentication key name Enter the name of the authentication key you have.
`hypervisorCode`	String	Optional	Hypervisor type `XEN` (default) \| `KVM`
`regionCode`	String	Required	Region code See the getRegionList.
`zoneCode`	String	Conditional	Zone code Required if `zoneNo` is not entered See the getZoneList.
`zoneNo`	String	Conditional	Zone number Required if `zoneCode` is not entered See the getZoneList.
`publicNetwork`	Boolean	Optional	Subnet network type `true` \| `false` (default) `true`: public `false`: private
`vpcNo`	Integer	Required	Number of VPC where the cluster will be placed in See the console or the getVpcList.
`subnetNoList`	Array	Required	Subnet number list See the getSubnetList. If `publicNetwork` is false, enter the subnet ID of the general purpose private subnet. If `publicNetwork` if true, enter the subnet ID of the general purpose public subnet.
`subnetLbNo`	Integer	Conditional	@deprecated Private subnet number dedicated to load balancer See the getSubnetList.
`lbPrivateSubnetNo`	Integer	Conditional	Number of load balancer-only private subnet to apply to the cluster See the getSubnetList.
`lbPublicSubnetNo`	Integer	Required	Number of load balancer-only public subnet to apply to the cluster See the getSubnetList.
`log`	Object	Optional
`log.audit`	Boolean	Optional	Set audit log `true` \| `false` (default)
`authType`	String	Optional	Cluster authentication method `API` (default) \| `CONFIG_MAP`
`bootstrapAccessEntry`	Boolean	Optional	Whether to automatically create a bootstrap access entry when creating a cluster `true` (default) \| `false`
`kmsKeyTag`	String	Optional	Key Management Service's key tag See Key Management Service list.
`nodePool`	Array	Optional	List of NodePools to add: nodePool

`nodePool`

The following describes nodePool.

Field	Type	Required	Description
`name`	String	Optional	NodePool name
`nodeCount`	Integer	Optional	Number of nodes
`subnetNo`	Integer	Optional	@deprecated Subnet number
`subnetNoList`	Array	Optional	Subnet number Valid range: cluster subnetNoList
`softwareCode`	String	Optional	Server image code See the Get server image.
`productCode`	String	Optional	Service code Use only if hypervisorCode is XEN See the Get server specifications.
`labels`	Array	Optional	Node label list: labels
`taints`	Array	Optional	List of taints: taints
`serverSpecCode`	String	Optional	Server type Use only if hypervisorCode is KVM. See the Get server specifications.
`storageSize`	Integer	Optional	Storage size Use only for hypervisorCode KVM Valid range: 100 (default)-2000 GB
`serverRoleId`	String	Optional	ID to assign roles to NodePool servers See the console or the Get role list.
`fabricCluster`	Object	Conditional	Fabric cluster information Required when using server specifications that support Fabric clusters
`fabricCluster.poolName`	String	Conditional	Fabric cluster pool information Required when configuring Fabric cluster
`fabricCluster.poolNo`	Integer	Conditional	Fabric cluster pool number Required when configuring Fabric cluster

`labels`

The following describes labels.

Field	Type	Required	Description
`key`	String	Conditional	Label key Required when entering `nodePool.labels` English letters, numbers, and special characters "-", "_", "." are allowed, and the string must start and end with a English letter or number.
`value`	String	Conditional	Label value Required when entering `nodePool.labels` English letters, numbers, and special characters "-", "_", "." are allowed, and the string must start and end with a English letter or number.

`taints`

The following describes taints.

Field	Type	Required	Description
`key`	String	Conditional	Taint key Required when entering `nodePool.taints` English letters, numbers, and special characters "-", "_", "." are allowed, and the string must start and end with a English letter or number.
`value`	String	Optional	Taint value English letters, numbers, special characters "-", "_", "." are allowed, and the string must start and end with a English letter or number.
`effect`	String	Conditional	taint effect Required when entering `nodePool.taints` `NoSchedule` \| `PreferNoSchedule` \| `NoExecute`

Request example

The request example is as follows:

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"
      }
    ]
}'

Response

This section describes the response format.

Response syntax

The response syntax is as follows:

{
    "uuid": "String"
}

Response body

The response body includes the following data:

Field	Type	Required	Description
`uuid`	String	-	UUID of the cluster

Response status codes

For information about the HTTP status codes common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service response status codes.

Response example

The response example is as follows:

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