全部产品
Search

搜索本产品

    资源管理：ListAutoGroupingRules - 查询自动转组规则列表

    文档中心

    资源管理：ListAutoGroupingRules - 查询自动转组规则列表

    更新时间：Aug 28, 2026

    调用ListAutoGroupingRules查询自动转组规则列表。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    resourcemanager:ListAutoGroupingRules

    list

    *全部资源

    *

    		 无 无

    请求语法

    POST  HTTP/1.1

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RuleId

    string

    否

    规则 ID。

    gr-acfo******hy6a
    RuleName

    string

    否

    规则名称。

    A项目线上资源自动转组规则
    RuleType

    string

    否

    规则类型。取值：

    • custom_condition：自定义规则转组。

    • associated_transfer：关联资源跟随转组。

    custom_condition

    NextToken

    string

    否

    当请求的返回结果被截断时，您可以使用 NextToken 再次发起请求，获取从当前截断位置之后的内容。

    TGlzdFJlc291cm****
    MaxResults

    integer

    否

    单次请求返回结果的最大条数。取值范围：1~50。

    10

    返回参数

    名称

    类型

    描述

    示例值

    object

    返回结果。

    NextToken

    string

    当请求的返回结果被截断时，您可以使用 NextToken 再次发起请求，获取从当前截断位置之后的内容。

    TGlzdFJlc291cm****
    MaxResults

    integer

    单次请求返回结果的最大条数。取值范围：1~50。

    10
    Rules

    array<object>

    规则列表。

    array<object>

    规则列表。

    CreateTime

    string

    规则创建时间。

    2025-01-01T10:00:00+08:00
    ExcludeRegionIdsScope

    string

    地域 ID 排除范围，多个地域 ID 用半角逗号（,）分隔。

    cn-hangzhou,cn-shanghai
    ExcludeResourceGroupIdsScope

    string

    资源组 ID 排除范围，多个资源组 ID 用半角逗号（,）分隔。

    rg-aekz****ql4b5ea,rg-aek2****akfxykq
    ExcludeResourceIdsScope

    string

    资源 ID 排除范围，多个资源 ID 用半角逗号（,）分隔。

    i-2zee******ym49kfmwis,vpc-5ts6******fnw493g849a
    ExcludeResourceTypesScope

    string

    资源类型排除范围，多个资源类型用半角逗号（,）分隔。

    ecs.instance,vpc.vpc
    ModifyTime

    string

    规则更新时间。

    2025-01-01T10:00:00+08:00
    RegionIdsScope

    string

    地域 ID 范围，多个地域 ID 用半角逗号（,）分隔。

    cn-hangzhou,cn-shanghai
    ResourceGroupIdsScope

    string

    资源组 ID 范围，多个资源组 ID 用半角逗号（,）分隔。

    rg-aekz****ql4b5ea,rg-aek2****akfxykq
    ResourceIdsScope

    string

    资源 ID 范围，多个资源 ID 用半角逗号（,）分隔。

    i-2zee******ym49kfmwis,vpc-5ts6******fnw493g849a
    ResourceTypesScope

    string

    资源类型范围，多个资源类型用半角逗号（,）分隔。

    ecs.instance,vpc.vpc
    RuleContents

    array<object>

    规则内容列表。

    object

    规则内容列表。

    AutoGroupingScopeCondition

    string

    自动转组范围条件，用于指定需要自动转组的资源范围。

    {"children":[{"desired":"{\"env\":\"online\", \"project\":\"A\"}","featurePath":"$.tags","featureSource":"RESOURCE","operator":"TagMatchAll"}],"operator":"and"}
    RuleContentId

    string

    规则内容 ID。

    grc-acfo******fwybpq
    TargetResourceGroupCondition

    string

    目标资源组条件，用于指定自动分组的目标资源组。

    {"children":[{"desired":"rg-aek2********qcy","featurePath":"$.resourceGroupId","featureSource":"RESOURCE","operator":"StringEquals"}],"operator":"and"}
    RuleDesc

    string

    规则描述。

    带有标签 {"env": "online"} 和 {"project": "A"} 的资源转移到资源组rg-aek2********qcy
    RuleId

    string

    规则 ID。

    gr-acfo******hy6a

    RuleName

    string

    规则名称。

    A项目线上资源自动转组规则
    RuleType

    string

    规则类型。取值：

    • custom_condition：自定义规则转组。

    • associated_transfer：关联资源跟随转组。

    custom_condition
    RequestId

    string

    请求 ID。

    9B34724D-54B0-4A51-B34D-4512372FE1BE

    示例

    正常返回示例

    JSON格式

    {
  "NextToken": "TGlzdFJlc291cm****",
  "MaxResults": 10,
  "Rules": [
    {
      "CreateTime": "2025-01-01T10:00:00+08:00",
      "ExcludeRegionIdsScope": "cn-hangzhou,cn-shanghai",
      "ExcludeResourceGroupIdsScope": "rg-aekz****ql4b5ea,rg-aek2****akfxykq",
      "ExcludeResourceIdsScope": "i-2zee******ym49kfmwis,vpc-5ts6******fnw493g849a",
      "ExcludeResourceTypesScope": "ecs.instance,vpc.vpc",
      "ModifyTime": "2025-01-01T10:00:00+08:00",
      "RegionIdsScope": "cn-hangzhou,cn-shanghai",
      "ResourceGroupIdsScope": "rg-aekz****ql4b5ea,rg-aek2****akfxykq",
      "ResourceIdsScope": "i-2zee******ym49kfmwis,vpc-5ts6******fnw493g849a",
      "ResourceTypesScope": "ecs.instance,vpc.vpc",
      "RuleContents": [
        {
          "AutoGroupingScopeCondition": "{\"children\":[{\"desired\":\"{\\\"env\\\":\\\"online\\\", \\\"project\\\":\\\"A\\\"}\",\"featurePath\":\"$.tags\",\"featureSource\":\"RESOURCE\",\"operator\":\"TagMatchAll\"}],\"operator\":\"and\"}",
          "RuleContentId": "grc-acfo******fwybpq",
          "TargetResourceGroupCondition": "{\"children\":[{\"desired\":\"rg-aek2********qcy\",\"featurePath\":\"$.resourceGroupId\",\"featureSource\":\"RESOURCE\",\"operator\":\"StringEquals\"}],\"operator\":\"and\"}"
        }
      ],
      "RuleDesc": "带有标签 {\"env\": \"online\"} 和 {\"project\": \"A\"} 的资源转移到资源组rg-aek2********qcy",
      "RuleId": "gr-acfo******hy6a\n",
      "RuleName": "A项目线上资源自动转组规则",
      "RuleType": "custom_condition"
    }
  ],
  "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 InvalidParameter.NextToken The parameter NextToken is invalid. 参数NextToken无效。
    409 AutoGroupingNotEnabled The auto grouping is disabled. 自动转组已禁用。

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

    变更历史

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