Upgrading Kubernetes clusters

POST /v1/clusters/{cluster_ident}/actions/upgrade

Upgrade a Kubernetes cluster to a newer version.

Source: https://docs.openstack.org/api-ref/container-infrastructure-management/?expanded=upgrade-a-cluster-detail#upgrade-a-cluster

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