更新label(1.1.7)
功能介绍
向已经存在的label末尾追加property，或覆盖写整个label。
URI
POST /ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels/{label_name}/properties 参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
project_id | 是 | String | 参数解释： 项目编号。获取方法，请参见获取项目ID。 约束限制： 不涉及。 取值范围： 只能由英文字母和数字组成，且长度为[1-64]个字符。 默认取值： 不涉及。 |
graph_name | 是 | String | 图名称。 |
label_name | 是 | String | Label名称。 |
请求参数
参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
properties | 是 | Object | 待追加的属性数组。具体参数介绍请见properties参数说明。 |
override | 否 | Bool | 默认为false，当为true时表示覆盖写整个Label。 |
参数 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
name | 是 | String | 属性名称。
|
cardinality | 是 | String | 属性的复合类型，包括：
|
dataType | 是 | String | 属性的数据类型。具体请参考元数据属性约束条件中的元数据类型。 |
typeNameCount | 否（若dataType为enum，则必选） | String | enum类型参数的总数。由该选项控制typeName的个数。 |
typeName* | 否（若dataType为enum，则必选） | String | enum类型参数名称。例如typeNameCount为2，则参数包含typeName1:science，typeName2:literature。 |
响应参数
参数 | 类型 | 说明 |
|---|---|---|
errorMessage | String | 参数解释： 系统提示信息。
取值范围： 不涉及。 |
errorCode | String | 参数解释： 系统提示信息。
取值范围： 不涉及。 |
result | String | 响应结果。成功时result值为success。 |
请求示例
更新label，label的名称为book，label一共有三个待更新的属性。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels/book/properties
{
"properties": [
{
"property": {
"name": "Title",
"cardinality": "single",
"dataType": "string"
}
},
{
"property": {
"name": "Version",
"cardinality": "single",
"dataType": "string"
}
},
{
"property": {
"name": "Category",
"typeName1": "science",
"typeName2": "literature",
"typeNameCount": "2",
"dataType": "enum"
}
}
]
} 
SERVER_URL：图的访问地址，取值请参考业务面API使用限制。
响应示例
状态码： 200
成功响应示例
Http Status Code: 200
{
"result": "success"
} 状态码： 400
Http Status Code: 400
{
"errorMessage": "Bad Request, properties is null",
"errorCode": "GES.8000"
} 状态码
返回值 | 说明 |
|---|---|
202 Accepted | 请求已接收，暂未处理。 |
400 Bad Request | 请求错误。 |
401 Unauthorized | 鉴权失败。 |
403 Forbidden | 没有操作权限。 |
404 Not Found | 找不到资源。 |
500 Internal Server Error | 服务内部错误。 |
503 Service Unavailable | 服务不可用。 |
错误码
请参见错误码。
