更新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。获取方法请参见获取项目ID。 |
|
graph_name |
是 |
String |
图名称。 |
|
label_name |
是 |
String |
Label名称。 |
请求参数
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
properties |
是 |
Object |
待追加的属性数组。具体参数介绍请见表3 properties参数说明。 |
|
override |
否 |
Bool |
默认为false，当为true时表示覆盖写整个Label。 |
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
name |
是 |
String |
属性名称。
|
|
cardinality |
是 |
String |
属性的复合类型，包括：
|
|
dataType |
是 |
String |
属性的数据类型。具体请参考表1中的元数据类型。 |
|
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，失败时值为failed。 |
请求示例
更新label，label的名称为book，label一共有三个待更新的属性。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels/{label_name}/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"
}
}
]
}
响应示例
状态码： 200
成功响应示例
Http Status Code: 200
{
"result": "success"
}
状态码： 400
Http Status Code: 400
{
"errorMessage": "label already exists",
"errorCode": "GES.8801"
}
状态码
|
返回值 |
说明 |
|---|---|
|
400 Bad Request |
请求错误。 |
|
401 Unauthorized |
鉴权失败。 |
|
403 Forbidden |
没有操作权限。 |
|
404 Not Found |
找不到资源。 |
|
500 Internal Server Error |
服务内部错误。 |
|
503 Service Unavailable |
服务不可用。 |
错误码
请参见错误码。
