导出过滤后的点
功能介绍
导出满足过滤条件的顶点集合。
URI
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
|
graph_name |
是 |
String |
图名称。 |
请求示例
（仅支持异步模式）导出满足过滤条件的顶点集合，导出路径为demo_movie/，导出文件名export_movie_and_user.csv。
POST https://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=export
{
"labels": [
"movies",
"user"
],
"vertexFilters": [
{
"propertyName": "Age",
"predicate": "=",
"values": [
"18-24"
]
}
],
"exportPath": "demo_movie/",
"fileName": "export_movie_and_user.csv",
"obsParameters": {
"accessKey": "XXXX",
"secretKey": "XXXX"
}
}
请求参数
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
labels |
labels和vertexFilters两者必选其一 |
String |
顶点类型过滤条件。 |
|
vertexFilters |
labels和vertexFilters两者必选其一 |
Json |
过滤条件，按属性过滤，JsonArray格式字符串。请参见表 vertexFilters参数结构。 |
|
exportPath |
是 |
String |
导出路径。 |
|
fileName |
否 |
String |
导出文件名。 |
|
obsParameters |
是 |
String |
OBS认证参数。请参见表 obsParameters参数说明。 |
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
propertyName |
是 |
String |
属性名称。 |
|
predicate |
是 |
String |
逻辑关系，可选值“=”、“<”、“>”、“<=”、“>=”、“range”、“has”“hasNot”。 |
|
values |
否 |
String |
属性的值。 |
|
type |
否 |
String |
过滤条件逻辑关系，可选值“and”和“or”，默认为“and”。 |
obsParameters，accessKey，secretKey在OBS场景下为必选参数，在HDFS场景下为非必选参数。
响应参数
|
参数 |
类型 |
说明 |
|---|---|---|
|
errorMessage |
String |
系统提示信息。
|
|
errorCode |
String |
系统提示信息。
|
|
jobId |
String |
查询边任务ID。
说明：
可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。 |
响应示例
状态码： 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 |
服务不可用。 |
错误码
请参见错误码。
