更新时间:2024-11-18 GMT+08:00

查询资源标签

功能介绍

查询指定资源的标签。

URI

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

    参数

    是否必选

    参数类型

    描述

    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

sys_tags

List<resource_tag>

系统标签列表。仅op_service权限才可以获取此字段。

目前只包含一个resource_tag结构体:

key:_sys_enterprise_project_id

value:企业项目id。0表示默认企业项目。

详情说明参见表3

请求示例

projectId为“c80a2157ba1d46c0825265947342077c”,通用文件系统名为“bucketName”,查询资源标签示例:

GET https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags

响应示例

{
    "tags":[
        {
            "key":"key1",
            "value":"value1"
        },
        {
            "key":"key2",
            "value":"value2"
        }
    ]
}

状态码

  • 正常

状态码

描述

200

查询资源标签成功。

  • 异常

状态码

描述

400

标签等参数非法

401

认证失败

403

鉴权失败

404

资源未找到

500

系统异常