SearchResources - 搜索当前账号的资源

更新时间: 2023-08-28 17:21:08

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

接口说明

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
NextTokenstring

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

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

eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****
MaxResultsinteger

每页的最大数据条数。

取值范围:1~100。

默认值:20。

10
Filterobject []

过滤条件。

Keystring

过滤条件键。取值见下方支持的过滤参数

RegionId
Valuearray

过滤条件值。

string

过滤条件值。

过滤条件值。
MatchTypestring

匹配方式。

取值:Equals,表示相等匹配。

Equals
ResourceGroupIdstring

资源组ID。

rg-acfmzawhxxc****
SortCriterionobject

排序参数。

Keystring

排序条件。

取值:CreateTime,表示按资源创建时间排序。

CreateTime
Orderstring

排序顺序。取值:

  • ASC(默认值):升序。
  • DESC:降序。
ASC

支持的过滤参数

参数描述支持的匹配类型
ResourceType资源类型。Equals
RegionId地域ID。Equals
ResourceId资源ID。Equals、Prefix
ResourceGroupId资源组ID。Equals、Exists、NotExists
ResourceName资源名称。Equals、Contains
Tag标签键值对。 JSON格式为 { "key": $key, "value": $value } ,key与value至少出现一个。例如:查询标签键foo和标签值bar,则传递{ "key": "foo", "value": "bar" } ;查询标签键foo,则传递{ "key": "foo" }Contains、NotContains、NotExists
VpcIdVPC ID。Equals
VSwitchId交换机ID。Equals

返回参数

名称类型描述示例值
object

返回参数。

NextTokenstring

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

eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****
RequestIdstring

请求ID。

D696E6EF-3A6D-5770-801E-4982081FE4D0
MaxResultsinteger

每页的最大数据条数。

10
Filtersobject []

过滤条件。

Keystring

过滤条件键。

RegionId
MatchTypestring

匹配方式。

Equals
Valuesarray

过滤条件值。

string

过滤条件值。

cn-hangzhou
Resourcesobject []

资源信息。

ResourceTypestring

资源类型。

ACS::VPC::RouteTable
CreateTimestring

资源的创建时间。

说明 资源是否返回该参数,由所属的云服务决定。
2021-06-30T09:20:08Z
ResourceGroupIdstring

资源组ID。

rg-acfmzawhxxc****
ZoneIdstring

可用区ID。

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

阿里云账号ID。

151266687691****
ResourceIdstring

资源ID。

vtb-bp11lbh452fr8940s****
ResourceNamestring

资源名称。

group1
RegionIdstring

地域ID。

cn-hangzhou
Tagsobject []

标签。

Keystring

标签键。

test_key
Valuestring

标签值。

test_value
IpAddressesarray

IP地址。

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

IP地址。

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

示例

正常返回示例

JSON格式

{
  "NextToken": "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****\t\n",
  "RequestId": "D696E6EF-3A6D-5770-801E-4982081FE4D0",
  "MaxResults": 10,
  "Filters": [
    {
      "Key": "RegionId",
      "MatchType": "Equals",
      "Values": [
        "cn-hangzhou"
      ]
    }
  ],
  "Resources": [
    {
      "ResourceType": "ACS::VPC::RouteTable",
      "CreateTime": "2021-06-30T09:20:08Z",
      "ResourceGroupId": "rg-acfmzawhxxc****",
      "ZoneId": "cn-hangzhou-k",
      "AccountId": "151266687691****",
      "ResourceId": "vtb-bp11lbh452fr8940s****",
      "ResourceName": "group1",
      "RegionId": "cn-hangzhou",
      "Tags": [
        {
          "Key": "test_key",
          "Value": "test_value"
        }
      ],
      "IpAddresses": [
        "192.168.1.2"
      ]
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400NoPermissionYou are not authorized to perform this operation.无操作权限。
400InvalidParameter.MaxResultsThe specified parameter MaxResults is not valid.参数 MaxResults 不合法。
409InvalidParameter.SortCriterion.KeyThe specified parameter SortCriterion.Key is not valid.参数 SortCriterion.Key 不合法。
409ExceedLimit.FilterThe maximum length of Filters is exceeded.参数 Filter 数量超出上限。

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

变更历史

变更时间变更内容概要操作
2023-08-22OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:409
2023-03-30OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:409
2023-03-07OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:409
阿里云首页 资源管理 相关技术圈