Expanding a Graph (2.2.23)

This API is used to dynamically expand multiple secondary nodes to enable concurrent handling of increased read requests.

POST /v2/{project_id}/graphs/{graph_id}/expand

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
graph_id	Yes	String	Graph ID

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It is used to obtain the permission to call APIs. For details about how to obtain the token, see Authentication. The value of X-Subject-Token in the response header is the token.

**Table 3** Request body parameter
Parameter	Mandatory	Type	Description
expand	Yes	expand object	expand is an object.

**Table 4** expand
Parameter	Mandatory	Type	Description
replication	Yes	Integer	Number of new nodes to expand

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
job_id	String	ID of the expansion job. This parameter is left blank when the request fails. NOTE: You can view the job execution status and obtain the return result by querying the job ID. For details, see Task Center APIs.

Status code: 400

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	System prompt code. If execution succeeds, this parameter may be left blank. If execution fails, this parameter is used to display the error code.
error_msg	String	System prompt code. If execution succeeds, this parameter may be left blank. If execution fails, this parameter is used to display the error message.

Expand a graph. The number of new replicas is 1.

POST https://{Endpoint}/v2/{project_id}/graphs/{graph_id}/expand

{
    "expand":{
    "replication": 1
  }
}

Status code: 200

Example response for a successful request

{
  "job_id" : "ff8080816025a0a1016025a5a2700007"
}

Status code: 400

Example response for a failed request

{
  "error_code" : "GES.7015",
  "error_msg" : "The graph is not running or stopped."
}