Available in VPC
Upgrade Kubernetes on a specific cluster to a new version.
Requests
The following describes the request format for the endpoint. The request format is as follows.
| Method | URI |
|---|---|
| PATCH | /clusters/{uuid}/upgrade |
Request headers
For headers common to all Ncloud Kubernetes Service APIs, see Ncloud Kubernetes Service common request headers.
Request path parameters
The following describes the parameters.
| Field | Type | Required | Description |
|---|---|---|---|
uuid |
String | Required | Cluster's UUID
|
Request query parameters
The following describes the parameters.
| Field | Type | Required | Description |
|---|---|---|---|
k8sVersion |
String | Required |
|
maxSurge |
Integer | Optional | |
maxUnavailable |
Integer | Optional |
Request example
The following is a sample request.
curl --location --request PATCH 'https://nks.apigw.ntruss.com/vnks/v2/clusters/00000a09-ce1e-475c-99e5-da1f03200000/upgrade?k8sVersion=1.27.9-nks.1&maxSurge=100&maxUnavailable=100' \
--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}'
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 response 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": "00000a09-ce1e-475c-99e5-da1f03200000"
}