创建标签
功能介绍
新建标签
URI
POST /v1.0/{project_id}/data/tags
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目id,获取方法请参见获取项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
Content-Type |
是 |
String |
内容类型。填application/json |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
标签名称 最大长度:64 |
description |
否 |
String |
标签描述 最大长度:255 |
parent_id |
否 |
Integer |
节点父标签 最小值:0 缺省值:15000000 |
is_tag |
否 |
Boolean |
是否是标签,true:创建标签、false:创建分类 缺省值:true |
simulation_tags |
否 |
Array of longs |
仿真标签,最多50个 |
响应参数
状态码: 201
参数 |
参数类型 |
描述 |
---|---|---|
payload |
payloadWithSingleNumber object |
实际返回信息 |
meta_info |
RespMetaInfo object |
元数据 |
请求示例
-
创建标签
https://{endpoint}/v1.0/{project_id}/data/tags { "name" : "tag", "description" : "remark", "parent_id" : 0, "is_tag" : true, "simulation_tags" : [ 10 ] }
-
创建分类
https://{endpoint}/v1.0/{project_id}/data/tags { "name" : "432341", "is_tag" : false, "parent_id" : 0 }
响应示例
状态码: 201
创建成功,返回标签id
{ "meta_info" : { "current_time" : "2022-01-01T08:08:29Z" }, "payload" : { "item" : 1 } }
状态码
状态码 |
描述 |
---|---|
201 |
创建成功,返回标签id |
400 |
请求参数错误 |
403 |
权限校验失败 |
404 |
找不到请求的资源 |
409 |
存在重名标签或标签层级超出上限 |
500 |
系统内部错误 |
错误码
请参见错误码。