添加实例标签
功能介绍
对指定实例添加用户标签信息。
调试
您可以在API Explorer中调试该接口。
URI
POST https://{
Endpoint
}/v3/{
project_id
}/instances/{
instance_id
}/tags
表1 参数说明
参数
是否必选
参数类型
描述
project_id
是
String
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
只能由英文字母、数字组成，且长度为32个字符。
默认取值：
不涉及。
instance_id
是
String
实例ID。
请求参数
表2 参数说明
名称
是否必选
参数类型
说明
tags
是
Array of objects
需要添加的用户标签列表。
详情请参见表3。
表3 tags参数说明
名称
是否必选
参数类型
说明
key
是
String
标签键。
说明：
允许包含任意语种字母、数字、空格和_ . : = + - @特殊字符，但首尾不能含有空格，不能以_sys_开头，限制长度最长128。
value
是
String
标签值。
说明：
允许包含任意语种字母、数字、空格和_ . : / = + - @特殊字符，限制长度最长255。
响应参数
表4 参数说明
参数
参数类型
描述
instance_id
String
实例ID。
instance_name
String
实例名称。
请求示例
创建一个用户标签，key为1，value为2。
POST https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/tags
{
"tags": [{
"key":"1",
"value":"2"
}]
}
响应示例
{
"instance_id": "dsfae23fsfdsae3435in01",
"instance_name": "Gauss-a87h"
}
状态码
-
正常
200
-
异常
请参见状态码。
错误码
请参见错误码。
