动态群体演化(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 | 是 | Object | 算法参数。 |
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| 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 | 系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误码。 |
| status | 否 | String | 查询成功时返回任务状态,可选值为waiting,running,complete。查询失败时字段为空。 |
| data | 否 | Json | 算法运行的结果。查询失败时字段为空。 |
请求样例
观察某些节点群体结构的动态演化过程,算法名称为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":[],
}
} 响应示例
状态码: 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 | 服务不可用 |