文档首页/ 弹性文件服务 SFS/ API参考/ 通用文件系统API说明/ 标签/ 批量添加资源标签
更新时间：2024-11-18 GMT+08:00
查看PDF
分享

批量添加资源标签

功能介绍

为指定资源（资源指通用文件系统）批量添加标签。一个资源上最多有20个标签。

URI

  • POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create
  • 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

    操作用户的项目ID，获取方法请参见获取项目ID。

    resource_id

    是

    String

    资源ID，此处为通用文件系统名。

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-type

是

String

发送的实体的MIME类型。

示例：application/json。

X-Auth-Token

否

String

用户Token。
表2 请求Body参数

参数

是否必选

参数类型

描述

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。
表3 resource_tag

参数

是否必选

参数类型

描述

key

是

String

标签的键。最大长度为128个字符，不能为空，首尾不支持空格字符，以“_sys_”开头的键属于系统标签，不支持用户输入，可用UTF-8格式表示的任意语种的字母、数字和空格，以及“_”、“.”、“:”、“=”、“+”、“-”、“@”。

value

否

String

标签的值。最大长度为255个字符，首尾不支持空格字符，值可以为空字符串，可用UTF-8格式表示的任意语种的字母、数字和空格，以及以下字符： “_”、“.”、“:”、“=”、“+”、“-”、“@”。

响应参数

无

请求示例

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

系统异常。
父主题： 标签