現在のアカウントでアクセスが許可されているリソースを検索します。
操作説明
-
現在のアカウントでアクセスが許可されているリソースのみを検索できます。
-
検索できるのは、Resource Center でサポートされている Alibaba Cloud サービスとリソースタイプのみです。
-
デフォルトでは、SearchResources 操作は最大 20 件のエントリを返します。返されるエントリの最大数を変更するには、
MaxResultsパラメーターを指定します。 -
レスポンスに
NextTokenの値が含まれていない場合、それ以上の結果はありません。次のページの結果を取得するには、前のレスポンスのNextTokenの値を次のリクエストに含めます。NextTokenパラメーターを指定しない場合、結果の最初のページが返されます。 -
1 つ以上のフィルター条件を設定して、検索範囲を絞り込むことができます。サポートされているフィルターパラメーターと一致メソッドについては、以降のセクションをご参照ください。複数のフィルター条件は、論理
ANDで結合されます。すべてのフィルター条件を満たすリソースのみが返されます。フィルター条件内の値は、論理ORで結合されます。フィルター条件のいずれかの値を満たすリソースが返されます。 -
その他のクエリ例については、API Explorer をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
resourcecenter:SearchResources |
list |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| NextToken |
string |
任意 |
次のリクエストで新しい結果ページを取得するために使用されるページネーショントークンです。最初のリクエストでは、このパラメーターを指定する必要はありません。前のクエリから取得したトークンを |
eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd**** |
| MaxResults |
integer |
任意 |
ページあたりの最大エントリ数です。 有効値：1～500。 デフォルト値：20。 |
10 |
| Filter |
array<object> |
任意 |
フィルター条件。 |
|
|
object |
任意 |
フィルター条件。 |
||
| Key |
string |
任意 |
フィルター条件のキー。有効な値の詳細については、後述の「 |
RegionId |
| MatchType |
string |
任意 |
一致メソッド。有効な値：
|
Equals |
| Value |
array |
任意 |
フィルター条件の値。 |
|
|
string |
任意 |
フィルター条件の値。 |
过滤条件值。 |
|
| ResourceGroupId |
string |
任意 |
リソースグループの ID。 |
rg-acfmzawhxxc**** |
| SortCriterion |
object |
任意 |
ソートパラメーター。 |
|
| Key |
string |
任意 |
ソートキー。 このパラメーターを |
CreateTime |
| Order |
string |
任意 |
ソート順。有効な値：
デフォルト値：ASC。 |
ASC |
| SearchExpression |
string |
任意 |
検索キーワード。Resource Center は、関連性に基づいて検索結果をフィルターし、ソートします。 ソートパラメーターを指定しない場合、キーワードにより一致するリソースが優先的に表示されます。 |
keywords |
| IncludeDeletedResources |
boolean |
任意 |
削除されたリソースを含めるかどうかを指定します。有効な値：
|
true |
サポートされているフィルターパラメーター
| パラメーター | 説明 | サポートされている一致メソッド |
| ResourceType | リソースタイプ。 | Equals |
| RegionId | リージョン ID。 | Equals |
| ResourceId | リソース ID。 | Equals, Prefix |
| ResourceGroupId | リソースグループ ID。 | Equals, Exists, NotExists |
| ResourceName | リソース名。 | Equals, Contains |
| Tag | タグのキーと値のペア。値は、{ "key": $key, "value": $value } 形式の JSON 文字列である必要があります。少なくともキーまたは値を指定する必要があります。たとえば、タグキー foo とタグ値 bar をクエリする場合、このパラメーターを { "key": "foo", "value": "bar" } に設定します。タグキー foo のみをクエリする場合は、このパラメーターを { "key": "foo" } に設定します。 | Contains, NotContains, NotExists |
| VpcId | VPC ID。 | Equals |
| VSwitchId | vSwitch ID。 | Equals |
| IpAddress | IP アドレス。 | Equals, Contains |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| Filters |
array<object> |
フィルター条件。 |
|
|
object |
フィルター条件。 |
||
| Key |
string |
フィルター条件のキー。 |
RegionId |
| MatchType |
string |
一致メソッド。 |
Equals |
| Values |
array |
フィルター条件の値。 |
|
|
string |
フィルター条件の値。 |
cn-hangzhou |
|
| MaxResults |
integer |
ページごとに返されるエントリの最大数。 |
10 |
| NextToken |
string |
次のリクエストで新しい結果ページを取得するために使用されるページネーショントークン。 |
eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd**** |
| RequestId |
string |
リクエスト ID。 |
D696E6EF-3A6D-5770-801E-4982081FE4D0 |
| Resources |
array<object> |
リソースに関する情報。 |
|
|
array<object> |
リソースに関する情報。 |
||
| AccountId |
string |
Alibaba Cloud アカウントの ID。 |
151266687691**** |
| CreateTime |
string |
リソースが作成された時間。 説明
このパラメーターが返されるかどうかは、リソースが属する Alibaba Cloud サービスによって異なります。 |
2021-06-30T09:20:08Z |
| ExpireTime |
string |
リソースの有効期限が切れる時間。 |
2021-07-30T09:20:08Z |
| IpAddressAttributes |
array<object> |
IP アドレスの属性。 |
|
|
object |
IP アドレスの属性。 |
||
| IpAddress |
string |
IP アドレス。 |
192.168.1.2 |
| NetworkType |
string |
ネットワークタイプ。有効な値：
|
Public |
| Version |
string |
IP アドレスのバージョン。 |
Ipv4 |
| IpAddresses |
array |
IP アドレス。 説明
このパラメーターが返されるかどうかは、リソースが属する Alibaba Cloud サービスによって異なります。 |
|
|
string |
IP アドレス。 説明
このパラメーターが返されるかどうかは、リソースが属する Alibaba Cloud サービスによって異なります。 |
192.168.1.2 |
|
| RegionId |
string |
リージョン ID。 |
cn-hangzhou |
| ResourceGroupId |
string |
リソースグループ ID。 |
rg-acfmzawhxxc**** |
| ResourceId |
string |
リソース ID。 |
vtb-bp11lbh452fr8940s**** |
| ResourceName |
string |
リソース名。 |
group1 |
| ResourceType |
string |
リソースタイプ。 |
ACS::VPC::RouteTable |
| Tags |
array<object> |
タグ。 |
|
|
object |
タグ。 |
||
| Key |
string |
タグキー。 |
test_key |
| Value |
string |
タグ値。 |
test_value |
| ZoneId |
string |
ゾーン ID。 説明
このパラメーターが返されるかどうかは、リソースが属する Alibaba Cloud サービスによって異なります。 |
cn-hangzhou-k |
| Deleted |
boolean |
リソースが削除されたかどうかを示します。有効な値：
|
true |
例
成功レスポンス
JSONJSON
{
"Filters": [
{
"Key": "RegionId",
"MatchType": "Equals",
"Values": [
"cn-hangzhou"
]
}
],
"MaxResults": 10,
"NextToken": "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****\t\n",
"RequestId": "D696E6EF-3A6D-5770-801E-4982081FE4D0",
"Resources": [
{
"AccountId": "151266687691****",
"CreateTime": "2021-06-30T09:20:08Z",
"ExpireTime": "2021-07-30T09:20:08Z",
"IpAddressAttributes": [
{
"IpAddress": "192.168.1.2",
"NetworkType": "Public",
"Version": "Ipv4"
}
],
"IpAddresses": [
"192.168.1.2"
],
"RegionId": "cn-hangzhou",
"ResourceGroupId": "rg-acfmzawhxxc****",
"ResourceId": "vtb-bp11lbh452fr8940s****",
"ResourceName": "group1",
"ResourceType": "ACS::VPC::RouteTable",
"Tags": [
{
"Key": "test_key",
"Value": "test_value"
}
],
"ZoneId": "cn-hangzhou-k",
"Deleted": true
}
]
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | NoPermission | You are not authorized to perform this operation. | |
| 400 | InvalidParameter.MaxResults | The specified parameter MaxResults is not valid. | |
| 400 | InvalidParameter.Filter.ResourceType | The specified parameter value of Filter.ResourceType is not valid. | |
| 400 | InvalidParameter.Filter.IpAddress | The specified parameter Filter.n.IpAddress is not valid. | |
| 400 | InvalidParameter.Filter.Tag | The specified parameter Filter.n.Tag is not valid. | |
| 400 | InvalidParameter.Filter.CreateTime | The specified parameter Filter.n.CreateTime is not valid. | |
| 409 | InvalidParameter.SortCriterion.Key | The specified parameter SortCriterion.Key is not valid. | |
| 409 | ExceedLimit.Filter | The maximum length of Filters is exceeded. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。