Rotating a Node Certificate

Function

This API is used to rotate a node certificate in a cluster. It is a compensation mechanism for cluster certificate rotation. When certificate rotation is performed through the corresponding cluster certificate rotation API, if rotation fails on some nodes, you can call this API to retry the operation.

The URL for cluster management is in the format of https://Endpoint/uri, in which uri indicates the resource path, that is, the path for API access.

Constraints

The certificate of the cluster where the node is located has been rotated.
The node where the certificate rotation to be performed must be in the Running state.

Calling Method

For details, see Calling APIs.

URI

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/rotate-cert

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Details: Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Project IDs of the account Default value: N/A
cluster_id	Yes	String	Details: Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Cluster IDs Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Definition Type (or format) of the request body. The default value is application/json. Other values of this field will be provided for specific APIs, if any. Constraints GET requests are not validated. Default Value N/A
X-Auth-Token	Yes	String	Details: Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. Constraints: None Options: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
apiVersion	Yes	String	Definition API version Constraints The value is fixed and cannot be changed. Range N/A Default Value v3
kind	Yes	String	Definition API type Constraints The value is fixed and cannot be changed. Range N/A Default Value List
nodeList	Yes	Array of RotateCertNode objects	Definition List of nodes whose certificates need to be rotated. A maximum of 200 nodes can be rotated at a time. Constraints N/A Range N/A Default Value N/A

**Table 4** RotateCertNode
Parameter	Mandatory	Type	Description
nodeID	Yes	String	Definition Node ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

The node certificate rotation task has been delivered in the cluster.

None

Example Requests

Rotate a node certificate.

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/rotate-cert

{
  "kind" : "List",
  "apiVersion" : "v3",
  "nodeList" : [ {
    "nodeID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  } ]
}