搜尋資來源目錄管理帳號和多個成員中的資源。
介面說明
僅能搜尋支援資源中心的雲端服務及資源類型。
如果您使用的是 RAM 使用者帳號或者 RAM 角色，需要被授予 SearchMultiAccountResources 介面的許可權才能執行跨帳號資源搜尋操作。更多資訊，請參見 RAM 使用者使用資源中心。
SearchMultiAccountResources 介面預設最多返回 20 條資料，您可以通過指定
MaxResults參數調整最大返回條目數。如果返回結果中不存在
NextToken，則表示沒有更多資料。否則，則表示還有更多資料。如果想要查詢後續頁，需要將 SearchMultiAccountResources 介面的NextToken參數設定為上一次返回結果中擷取到的NextToken。如果未輸入NextToken參數，查詢時預設返回第一頁的資料。通過設定一個或多個過濾條件，可以精確資源的搜尋範圍。支援的過濾參數以及匹配方式見下文。多個過濾條件之間是邏輯與
AND的關係，只有同時滿足所有過濾條件的資源才會被返回。每個過濾條件內部是邏輯或OR的關係，只要滿足任意一個過濾條件值的資源都會被返回。您可以在 樣本中心擷取更多查詢樣本。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
resourcecenter:SearchMultiAccountResources |
list |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Scope |
string |
是 |
搜尋的帳號範圍。取值：
|
rd-r4**** |
| NextToken |
string |
否 |
查詢返回結果下一頁的令牌。 當返回結果資料總條數超過 |
eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd**** |
| MaxResults |
integer |
否 |
每頁的最巨量資料條數。 取值範圍：1~100。 預設值：20。 |
10 |
| Filter |
array<object> |
否 |
過濾條件。 |
|
|
object |
否 |
過濾條件。 |
||
| Key |
string |
否 |
過濾條件鍵。取值見下方 |
ResourceGroupId |
| MatchType |
string |
否 |
匹配方式。 取值為 Equals，表示相等匹配。 |
Equals |
| Value |
array |
否 |
過濾條件值。 |
|
|
string |
否 |
過濾條件值。 |
rg-aekzmrjn4ns**** |
|
| SortCriterion |
object |
否 |
排序參數。 |
|
| Key |
string |
否 |
排序條件。 取值為 CreateTime，表示按資源建立時間排序。 |
CreateTime |
| Order |
string |
否 |
排序次序。取值：
|
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 |
| VpcId | VPC ID。 | Equals |
| VSwitchId | 交換器 ID。 | Equals |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回參數。 |
||
| Filters |
array<object> |
過濾條件。 |
|
|
object |
過濾條件。 |
||
| Key |
string |
過濾條件鍵。 |
RegionId |
| MatchType |
string |
匹配方式。 |
Equals |
| Values |
array |
過濾條件值。 |
|
|
string |
過濾條件值。 |
cn-hangzhou |
|
| MaxResults |
integer |
每頁的最巨量資料條數。 |
10 |
| NextToken |
string |
查詢返回結果下一頁的令牌。 |
查詢返回結果下一頁的令牌。 |
| RequestId |
string |
請求 ID。 |
EFA806B9-7F36-55AB-8B7A-D680C2C5EE57 |
| Resources |
array<object> |
資源資訊。 |
|
|
array<object> |
資源資訊。 |
||
| AccountId |
string |
資來源目錄管理帳號 ID 或成員帳號 ID。 |
151266687691**** |
| CreateTime |
string |
資源的建立時間。 說明
資源是否返回該參數，由所屬的雲端服務決定。 |
2021-06-30T09:20:08Z |
| ExpireTime |
string |
資源到期時間。 |
2023-06-14T14:35:45Z |
| IpAddressAttributes |
array<object> |
IP 位址屬性。 |
|
|
object |
IP 位址屬性。 |
||
| IpAddress |
string |
IP 位址。 |
192.168.1.2 |
| NetworkType |
string |
網路類型，取值：
|
Public |
| Version |
string |
IP 位址的版本。 |
Ipv4 |
| IpAddresses |
array |
IP 位址。 說明
資源是否返回該參數，由所屬的雲端服務決定。 |
|
|
string |
IP 位址。 說明
資源是否返回該參數，由所屬的雲端服務決定。 |
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。 說明
資源是否返回該參數，由所屬的雲端服務決定。 |
cn-hangzhou-k |
| Scope |
string |
搜尋的帳號範圍。取值：
|
rd-r4**** |
樣本
正常返回樣本
JSON格式
{
"Filters": [
{
"Key": "RegionId",
"MatchType": "Equals",
"Values": [
"cn-hangzhou"
]
}
],
"MaxResults": 10,
"NextToken": "查詢返回結果下一頁的令牌。",
"RequestId": "EFA806B9-7F36-55AB-8B7A-D680C2C5EE57",
"Resources": [
{
"AccountId": "151266687691****",
"CreateTime": "2021-06-30T09:20:08Z",
"ExpireTime": "2023-06-14T14:35:45Z",
"IpAddressAttributes": [
{
"IpAddress": "192.168.1.2",
"NetworkType": "Public",
"Version": "Ipv4"
}
],
"IpAddresses": [
"192.168.1.2"
],
"RegionId": "cn-hangzhou",
"ResourceGroupId": "rg-acfmzawhxxc****\t\n",
"ResourceId": "vtb-bp11lbh452fr8940s****",
"ResourceName": "group1",
"ResourceType": "ACS::VPC::RouteTable",
"Tags": [
{
"Key": "test_key",
"Value": "test_value"
}
],
"ZoneId": "cn-hangzhou-k"
}
],
"Scope": "rd-r4****\n"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | NoPermission | You are not authorized to perform this operation. | |
| 400 | InvalidParameter.MaxResults | The specified parameter MaxResults is not valid. | 參數 MaxResults 不合法。 |
| 400 | MultiAccountServiceNotEnabled | Multi account ResourceCenter service is not enabled. | |
| 400 | InvalidParameter.Filter.ResourceType | The specified parameter value of Filter.ResourceType is not valid. | |
| 400 | InvalidParameter.Filter.CreateTime | The specified parameter Filter.n.CreateTime is not valid. | 參數 Filter.n.CreateTime 不合法。 |
| 400 | InvalidParameter.Filter.IpAddress | The specified parameter Filter.n.IpAddress is not valid. | 參數 Filter.n.IpAddress 不合法。 |
| 400 | InvalidParameter.Filter.Tag | The specified parameter Filter.n.Tag is not valid. | 參數 Filter.n.Tag 不合法。 |
| 403 | NoPermission.AccountScope | The operator is not permitted for this account scope. | 目前使用者未授權操作此資來源目錄帳號範圍。 |
| 404 | NotExists.Resource | The specified resource does not exist. | 指定資源不存在。 |
| 404 | NotExists.ResourceDirectory | The resource directory for the account is not enabled. | 當前帳號未開通資來源目錄。 |
| 404 | NotExists.ResourceDirectory.FolderId | The specified folder does not exist. | 指定檔案夾不存在。 |
| 409 | InvalidParameter.Scope | The Scope is invalid. | |
| 409 | NoPermission.ResourceDirectory.MemberAccount | ResourceDirectory Member Account is not authorized to perform this operation. | |
| 409 | InvalidParameter.SortCriterion.Key | The specified parameter SortCriterion.Key is not valid. | |
| 409 | ExceedLimit.Filter | The maximum length of Filters is exceeded. | 參數 Filter 數量超出上限。 |
| 409 | ServiceNotEnabled.SpecifiedAccount | ResourceCenter service of the specified account is not enabled. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。