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

前提条件

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

使用说明

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

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

QPS限制

本API的单用户QPS限制为20次/秒。超过限制，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。
SortCriterion Object 否

排序参数。
Key String 否 CreateTime

排序条件。

取值为CreateTime，表示按资源创建时间排序。

Order String 否 ASC

排序顺序。取值：

  • ASC（默认值）：升序。
  • DESC：降序。
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>
		<Resource>
			<AccountId>151266687691****</AccountId>
			<ResourceId>cen-ygbkum0jusr8qg****:cenrmap-7tdf6cpi4u5o9x****</ResourceId>
			<ResourceType>ACS::CEN::CenRouteMap</ResourceType>
			<RegionId>cn-hangzhou</RegionId>
		</Resource>
		<Resource>
			<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>
		</Resource>
		<Resource>
			<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>
		</Resource>
		<Resource>
			<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>
		</Resource>
		<Resource>
			<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>
		</Resource>
	</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" : [ ]
  } ]
}

错误码

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