Upgrading Kubernetes clusters
POST /v1/clusters/{cluster_ident}/actions/upgrade
Upgrade a Kubernetes cluster to a newer version.
Request
Parameters
| Name | In | Type | Description |
|---|---|---|---|
cluster_ident
|
path | string | The UUID or name of clusters in Magnum. |
cluster_template
|
body | UUID | The UUID of the cluster template. |
max_batch_size (Optional) |
body | integer | The max batch size each time when doing upgrade, default value is 1. |
nodegroup (Optional) |
body | string | The ID of node group. A node group is a subset of node instances within a cluster that all have the same configuration. |
Example
# curl -ks -X POST -H 'Content-Type: application/json' -H 'OpenStack-API-Version: container-infra 1.8' -H 'X-Auth-Token: gAAAAA<...>' -d '
{
"cluster_template": "b5093d08-f9fd-4a7c-8f69-8cfeb3710e4e",
"max_batch_size": 1
}' https://<node_IP_addr>:9513/v1/clusters/01d0583d-e8b3-483f-896f-08d2260b0dea/actions/upgrade
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
uuid
|
body | UUID | The UUID of the cluster. |
Status codes
Success
| Code | Reason |
|---|---|
202 - Accepted
|
Request was accepted for processing, but the processing has not been completed. A ‘location’ header is included in the response which contains a link to check the progress of the request. |
Error
| Code | Reason |
|---|---|
401 - Unauthorized
|
User must authenticate before making a request. |
403 - Forbidden
|
Policy does not allow current user to do this operation. |
404 - Not Found
|
The requested resource could not be found. |
409 - Conflict
|
This operation conflicted with another operation on this resource. |
Example
{
"uuid": "01d0583d-e8b3-483f-896f-08d2260b0dea"
}