动态拓展(temporal_bfs)
功能介绍
指定某个起始节点id,结合消息传递时间递增和BFS遍历顺序(Temporal BFS算法),搜索周围与之相关联的点,输出对应各节点的到达时间,以及与源起点之间的距离。
URL
POST /ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目编号。获取方法,请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母和数字组成,且长度为[1-64]个字符。 默认取值: 不涉及。 |
| graph_name | 是 | String | 图名称。 |
请求参数
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| algorithmName | 是 | String | 算法名称,取值为temporal_bfs。 |
| dynamicRange | 是 | String | 动态分析时间参数。 |
| parameters | 是 | String | 算法参数。 |
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| start | 是 | Date或Integer | 动态分析时间边界的开始时间。 |
| end | 是 | Date或Integer | 动态分析时间边界的结束时间。 |
| time_props | 是 | Object | 动态分析的时间属性定义。 |
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| stime | 是 | String | 动态图开始时间的属性名称。 |
| etime | 是 | String | 动态图结束时间的属性名称。 |
| 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| source | 是 | String | 起始节点id。 |
| k | 否 | Integer | 拓展深度,取值范围:1-100,默认值为3。 |
| directed | 否 | Boolean | 拓展方向,取值为true或false,默认值为true。 |
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| errorMessage | String | 系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误信息。 |
| errorCode | String | 系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误码。 |
| data | Json | 动态拓展的结果详情。 |
请求样例
指定起始节点id搜索周围与之相关联的点,算法名称为temporal_bfs,动态分析的开始时间为${startTime},结束时间为${endTime}。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis
{
"algorithmName":"temporal_bfs",
"dynamicRange":{
"start":"${startTime}",
"end":"${endTime}",
"time_props":{"stime":"${property(start_time)}","etime":"${property(start_time)}"}
},
"parameters":{
"source":""
}
} 响应示例
状态码: 200
成功响应示例
Http Status Code: 200
{
"data": {
"outputs": {
"data_return_size": 2,
"runtime": 0.000079,
"data_offset": 0,
"data_total_size": 2,
"temporal_bfs": [{
"Person00041": {
"arrive": 1646092800,
"dist": 0,
"predecessor": ""
}
}, {
"Place00001": {
"arrive": 1648306984,
"dist": 1,
"predecessor": "Person00041"
}
}]
}
}
} 状态码: 400
失败响应示例
Http Status Code: 400
{
"errorMessage":"${errorMessage}",
"errorCode":"GES.8301"
} 状态码
| 返回值 | 说明 |
|---|---|
| 400 Bad Request | 请求错误 |
| 401 Unauthorized | 鉴权失败 |
| 403 Forbidden | 没有操作权限 |
| 404 Not Found | 找不到资源 |
| 500 Internal Server Error | 服务内部错误 |
| 503 Service Unavailable | 服务不可用 |