文档首页 > > API参考> SFS API说明> 共享标签> 批量添加共享标签

批量添加共享标签

分享
更新时间: 2019/08/23 15:44

功能介绍

指定共享批量添加标签。

一个共享上最多有10个标签。

一个共享上的多个标签的key不允许重复。

此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。

URI

  • POST /v2/{project_id}/sfs/{share_id}/tags/action
  • 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

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

    share_id

    String

    共享ID。

请求消息

  • 参数说明

    参数

    是否必选

    参数类型

    描述

    action

    String

    操作标识,取值范围为:“create”和“delete”。 为指定共享批量添加标签时使用“create”。

    tags

    Array of resource_tags

    标签列表。

    租户权限时该字段必选,op_service权限时和sys_tags二选一。

    sys_tags

    Array of resource_tags

    系统标签列表

    op_service权限可以访问,和tags二选一。

    目前TMS调用时只包含一个resource_tag结构体 ,key固定为:_sys_enterprise_project_id。

    value是UUID或0,value为0表示默认企业项目。

  • resource_tag字段说明:

    参数

    是否必选

    参数类型

    描述

    key

    String

    标签的键。最大长度36个字符。 key不能为空,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

    value

    String

    标签的值。每个值最大长度43个字符,可以为空字符串。 不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

  • 请求样例
    {
        "action": "create",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value2"
            }
        ]
    }

响应消息

  • 参数说明

  • 响应样例

状态码

  • 正常

    204

  • 异常

    状态码

    说明

    400 Bad Request

    无效输入。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    对被请求页面的访问被禁止。

    404 Not Found

    资源未找到。

    500 Internal Server Error

    请求未完成。服务异常。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区