Zheng, Xiu 99a2d77599 css api 23.5.1 20240520

Reviewed-by: Kacur, Michal <michal.kacur@t-systems.com>
Co-authored-by: Zheng, Xiu <zhengxiu@huawei.com>
Co-committed-by: Zheng, Xiu <zhengxiu@huawei.com>

2024-06-07 17:47:08 +00:00

14 KiB

Raw Blame History

Scaling Out a Cluster with Special Nodes

Function

This API is used to scale out a cluster with special nodes. That is, if a cluster has master, client, or cold data nodes, this API is used for scale-out.

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/role_extend

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.
cluster_id	Yes	String	ID of the cluster to be scaled out.

Request

Table 2 describes the request parameters.

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
grow	Yes	Array of object	Detailed description about the cluster scale-out request. For details, see Table 3.

**Table 3** **grow** field description
Parameter	Mandatory	Type	Description
type	Yes	String	Type of the instance to be scaled out. Select at least one from ess, ess-cold, ess-master, and ess-client. You can only add instances, rather than increase storage capacity, on nodes of the ess-master and ess-client types.
nodesize	Yes	Integer	Number of instances to be scaled out. The total number of existing instances and newly added instances in a cluster cannot exceed 32.
disksize	Yes	Integer	Storage capacity of the instance to be expanded. The total storage capacity of existing instances and newly added instances in a cluster cannot exceed the maximum instance storage capacity allowed when a cluster is being created. In addition, you can expand the instance storage capacity for a cluster for up to six times. Unit: GB

Response Parameters

Table 4 describes the response parameters.

**Table 4** Parameter description
Parameter	Type	Description
id	String	Cluster ID.

Examples

Example request

POST v1.0/458d905f22da49c39f609e3347d65723/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/role_extend
{
    "grow": [
        {
            "type": "ess-master",
            "nodesize": 2,
            "disksize": 0
        },
        {
            "type": "ess",
            "nodesize": 0,
            "disksize": 50
        },
        {
            "type": "ess-client",
            "nodesize": 1,
            "disksize": 0
        }
    ]
}

Example response

{
    "id": "4f3deec3-efa8-4598-bf91-560aad1377a3"
}

Status Code

Table 5 describes the status code.

**Table 5** Status codes
Status Code	Message	Description
400	BadRequest	Invalid request. Modify the request instead of retrying.
404	NotFound	The requested resource cannot be found. Modify the request instead of retrying.
200	OK	The request is processed successfully.

Parent topic: Cluster Management APIs

14 KiB Raw Blame History