删除过滤后的点(2.2.7)
功能介绍
删除满足过滤条件的顶点集合。
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
graph_name |
是 |
String |
图名称。 |
URI
POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=delete
请求参数
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
labels |
labels和vertexFilters两者必选其一 |
String |
顶点类型过滤条件。 |
vertexFilters |
labels和vertexFilters两者必选其一 |
Object |
过滤条件，按属性过滤，JsonArray格式字符串。 |
begin |
否 |
Integer |
可针对一段范围的点进行过滤，begin指定开始游标，范围是0 - uint32_MAX，默认值为0。 |
end |
否 |
Integer |
可针对一段范围的点进行过滤，end指定结束游标，范围是0 - uint32_MAX，默认值为uint32_MAX。 说明：如果begin和end不设置，默认对全图进行过滤；业务可根据自身情况调整end - begin的值（比如1000w）； |
limit |
否 |
Integer |
被删除点数量的最大值，默认删除全部满足条件的点 |
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
propertyName |
propertyName和degree两者必选其一 |
String |
属性名称。 |
predicate |
是 |
String |
逻辑关系，可选值“=”、“<”、“>”、“<=”、“>=”、“range”、“has”“hasNot”、“full_text_match”、“full_text_prefix”、“full_text_wildcard”、“full_text_regexp”、“full_text_fuzzy”和 “full_text_combination”。 |
values |
否 |
String |
属性的值或点的度的值。当predicate为full_text_combination时，values类型不是string |
type |
否 |
String |
过滤条件逻辑关系，可选值“and”和“or”，默认为“and”。 |
degree（2.4.0） |
propertyName和degree两者必选其一 |
String |
点的度，可选in、out、both。 对应的predicate支持“=”、“<”、“>”、“<=”、“>=”、“!=”。 |
响应参数
参数 |
类型 |
说明 |
|---|---|---|
errorMessage |
String |
系统提示信息。
|
errorCode |
String |
系统提示信息。
|
jobId |
String |
查询节点任务ID。请求失败时字段为空。
说明：
可以查询jobId查看任务执行状态、获取返回结果，详情参考查询Job状态(1.0.0)-业务面。 |
请求示例
POST https://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=delete
{
"labels": [
"movies",
"user"
],
"vertexFilters": [
{
"propertyName": "Age",
"predicate": "=",
"values": [
"18-24"
]
}
]
}
响应示例
状态码： 200
成功响应示例
Http Status Code: 200
{
"jobId": "03e774f5-29ea-4187-9508-5435f3892ead016886200",
"jobType": 1
}
状态码： 400
失败响应示例
Http Status Code: 400
{
"errorMessage": "Bad Request, parameter labels and vertexFilters cannot all be null",
"errorCode": "GES.8203"
}
状态码
返回值 |
说明 |
|---|---|
400 Bad Request |
请求错误。 |
401 Unauthorized |
鉴权失败。 |
403 Forbidden |
没有操作权限。 |
404 Not Found |
找不到资源。 |
500 Internal Server Error |
服务内部错误。 |
503 Service Unavailable |
服务不可用。 |
错误码
请参见错误码。
