本文导读

展开导读

文档首页/ 图引擎服务 GES/ API参考/ 历史API/ 管理面API（V1）/ 图管理API/ 创建图(2.2.2)

创建图(2.2.2)

更新时间：2025-01-03 GMT+08:00

查看PDF

功能介绍

创建一个图。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v1.0/{project_id}/graphs

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参见获取项目ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

表3 请求Body参数
参数	是否必选	参数类型	描述
graph	是	graph object	图类型。

表4 graph
参数	是否必选	参数类型	描述
name	是	String	图名称（输入长度在4位到50位之间，必须以字母开头，可以包含字母、数字或者下划线，不能包含其他的特殊字符）。
graphSizeTypeIndex	是	String	图规模类型索引。 0：一万边 1：百万边 2：千万边 3：一亿边 4：十亿边 5：百亿边 6：持久化版 401：十亿增强边
arch	否	String	图实例CPU架构类型，取值为x86_64和aarch64。默认取x86_64。 x86_64：X86 64位架构。 aarch64：ARM 64位架构。
vpcId	是	String	虚拟私有云ID。
subnetId	是	String	指定虚拟私有云下的子网ID。
securityGroupId	是	String	安全组ID。
publicIp	否	publicIp object	公网IP地址，如果未指定，则默认不使用公网连接。
enableMultiAz	否	Boolean	创建的图是否支持跨可用区（AZ），默认值是false，如果设置为true，系统将会把图中的ECS建在两个可用区中。如果创建图时，不加该参数，则会将图中的ECS都建在一个可用区中。
ltsOperationTrace	否	ltsOperationTraceReq object	图实例是否开启审计日志，默认不开启。
sys_tags	否	Array of SysTagsRes objects	企业项目信息，如果未指定则不开启，默认不开启。
tags	否	Array of SysTagsRes objects	支持标签TMS，做费用归集，默认不开启。
enableRBAC	否	Boolean	创建的图是否启用细粒度权限控制，默认不启用，值为false。如果设置为true，创建的图所有用户都没有权限，需要调用业务面细粒度权限控制API进行授权操作才可以访问图。
enableFullTextIndex	否	Boolean	创建的图是否开启全文索引控制，默认不启用，值为false。如果设置为true，十亿增强版-规格版图支持全文索引，创建图时会创建云搜索服务集群。说明：开启全文索引功能。如果CSS服务已经部署，图实例会自动创建CSS集群，图创建时间较长。如果CSS服务没有部署则图创建失败。
enableHyG	否	Boolean	该参数只对持久化版规格图生效。
cryptAlgorithm	是	String	图实例加密算法，取值为： generalCipher：国密算法 SMcompatible：商密算法（兼容国际）
enableHttps	是	Boolean	是否开启安全模式，开启安全模式会对性能有较大影响
tags	否	JsonArray	标签列表，每个标签用<key,value>键值对表示。

表5 parameters
参数	是否必选	参数类型	描述
schemaPath	是	String	元数据文件OBS路径，只支持文件。
edgesetPath	是	String	边数据集文件OBS路径，只支持文件。
edgesetFormat	否	String	边数据集格式。当前仅支持csv。默认为csv。
edgesetDefaultLabel	否	String	边数据集默认标签，当前默认为空，可以不填。
vertexsetPath	否	String	点数据集OBS路径，只支持文件。
vertexsetFormat	否	String	点数据集格式。当前仅支持csv。默认为csv。
vertexsetDefaultLabel	否	String	点数据集默认标签，当前默认为空，可以不填。
logDir	否	String	OBS日志存储目录，用于存储建图过程导入失败的数据和详细日志。
parallelEdge	否	parallelEdge object	重复边处理。

说明：

schemaPath、edgesetPath、vertexsetPath、logDir字符串取值合法性参考OBS对象名约束。

表6 parallelEdge
参数	是否必选	参数类型	描述
action	否	String	处理方式，取值为allow，ignore和override，默认为allow。 allow表示允许重复边。 ignore表示忽略之后的重复边。 override表示覆盖之前的重复边。
ignoreLabel	否	Boolean	重复边的定义，是否忽略Label。取值为true或者false，默认取true。 true 表示重复边定义不包含Label，即用<源点，终点>标记一条边，不包含Label。 false 表示重复边定义包含Label，即用<源点，终点，Label>标记一条边。

表7 publicIp
参数	是否必选	参数类型	描述
publicBindType	否	String	弹性IP绑定类型，取值如下。 auto_assign：自动绑定。 bind_existing：使用已有。
eipId	否	String	弹性IP的id。当publicBindType设置为bind_existing时，该值为用户某个已创建但尚未绑定的EIP的ID。当publicBindType设置为auto_assign时，该值设置为空。

表8 ltsOperationTraceReq
参数	是否必选	参数类型	描述
enableAudit	否	Boolean	是否开启图审计，取值为“true”或者“false”。默认为“false”。
auditLogGroupName	否	String	LTS日志组名称。

表9 SysTagsRes
参数	是否必选	参数类型	描述
key	否	String	企业项目的key值，需要填：_sys_enterprise_project_id。
value	否	String	企业项目的id。可以从企业项目获取。

响应参数

状态码： 200

**表10** 响应Body参数
参数	参数类型	描述
id	String	图ID。
name	String	图名称。
errorMessage	String	系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误信息。
errorCode	String	系统提示信息。执行成功时，字段可能为空。执行失败时，用于显示错误码。

请求示例

POST https://Endpoint/v1.0/{project_id}/graphs
{
    "graph":{
        "name":"demo",
        "graphSizeTypeIndex": "1",
        "arch":"x86_64",
        "vpcId":"2d8af840-fd57-4e3b-a8f1-cda0f55ccd99",
        "subnetId":"dc018ec3-67d1-46c9-b2fc-19d83367f4e2",
        "securityGroupId":"11d27338-8649-4076-8579-5ebc1a60f79e",
        "publicIp":{
           "publicBindType":"bind_existing",
           "eipId":"30ef2d58-08a9-4481-b526-b2cbe67d020d"
        },
        "enableMultiAz":false,
        "sys_tags": [{"key": "_sys_enterprise_project_id",                        "value": "54c0b33c-8627-462f-948e-bae08c0887b4"}],
        "enableRBAC":false,
        "enableFullTextIndex" : false, 
        "cryptAlgorithm": "generalCipher",
        "enableHttps": "false"
    }
}

响应示例

状态码： 200

{
  "id" : "f1529b88-c958-493e-8452-fccfe932cde1",
  "name" : "demo"
}

状态码

状态码	说明
200	请求成功。
400	请求错误。
401	鉴权失败。
403	没有操作权限。
404	找不到资源。
500	服务内部错误。
503	服务不可用。

父主题： 图管理API

上一篇：查询图详情(1.0.0)

下一篇：关闭图(1.0.0)

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

创建图(2.2.2)

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈