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

创建图(2.1.2)

创建图(2.1.2)

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

功能介绍

创建一个图。

URI

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

    参数

    是否必选

    类型

    说明

    projectId

    String

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

请求

  • 请求样例
    POST https://Endpoint/v1.0/{projectId}/graphs
    {
        "graph":{
            "name":"demo",
            "regionCode": "cn-north-1",
            "azCode": "cn-north-1a",
    	"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"
            }
        }
    }

表2 Body参数说明

名称

是否必选

参数类型

说明

graph

参考graph图类型数据结构说明。

图类型。

表3 graph图类型数据结构说明

名称

是否必选

参数类型

说明

name

String

图名称。

regionCode

String

域编码。

azCode

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

    服务不可用。

分享:

    相关文档

    相关产品

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

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问