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.
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

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 code
Status Code	Code	Status Code Description
400	BadRequest	Invalid request. The client should not repeat the request without modifications.
404	NotFound	The requested resource cannot be found. The client should not repeat the request without modifications.
200	OK	The request is processed successfully.

Scaling Out a Cluster with Special Nodes

Function

URI

Request

Response

Examples

Status Code