添加label

功能介绍

添加label。

URI

请求参数

• 请求参数说明（OBS场景）

  表2 Body参数说明

  参数	是否必选	类型	说明
  name	是	String	label名称。 label name的长度不能超过256。 label name只允许字符，数字, 空格，%,@,#,$,:,?,*,.,+,-和_符号。
  type	否	String	Label类别，表示此label用于点或边，取值如下： “vertex”：表示label用于点。 “edge”：表示label用于边。 “all”：表示label用于点和边。 默认值为all。
  properties	是	Object	待添加属性数组。具体参数介绍请见表3 properties参数说明。

  表3 properties参数说明

  参数	是否必选	类型	说明
  property	否	Object	label的属性。具体参数介绍请见表4 property参数说明。

  表4 property参数说明

  参数	是否必选	类型	说明
  name	是	String	属性名称。 property name的长度不能超过256。 property name不允许包含<, >, &, ascci码14,15和30。 同一个label下不允许存在相同的property。
  cardinality	是	String	属性的复合类型，包括： single list set
  dataType	是	String	属性的数据类型。具体请参考持久化版规格说明中的元数据类型。

响应参数

请求示例

添加label，label的名称为book，label有一个待添加的属性。

POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels  
{
  "name": "book",
  "type": "vertex",
  "properties": [
    {
      "property": {
        "name": "Title",
        "cardinality": "single",
        "dataType": "string"
      }
    },
    {
      "property": {
        "name": "Version",
        "cardinality": "single",
        "dataType": "string"
      }
    }
  ]
}

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

响应示例

状态码： 200

成功响应示例

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

状态码： 400

Http Status Code: 400
 {
  "errorMessage": "label already exists",
  "errorCode": "GES.8801"
 }

状态码

错误码

请参见错误码。