批量添加资源标签 - TagResources
功能介绍
为指定资源(资源指通用文件系统)批量添加标签。一个资源上最多有20个标签。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
- POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create
- 参数说明
参数
是否必选
参数类型
描述
project_id
是
String
操作用户的项目ID,获取方法请参见获取项目ID。
resource_id
是
String
资源ID,此处为通用文件系统名。
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Content-type | 是 | String | 发送的实体的MIME类型。 示例:application/json。 |
X-Auth-Token | 否 | String | 用户Token。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
tags | 否 | List<resource_tag> | 标签列表。详情说明参见表3。 普通租户权限:该字段必选。 op_service权限:tags和sys_tags二选一。 |
sys_tags | 否 | List<resource_tag> | 系统标签列表。op_service权限可以访问。 op_service权限:tags和sys_tags二选一。 目前调用此API时只包含一个resource_tag结构体: key固定为:_sys_enterprise_project_id value是UUID或0,value为0表示默认企业项目。 现在仅支持系统标签添加操作。 详情说明参见表3。 |
响应参数
无
请求示例
projectId为“c80a2157ba1d46c0825265947342077c”,通用文件系统名为“bucketName”,批量添加资源标签示例:
POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags/create 请求体示例:
{
"tags":[
{
"key":"key1",
"value":"value1"
},
{
"key":"key2",
"value":"value2"
}
]
} 响应示例
无
状态码
- 正常
状态码 | 描述 |
|---|---|
204 | 批量添加资源标签成功。 |
- 异常
状态码 | 描述 |
|---|---|
400 | 标签等参数非法。 |
401 | 认证失败。 |
403 | 鉴权失败。 |
404 | 资源未找到。 |
500 | 系统异常。 |

