文档首页/ 虚拟专用网络 VPN/ API参考/ API/ 服务公共接口/ VPN标签/ 查询项目标签 - QueryProjectTags
更新时间:2026-04-24 GMT+08:00

查询项目标签 - QueryProjectTags

功能介绍

查询租户在指定项目中指定资源类型下的所有标签。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

vpn::listTags

list

vpnGateways

vpn:resourceInstanceTags:list

-

customerGateways

g:ResourceTag/<tag-key>

vpnConnections

URI

GET /v5/{project_id}/{resource_type}/tags

表1 参数说明

名称

类型

是否必选

描述

project_id

String

项目ID,可以通过获取项目ID获取项目ID。

resource_type

String

  • 功能说明:资源类型。
  • 取值范围:

    vpn-gateway:站点入云VPN网关。

    customer-gateway:对端网关。

    vpn-connection:VPN连接。

    p2c-vpn-gateways:终端入云VPN网关。

请求消息

  • 请求参数

    无。

  • 请求样例
    GET https://{Endpoint}/v5/{project_id}/{resource_type}/tags

响应消息

  • 响应参数

    返回状态码为 200: 查询成功。

    表2 响应Body参数列表

    名称

    类型

    描述

    tags

    Array of ResourceTag objects

    资源标签列表。

    表3 ResourceTag

    名称

    类型

    描述

    key

    String

    标签的键。

    values

    Array of String

    标签的值。

  • 响应样例
    {
        "tags":[
            {
                "key":"key1",
                "values":["value1"]
            }
        ]
    }

状态码

请参见状态码