Adding a Backup (1.0.0)

Add a backup. If data in the current graph is incorrect or faulty, you can start the backup graph to restore the data.

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

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details about how to obtain a project ID, see Obtaining a Project ID. Constraints N/A Range The value can contain up to 64 characters. Only letters and digits are allowed. Default Value N/A
graph_id	Yes	String	Definition Graph ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. It is used to obtain the permission to call APIs. For how to obtain the token, see Authentication. (The token is the value of X-Subject-Token in the response header.) Constraints N/A Range N/A Default Value N/A

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
job_id	String	Definition ID of the graph backup job. Range N/A NOTE: You can view the job execution status and obtain the return result by querying the job ID. For details, see Task Center APIs.
backup_id	String	Definition Graph backup ID. Range N/A

Status code: 400

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

Add a graph backup.

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

{ }

Status code: 200

Example response for a successful request

{
  "job_id" : "ff8080815f9a3c84015f9a438ff70001"
  "backup_id":"0000b54f-2f1d-47a5-94bc-04f0d8a2e2db"
}

Status code: 404

Example response for a failed request

{
    "error_msg": "Cluster does not exist or has been deleted.",
    "error_code": "GES.0047"
}