全部产品
Search

搜索本产品

    DDoS 防护：DescribeTagResources - 查询资源关联的标签信息

    文档中心

    DDoS 防护：DescribeTagResources - 查询资源关联的标签信息

    更新时间：Aug 28, 2026

    查询DDoS高防（中国内地）实例绑定的标签信息。

    接口说明

    本接口用于查询 DDoS 高防（中国内地）实例绑定的标签信息。

    说明

    只有 DDoS 高防（中国内地）服务支持标签功能。

    QPS 限制

    本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用将会被限流，这可能影响您的业务，请合理调用。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    yundun-ddoscoo:DescribeTagResources

    get

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    DDoS 高防实例所属地域 ID。取值固定为cn-hangzhou，表示中国内地，即 DDoS 高防（中国内地）实例。

    cn-hangzhou
    ResourceGroupId

    string

    否

    DDoS 高防实例在资源管理服务中所属的资源组 ID。

    不设置该参数表示默认资源组。

    rg-acfm2pz25js****
    ResourceType

    string

    是

    资源类型。取值固定为 INSTANCE，表示 DDoS 高防实例。

    INSTANCE
    NextToken

    string

    否

    查询凭证（Token）。取值为上一次调用本接口返回的 NextToken 参数值。

    说明

    初次调用本接口时无需设置该参数。

    RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****
    ResourceIds

    array

    否

    要查询的 DDoS 高防（中国内地）实例的 ID 列表。

    ddoscoo-cn-mp91j1ao****

    string

    否

    要查询的 DDoS 高防（中国内地）实例的 ID。

    说明

    • ResourceIds.N与Tags.N.Key不能同时为空。

    ddoscoo-cn-zz121ogz****
    Tags

    array<object>

    否

    要查询的标签列表。每个标签由标签键（Key）和标签值（Value）组成。

    object

    否

    Key

    string

    否

    要查询的标签键。

    说明

    • ResourceIds.N与Tags.N.Key不能同时为空。

    testkey
    Value

    string

    否

    要查询的标签值。

    testvalue

    调用 API 时，除了本文中该 API 的请求参数，还需加入阿里云 API 公共请求参数。公共请求参数的详细介绍，请参见公共参数。

    调用 API 的请求格式，请参见本文示例中的请求示例。

    返回参数

    名称

    类型

    描述

    示例值

    object

    NextToken

    string

    本次调用返回的查询凭证（Token）。

    RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****
    RequestId

    string

    本次请求的 ID。

    36E698F7-48A4-48D0-9554-0BB4BAAB99B3
    TagResources

    object

    TagResource

    array<object>

    DDoS 高防（中国内地）实例绑定的标签列表。

    object

    TagValue

    string

    DDoS 高防（中国内地）实例绑定的标签值。

    testkey
    ResourceType

    string

    资源类型。取值固定为 INSTANCE，表示 DDoS 高防实例。

    INSTANCE
    ResourceId

    string

    DDoS 高防（中国内地）实例的 ID。

    ddoscoo-cn-zz121ogz****
    TagKey

    string

    DDoS 高防（中国内地）实例绑定的标签键。

    testvalue

    示例

    正常返回示例

    JSON格式

    {
  "NextToken": "RGuYpqDdKhzXb8C3.D1BwQgc1tMBsoxdGiEKHHUUCf****",
  "RequestId": "36E698F7-48A4-48D0-9554-0BB4BAAB99B3",
  "TagResources": {
    "TagResource": [
      {
        "TagValue": "testkey",
        "ResourceType": "INSTANCE",
        "ResourceId": "ddoscoo-cn-zz121ogz****",
        "TagKey": "testvalue"
      }
    ]
  }
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。