Available in VPC
Add subnets to improve the network organization of the cluster and make it easier to manage securely.
Up to 5 subnets can be set up.
Requests
The following describes the request format for the endpoint. The request format is as follows.
| Method | URI |
|---|---|
| PATCH | /vnks/v2/clusters/{uuid}/add-subnet (Korea Region) |
| PATCH | /vnks/sgn-v2/clusters/{uuid}/add-subnet (Singapore Region) |
| PATCH | /vnks/jpn-v2/clusters/{uuid}/add-subnet (Japan Region) |
Request headers
For information about the headers common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service request headers.
Request path parameters
You can use the following path parameters with your request:
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
String | Required | Cluster's UUID |
Request syntax
The request syntax is as follows.
{
"subnets": [
{
"number": "Integer"
}
]
}
Request body
The following describes the request body.
| Field | Type | Required | Description |
|---|---|---|---|
subnets[] |
Array | Required | List of subnets to add |
subnets[].number |
Integer | Required | IDs of subnets to add
|
Request example
The following is a sample request.
curl --location --request PATCH 'https://nks.apigw.ntruss.com/vnks/v2/clusters/0000a20e-e0fb-4dc9-af1b-97fd3f8d0000/add-subnet' \
--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}' \
--data '{
"subnets": [
{
"number": 140000
}
]
}'
Responses
The following describes the response format.
Response body
The following describes the response body.
| 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 following is a sample response.
{
"uuid": "0000a20e-e0fb-4dc9-af1b-97fd3f8d0000"
}