调用SearchResources搜索当前账号下有权限访问的资源。

前提条件

调用前,请确保开通资源元数据中心服务。更多信息,请参见跨资源组搜索资源

使用说明

关于支持资源元数据中心的资源类型,请参见支持资源元数据中心的资源类型

本文将提供一个示例,搜索杭州地域有权限访问的资源。

QPS限制

本API的单用户QPS限制为20次/秒,全局QPS限制为1000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String SearchResources

要执行的操作。取值:SearchResources

NextToken String eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****

查询返回结果下一页的令牌。

当返回结果数据总条数超过MaxResults限制,则数据会被截断,您可以使用NextToken查询下一页数据。

MaxResults Integer 5

每页的最大数据条数。

取值范围:1~100。

默认值:20。

ResourceGroupId String rg-acfmzawhxxc****

资源组ID。

Filter.N.Key String RegionId

过滤条件键。取值:

  • ResourceType:资源类型。
  • RegionId:地域ID。
  • ResourceId:资源ID。
  • ResourceGroupId:资源组ID。
  • ResourceName:资源名称。
Filter.N.Value.N String cn-hangzhou

过滤条件值。

Filter.N.MatchType String Equals

匹配方式。取值:Equals,表示搜索与过滤条件相等的数据。

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
NextToken String eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****

查询返回结果下一页的令牌。

RequestId String 14B1E620-E24F-5A0E-B130-AB1488F4F9F1

请求ID。

MaxResults Integer 5

每页的最大数据条数。

Filters Array of Filter

过滤条件。

Key String RegionId

过滤条件键。

MatchType String Equals

匹配方式。

Values Array of String cn-hangzhou

过滤条件值。

Resources Array of Resource

资源信息。

ResourceType String ACS::VPC::RouteTable

资源类型。

CreateTime String 2021-06-30T09:20:08Z

资源的创建时间。

说明 资源是否返回该参数,由所属的云服务决定。
ResourceGroupId String rg-acfmzawhxxc****

资源组ID。

ZoneId String cn-hangzhou-k

可用区ID。

说明 资源是否返回该参数,由所属的云服务决定。
AccountId String 151266687691****

阿里云账号ID。

ResourceId String vtb-bp11lbh452fr8940s****

资源ID。

ResourceName String group1

资源名称。

RegionId String cn-hangzhou

地域ID。

Tags Array of Tag

标签。

Key String k1

标签键。

Value String v1

标签值。

IpAddresses Array of String 192.168.1.2

IP地址。

说明 资源是否返回该参数,由所属的云服务决定。

示例

请求示例

https://rmc.aliyuncs.com/?Action=SearchResources
&MaxResults=5
&Filter.1.Key=RegionId
&Filter.1.Value.1=cn-hangzhou
&Filter.1.MatchType=Equals
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SearchResourcesResponse>
    <Filters>
        <MatchType>Equals</MatchType>
        <Values>cn-hangzhou</Values>
        <Key>RegionId</Key>
    </Filters>
    <NextToken>eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****</NextToken>
    <RequestId>14B1E620-E24F-5A0E-B130-AB1488F4F9F1</RequestId>
    <MaxResults>5</MaxResults>
    <Resources>
        <AccountId>151266687691****</AccountId>
        <ResourceId>cen-ygbkum0jusr8qg****:cenrmap-7tdf6cpi4u5o9x****</ResourceId>
        <ResourceType>ACS::CEN::CenRouteMap</ResourceType>
        <RegionId>cn-hangzhou</RegionId>
    </Resources>
    <Resources>
        <AccountId>151266687691****</AccountId>
        <ResourceGroupId>rg-acfmzawhxxc****</ResourceGroupId>
        <ResourceId>asdft</ResourceId>
        <ResourceName>asdft</ResourceName>
        <ResourceType>ACS::OOS::Template</ResourceType>
        <RegionId>cn-hangzhou</RegionId>
        <Tags>
            <Value>rg-acfmzawhxxc****</Value>
            <Key>acs:rm:rgId</Key>
        </Tags>
    </Resources>
    <Resources>
        <AccountId>151266687691****</AccountId>
        <ResourceGroupId>rg-acfmzawhxxc****</ResourceGroupId>
        <ResourceId>OOSAutoBindTag</ResourceId>
        <ResourceName>OOSAutoBindTag</ResourceName>
        <ResourceType>ACS::OOS::Template</ResourceType>
        <RegionId>cn-hangzhou</RegionId>
        <Tags>
            <Value>rg-acfmzawhxxc****</Value>
            <Key>acs:rm:rgId</Key>
        </Tags>
    </Resources>
    <Resources>
        <AccountId>151266687691****</AccountId>
        <ResourceGroupId>rg-acfmzawhxxc****</ResourceGroupId>
        <ResourceId>AutoTag</ResourceId>
        <ResourceName>AutoTag</ResourceName>
        <ResourceType>ACS::OOS::Template</ResourceType>
        <RegionId>cn-hangzhou</RegionId>
        <Tags>
            <Value>rg-acfmzawhxxc****</Value>
            <Key>acs:rm:rgId</Key>
        </Tags>
    </Resources>
    <Resources>
        <AccountId>151266687691****</AccountId>
        <ResourceGroupId>rg-acfmzawhxxc****</ResourceGroupId>
        <ResourceId>vtb-bp11lbh452fr8940s****</ResourceId>
        <ResourceName>group1</ResourceName>
        <CreateTime>2020-08-17T02:18:21Z</CreateTime>
        <ResourceType>ACS::VPC::RouteTable</ResourceType>
        <RegionId>cn-hangzhou</RegionId>
    </Resources>
</SearchResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Filters" : [ {
    "MatchType" : "Equals",
    "Values" : [ "cn-hangzhou" ],
    "Key" : "RegionId"
  } ],
  "NextToken" : "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****",
  "RequestId" : "14B1E620-E24F-5A0E-B130-AB1488F4F9F1",
  "MaxResults" : 5,
  "Resources" : [ {
    "AccountId" : "151266687691****",
    "ResourceId" : "cen-ygbkum0jusr8qg****:cenrmap-7tdf6cpi4u5o9x****",
    "ResourceType" : "ACS::CEN::CenRouteMap",
    "RegionId" : "cn-hangzhou"
  }, {
    "AccountId" : "151266687691****",
    "ResourceGroupId" : "rg-acfmzawhxxc****",
    "ResourceId" : "asdft",
    "ResourceName" : "asdft",
    "ResourceType" : "ACS::OOS::Template",
    "RegionId" : "cn-hangzhou",
    "Tags" : [ {
      "Value" : "rg-acfmzawhxxc****",
      "Key" : "acs:rm:rgId"
    } ]
  }, {
    "AccountId" : "151266687691****",
    "ResourceGroupId" : "rg-acfmzawhxxc****",
    "ResourceId" : "OOSAutoBindTag",
    "ResourceName" : "OOSAutoBindTag",
    "ResourceType" : "ACS::OOS::Template",
    "RegionId" : "cn-hangzhou",
    "Tags" : [ {
      "Value" : "rg-acfmzawhxxc****",
      "Key" : "acs:rm:rgId"
    } ]
  }, {
    "AccountId" : "151266687691****",
    "ResourceGroupId" : "rg-acfmzawhxxc****",
    "ResourceId" : "AutoTag",
    "ResourceName" : "AutoTag",
    "ResourceType" : "ACS::OOS::Template",
    "RegionId" : "cn-hangzhou",
    "Tags" : [ {
      "Value" : "rg-acfmzawhxxc****",
      "Key" : "acs:rm:rgId"
    } ]
  }, {
    "AccountId" : "151266687691****",
    "ResourceGroupId" : "rg-acfmzawhxxc****",
    "ResourceId" : "vtb-bp11lbh452fr8940s****",
    "ResourceName" : "group1",
    "CreateTime" : "2020-08-17T02:18:21Z",
    "ResourceType" : "ACS::VPC::RouteTable",
    "RegionId" : "cn-hangzhou",
    "Tags" : [ ]
  } ]
}

错误码

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