文档首页 > > API参考> 历史API> 管理面API> 图管理API>

创建图(2.1.5)

查看PDF

创建图(2.1.5)

更新时间：2020/12/14 GMT+08:00

功能介绍

创建一个图。

URI

URI 格式
```
POST /v1.0/{projectId}/graphs
```
参数说明
表1 URI参数说明
参数

是否必选

类型

说明

projectId

是

String

项目编号，用于资源隔离。请参考获取项目ID。

表1 URI参数说明
参数	是否必选	类型	说明
projectId	是	String	项目编号，用于资源隔离。请参考获取项目ID。

请求

请求样例

POST https://Endpoint/v1.0/{projectId}/graphs
{
    "graph":{
        "name":"demo",
	"dataSource": {
			"type": "OBS",
			"parameters": {
				"schemaPath": "hkmovie/testcre/schema.xml",
				"edgesetPath": "hkmovie/testcre/edges/edge.csv",
				"edgesetFormat": "csv",
				"edgesetDefaultLabel": "",
				"vertexsetPath": "hkmovie/testcre/vetexs/vertex.csv",
				"vertexsetFormat": "csv",
				"vertexsetDefaultLabel": "",
				"logDir": "hkmovie/logdir",
                                "parallelEdge": { 
                                      "action":"override",
                                      "ignoreLabel":true
                                     }
			}
        },
        "graphSizeTypeIndex": "1",
        "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
}

表2 Body参数说明
名称	是否必选	参数类型	说明
graph	是	参考graph图类型数据结构说明。	图类型。
enableMultiAZ	否	Boolean	创建的图是否支持跨可用区（AZ），默认值是false，如果设置为true，系统将会把图中的ECS建在两个可用区中。如果创建图时，不加该参数，则会将图中的ECS都建在一个可用区中。

表3 graph图类型数据结构说明
名称	是否必选	参数类型	说明
name	是	String	图名称。
graphSizeTypeIndex	是	Integer	图规模类型索引。 0：一万边 1：百万边 2：千万边 3：一亿边 4：十亿边 5：百亿边
dataSource	否	DataSource数据结构	数据源。创建建空图时不设置该字段。具体请参考表5。
vpcId	是	String	虚拟私有云ID。
subnetId	是	String	指定虚拟私有云下的网络ID。
securityGroupId	是	String	安全组ID。
publicIp	否	Object	公网IP地址，如果未指定，则默认不使用公网连接。具体请参考表4。

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

表5 DataSource数据结构
名称	是否必选	参数类型	说明
type	是	String	数据源类型。取值为OBS，且当前只支持OBS。
parameters	是	Object	数据源参数。具体请参考表6。

表6 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	否	Object	重复边处理。具体请参考表7。

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

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

响应

表8 要素说明
名称	是否必选	参数类型	说明
errorMessage	否	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误信息。
errorCode	否	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误码。
id	否	String	图ID。
name	否	String	图名称。

请求成功样例

Http Status Code: 200
{
    "id": "f1529b88-c958-493e-8452-fccfe932cde1",
    "name": "demo"
}

请求失败样例

Http Status Code: 400
{
    "errorCode": "GES.7022",
    "errorMessage": "The security group does not exist."
}

返回值

正常
 200

异常

表9 异常返回值说明
返回值	说明
400 Bad Request	请求错误。
401 Unauthorized	鉴权失败。
403 Forbidden	没有操作权限。
404 Not Found	找不到资源。
500 Internal Server Error	服务内部错误。
503 Service Unavailable	服务不可用。

父主题： 图管理API

上一篇：创建图(2.1.2)

下一篇：创建图(2.1.16)

文档是否有解决您的问题？

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

反馈提交失败，请稍后再试！

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

智能客服提问云社区提问