# 操作堡垒机实例资源标签 - BatchCreateInstanceTag #### 功能介绍 操作堡垒机实例资源标签。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-cbh/cbh_02_0008.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbh/cbh_02_00015.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cbh:instance:operateInstanceTags | Tagging | instance \* | - g:EnterpriseProjectId - g:ResourceTag/tag-key | - | - | | cbh:instance:operateInstanceTags | Tagging | - | - g:RequestTag/tag-key - g:TagKeys | - | - | #### URI POST /v2/{project_id}/cbs/instance/{resource_id}/tags/action 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，用于唯一标识用户项目。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbh/cbh_02_0020.html)。 **约束限制**： 不涉及 **取值范围**： 只能由字母和数字组成，长度为32个字符。 **默认取值**： 不涉及 | | resource_id | 是 | String | 资源ID。可参考接口[获取堡垒机实例列表](https://support.huaweicloud.com/api-cbh/ListInstances.html)获取。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。获取方法请参见[获取用户Token](https://support.huaweicloud.com/api-cbh/cbh_02_0010.html)。 **约束限制**： 不涉及 **取值范围**： 字符串，长度为1\~28000个字符。 **默认取值**： 不涉及 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | action | 是 | String | 执行动作。 - create：创建 - delete：删除 | | tags | 是 | Array of [ResourceTag] objects | 标签列表。 租户权限时该字段必选，op_service权限时和sys_tags二选一。 | | sys_tags | 否 | Array of [ResourceTag] objects | - 系统标签列表。 - op_service权限可以访问，和tags二选一。 - 目前TMS调用时只包含一个resource_tag结构体 ，key固定为：_sys_enterprise_project_id - value是UUID或0，value为0表示默认企业项目。 - 现在仅支持create操作。 | 表4ResourceTag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | 键。最大长度128个字符。 | | value | 是 | String | 值。每个值最大长度255个字符。 | #### 响应参数 **状态码：204** 无 **状态码：401** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 校验Token失败。 | **状态码：403** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 租户无权限操作。 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_description | String | 没有找到CBH资源。 | #### 请求示例 ``` { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key", "value" : "value3" } ] } ``` #### 响应示例 无 #### 状态码 | 状态码 | 描述 | |:---|:---| | 204 | No Content。 | | 400 | 标签等参数非法 | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | | 500 | 系统异常 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cbh/ErrorCode.html)。