Clearing a Graph
Function
This API is used to clear all data in a graph.
URI
POST /v2/{project_id}/graphs/{graph_id}/clear-graph
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 |
Parameter | Mandatory | Type | Description |
---|---|---|---|
clear_metadata | No | Boolean | Whether to clear graph metadata. Set this parameter to true. The value can be true or false. The default value is false.
|
Request Parameters
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. |
Response Parameters
Status code: 200
Parameter | Type | Description |
---|---|---|
job_id | String | ID of an asynchronous job NOTE: You can view the job execution status and obtain the return result by querying the job ID. For details, see Job Management APIs. |
Status code: 400
Parameter | Type | Description |
---|---|---|
error_code | String | System prompt code.
|
error_msg | String | System prompt code.
|
Example Request
Clear all data in a graph.
POST http://Endpoint/v2/{project_id}/graphs/{graph_id}/clear-graph?clear_metadata=true{ }
Example Response
Status code: 200
Example response for a successful request
{"job_id" : "ff8080816025a0a1016025a5a2700007"}
Status code: 400
Example response for a failed request
{"error_msg" : "graph [demo] is not found","error_code" : "GES.8012"}
Status Code
Return Value | Description |
---|---|
400 Bad Request | Request error |
401 Unauthorized | Authorization failed |
403 Forbidden | No operation permissions |
404 Not Found | No resources found |
500 Internal Server Error | Internal server error |
503 Service Unavailable | Service unavailable |
Error Code
See Error Code.
- Function
- URI
- Request Parameters
- Response Parameters
- Example Request
- Example Response
- Status Code
- Error Code