文档首页/ 图引擎服务 GES/ API参考/ 业务面API/ 持久化版/ HyG图管理API/ 创建HyG图
更新时间：2024-05-23 GMT+08:00
查看PDF
分享

创建HyG图

功能介绍

创建一个HyG图。

  • GES持久化版的图计算依赖于HyG引擎，在执行算法之前需要创建HyG图，并将图数据库的数据同步到HyG引擎。
  • HyG组件当前通过白名单开放，请通过提交工单的方式申请。

URI

POST /ges/v1.0/{project_id}/hyg/{graph_name}
表1 路径参数

参数

是否必选

类型

说明

project_id

是

String

项目ID。获取方法请参见获取项目ID。

graph_name

是

String

图名称。

请求参数

表2 Body参数说明

参数

是否必选

类型

说明

policy

否

String

指定图切分策略，目前支持oec策略，默认是oec策略。

inEdge

否

Boolean

图是否包含入边，默认为false，设置为true会影响数据同步性能。

对于部分算法，如果不包含入边，算法可能会性能下降或者报错，例如算法：shortest_path、sssp、k_hop，详情请查阅对应的算法参数说明。

响应参数

表3 响应Body参数说明

参数

类型

说明

errorMessage

String

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误信息。

errorCode

String

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误码。

result

String

执行结果。

  • 成功时，result值为success。
  • 失败时，result值为failed。

请求示例

创建HyG图，图切分策略为oec策略，图包含入边。 
POST http://{SERVER_URL}/ges/v1.0/{project_id}/hyg/{graph_name}
{
    "policy": "oec",
    "inEdge": true
}

SERVER_URL：图的访问地址，取值请参考业务面API使用限制。

响应示例

状态码： 200

成功响应示例

Http Status Code: 200
{
   "result": "success"
 }

状态码： 400

失败响应示例

Http Status Code: 400
{
    "errorCode": "GES.8011",
    "errorMessage": "graph : movie2 is not exist"
}

状态码

返回值

说明

400 Bad Request

请求错误。

401 Unauthorized

鉴权失败。

403 Forbidden

没有操作权限。

404 Not Found

找不到资源。

500 Internal Server Error

服务内部错误。

503 Service Unavailable

服务不可用。

错误码

请参见错误码。

父主题： HyG图管理API