更新时间：2025-12-19 GMT+08:00
清空图(2.1.1)
URI
POST /ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=clear-graph
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| project_id | 是 | String | 参数解释： 项目编号。获取方法，请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母和数字组成，且长度为[1-64]个字符。 默认取值： 不涉及。 |
| graph_name | 是 | String | 图名称。 |
请求参数
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| clearMetadata | 否 | Boolean | 是否需要清空schema数据，默认为false |
响应参数
| 参数 | 是否必选 | 说明 |
|---|---|---|
| errorMessage | 否 | 参数解释： 系统提示信息。
取值范围： 不涉及。 |
| errorCode | 否 | 参数解释： 系统提示信息。
取值范围： 不涉及。 |
| jobId | 否 | 执行该异步任务的jobId。 可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。 |
| jobType | Integer | 任务类型。请求失败时，该字段为空。 |
请求示例
进行清空图操作，需要清空schema数据。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/action?action_id=clear-graph
{
"clearMetadata": true
} 响应示例
状态码： 200
成功响应示例
Http Status Code: 200
{
"jobId": "c332e1d4-844c-4f75-beeb-e31d2c57f118000003836",
"jobType": 3
} 状态码： 400
失败响应示例
Http Status Code: 400
{
"errorMessage": "Not found. Please check the input parameters.",
"errorCode": "GES.8000"
} 状态码
| 返回值 | 说明 |
|---|---|
| 400 Bad Request | 请求错误。 |
| 401 Unauthorized | 鉴权失败。 |
| 403 Forbidden | 没有操作权限。 |
| 404 Not Found | 找不到资源。 |
| 500 Internal Server Error | 服务内部错误。 |
| 503 Service Unavailable | 服务不可用。 |
错误码
请参见错误码。
父主题： 图操作API
