创建图(2.1.5)
功能介绍
创建一个图。
URI
- URI 格式
POST /v1.0/{projectId}/graphs
- 参数说明
表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 }
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
graph |
是 |
参考graph图类型数据结构说明。 |
图类型。 |
enableMultiAZ |
否 |
Boolean |
创建的图是否支持跨可用区(AZ),默认值是false,如果设置为true,系统将会把图中的ECS建在两个可用区中。 如果创建图时,不加该参数,则会将图中的ECS都建在一个可用区中。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
name |
是 |
String |
图名称。 |
graphSizeTypeIndex |
是 |
Integer |
图规模类型索引。
|
dataSource |
否 |
DataSource数据结构 |
数据源。创建建空图时不设置该字段。具体请参考表5。 |
vpcId |
是 |
String |
虚拟私有云ID。 |
subnetId |
是 |
String |
指定虚拟私有云下的网络ID。 |
securityGroupId |
是 |
String |
安全组ID。 |
publicIp |
否 |
Object |
公网IP地址,如果未指定,则默认不使用公网连接。具体请参考表4。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
publicBindType |
否 |
String |
弹性IP绑定类型,取值如下。
|
eipId |
否 |
String |
弹性IP的id,当publicBindType设置为bind_existing时,该值为用户某个已创建但尚未绑定的EIP的ID;当publicBindType设置为auto_assign时,该值设置为空。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
type |
是 |
String |
数据源类型。取值为OBS,且当前只支持OBS。 |
parameters |
是 |
Object |
数据源参数。具体请参考表6。 |
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
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。 |
响应
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
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." }
