接口描述
在实例数量较多的情况下,您可以创建多个标签,为实例绑定不同的标签对其进行分类,之后通过标签进行实例筛选。
- 标签由一对键(key)值(value)组成,键同一租户下标签名称唯一、平台标签名称唯一,值无此限制。
请求方法
POST
URI
/v1/label/create-labels
请求参数
名称 | 二级节点 | 位置 | 类型 | 必选 | 说明 |
---|---|---|---|---|---|
labelType | body | Integer | 是 | 资源标签分类标识,1-主机,2-实例,这里固定传2 | |
labels | body | Array | 是 | 标签列表,一次最多只能新增50个 | |
labelName | body | String | 是 | 资源标签名称,同一租户下标签名称唯一、平台标签名称唯一 | |
labelValue | body | String | 否 | 标签值 | |
remark | body | String | 否 | 标签说明 |
响应参数
名称 | 类型 | 说明 |
---|---|---|
message | String | 消息提示 |
statusCode | Integer | 状态码 |
returnObj | Object | 所有的返回信息都以JSON形式保存 |
示例
请求示例
/v1/label/createLables
{
"labelType": 2,
"labels": [
{
"labelName": "test",
"labelValue": "test",
"remark": ""
}
]
}
响应示例
{
"message": "SUCCESS",
"opMessage": "",
"returnObj": {},
"statusCode": 800
}
错误码
访问ErrorCodes说明文档查看更多错误码。