功能介绍

项目（Project）用于将OpenStack的资源（计算资源、存储资源和网络资源）进行分组和隔离。项目可以是一个部门或者一个项目组。一个帐户中可以创建多个项目。

该接口用于查询用户在指定项目所使用的全部标签。

该接口支持企业项目细粒度权限的校验，具体细粒度请参见 ecs:cloudServers:list

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/{project_id}/cloudservers/tags

参数说明请参见表1。

表1 参数说明

参数	是否必选	描述
project_id	是	项目ID。 获取方法请参见获取项目ID。

请求消息

无

响应消息

响应参数如表2所示。

表2 响应参数

参数	参数类型	描述
tags	Array of objects	标签列表，参考表3。

表3 tag字段数据结构说明

参数	参数类型	描述
key	String	键。 最大长度36个unicode字符。
values	Array of strings	值。 每个值最大长度43个unicode字符。 可以为空字符串。

请求示例

查询该租户在指定项目使用的所有标签。

GET https://{endpoint}/v1/{project_id}/cloudservers/tags

响应示例

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

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 标签管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家