更新时间:2025-03-13 GMT+08:00
批量点查
功能介绍
根据批量节点ID查询节点信息,返回这些节点的详情,包括标签和属性等。
URI
POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-query
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
|
graph_name |
是 |
String |
图名称。 |
请求参数
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
vertices |
是 |
String |
待查询的点ID数组。 |
响应参数
|
参数 |
类型 |
说明 |
|---|---|---|
|
errorMessage |
String |
系统提示信息。
|
|
errorCode |
String |
系统提示信息。
|
|
data |
Object |
查询成功时包含data字段,data字段中包含vertices查询结果。 |
|
result |
String |
查询结果。成功时值为success,失败时值为failed。 |
请求示例
根据批量节点ID查询节点信息。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-query
{
"vertices":
["0","1"]
}
响应示例
状态码: 200
成功响应示例
Http Status Code: 200
{
"data": {
"vertices": [
{
"id": "0",
"labels": [
"movie"
],
"properties": {
"movie": {
"movieid": [
0
],
"title": [
"American Beauty (1999)"
],
"genres": [
"Comedy|Drama"
]
}
}
},
{
"id": "51",
"labels": [
"user"
],
"properties": {
"user": {
"userid": [
5
],
"gender": [
"F"
],
"age": [
"56+"
],
"occupation": [
"homemaker"
],
"Zip-code": [
"46911"
]
}
}
}
]
},
"result": "success"
}
状态码: 400
失败响应示例
Http Status Code: 400
{
"errorMessage": "Bad Request, parameter vertices cannot be null",
"errorCode": "GES.8214",
"result": "failed"
}
状态码
|
返回值 |
说明 |
|---|---|
|
400 Bad Request |
请求错误。 |
|
401 Unauthorized |
鉴权失败。 |
|
403 Forbidden |
没有操作权限。 |
|
404 Not Found |
找不到资源。 |
|
500 Internal Server Error |
服务内部错误。 |
|
503 Service Unavailable |
服务不可用。 |
错误码
请参见错误码。
父主题: 点操作API
