文档首页/图引擎服务 GES/API参考/业务面API/内存版/边操作API/删除过滤后的边(2.2.7)
更新时间：2025-12-19 GMT+08:00
查看PDF
分享

删除过滤后的边(2.2.7)

功能介绍

删除满足过滤条件的边集合。

URI

POST /ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=delete

表1 路径参数

参数

是否必选

类型

说明

project_id

是

String

参数解释：

项目编号。获取方法，请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及。

graph_name

是

String

图名称。

请求参数

表2 Body参数说明

参数

是否必选

类型

说明

labels

labels和edgeFilters两者必选其一

String

关系类型过滤条件。

edgeFilters

labels和edgeFilters两者必选其一

String

过滤条件，按属性过滤，JsonArray格式字符串。

请参见edgeFilters参数结构。

响应参数

表3 响应Body参数

参数

类型

说明

errorMessage

String

参数解释：

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误信息。

取值范围：

不涉及。

errorCode

String

参数解释：

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误码。

取值范围：

不涉及。

jobId

String

查询边任务ID。

说明：

可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。

jobType

String

执行该异步任务的jobType。

请求示例

删除满足过滤条件的边集合（仅支持异步模式），关系类型过滤条件为rate，属性名称分别为Score和Datetime。 
POST https://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/edges/action?action_id=delete
  {
	"labels": [
		"rate"
	],
	"edgeFilters": [
		{
			"propertyName": "Score",
			"predicate": ">=",
			"values": [
				"2"
			]
		},
		{
			"propertyName": "Datetime",
			"predicate": "range",
			"values": [
				"1998-12-27 01:00:00",
				"2000-12-31 00:12:38"
			],
			"type": "or"
		}
	]
  }

响应示例

状态码： 200

成功响应示例 
Http Status Code: 200
{
  "jobId": "f9987cab-64d3-4b3d-ac43-e91ae0c21bef168127124",
  "jobType": 0
}

状态码： 400

失败响应示例 
Http Status Code: 400
{
"errorMessage":"Parameter error!",
"errorCode":"GES.8005"
}

状态码

回值

说明

400 Bad Request

请求错误。

401 Unauthorized

鉴权失败。

403 Forbidden

没有操作权限。

404 Not Found

找不到资源。

500 Internal Server Error

服务内部错误。

503 Service Unavailable

服务不可用。

错误码

请参见错误码。

父主题：边操作API