动态群体演化(temporal_graph)
功能介绍
针对包含某些节点的群体,结合时间轴观察其结构的动态演化过程 。
URL
POST /ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis
参数 |
是否必选 |
类型 |
说明 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
graph_name |
是 |
String |
图名称。 |
请求参数
参数 |
是否必选 |
类型 |
说明 |
---|---|---|---|
algorithmName |
是 |
String |
算法名称。 |
dynamicRange |
是 |
Object |
动态分析时间参数。 |
parameters |
是 |
String |
算法参数。 |
参数 |
是否必选 |
类型 |
说明 |
---|---|---|---|
start |
是 |
Date或Integer |
动态分析时间边界的开始时间。注意:start <= end |
end |
是 |
Date或Integer |
动态分析时间边界的结束时间。 |
time_props |
是 |
Object |
动态分析的时间属性定义。 |
参数 |
是否必选 |
类型 |
说明 |
---|---|---|---|
stime |
是 |
String |
动态图开始时间的属性名称。 |
etime |
是 |
String |
动态图结束时间的属性名称。 |
参数 |
是否必选 |
类型 |
说明 |
---|---|---|---|
source |
是 |
String |
群体内包含的节点id,最多输入100000个节点。 |
temporal_vertex |
否 |
Boolean |
是否对节点执行群体演化,默认为false。 |
响应参数
参数 |
类型 |
说明 |
---|---|---|
errorMessage |
String |
系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误信息。 |
errorCode |
String |
系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误码。 |
jobId |
String |
查询边任务ID。
说明:
可以查询jobId查看任务执行状态、获取返回结果,详情参考Job管理API。 |
jobType |
String |
执行该异步任务的jobType。 |
请求样例
观察某些节点群体结构的动态演化过程,算法名称为temporal_graph,动态分析的开始时间为${startTime},结束时间为${endTime}。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis { "algorithmName":"temporal_graph", "dynamicRange":{ "start":"${startTime}", "end":"${endTime}", "time_props":{"stime":"${property(start_time)}","etime":"${property(start_time)}"} }, "parameters":{ "sources":[], "temporal_vertex":false } }
响应示例
状态码: 200
响应成功示例
{ "jobId": "f9987cab-64d3-4b3d-ac43-e91ae0c21bef168127124", "jobType": 0 }
状态码: 400
响应失败示例
{ "errorMessage":"${errorMessage}", "errorCode":"GES.8301" }
状态码
返回值 |
说明 |
---|---|
400 Bad Request |
请求错误 |
401 Unauthorized |
鉴权失败 |
403 Forbidden |
没有操作权限 |
404 Not Found |
找不到资源 |
500 Internal Server Error |
服务内部错误 |
503 Service Unavailable |
服务不可用 |