通過SQL的Select語句根據資源屬性中的欄位精確搜尋資源。
介面說明
當您寫 SQL 的Select語句時,需要從目標資源類型的屬性檔案中擷取搜尋欄位及其類型。關於資源屬性檔案,請參見alibabacloud-config-resource-schema。
配置審計支援的所有資源類型均在資源屬性檔案中,且根據資源類型命名,例如:資源類型
ACS::ECS::Instance的屬性檔案是ACS_ECS_Instance.properties.json。資源類型對應的屬性檔案路徑為config/properties/resource-types。關於 SQL 搜尋的樣本和使用限制,請參見 SQL 搜尋樣本和 SQL 搜尋的使用限制。
本文將提供一個樣本,應用進階搜尋查詢當前帳號下所有具有標籤鍵為business且標籤值為online的資源。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
config:ListResourcesByAdvancedSearch |
list |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Sql |
string |
是 |
SQL 查詢語句。 |
SELECT ResourceId, ResourceName WHERE Tags.Kvpair='business:online' |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
D241DEBF-67A2-56AF-88CF-57BF78F0A850 |
| QueryResults |
object |
查詢結果。 |
|
| QueryResultList |
object |
查詢返回的資源清單,最大返回 1000 條資料。查看更多資料請使用搜尋檔案下載。 |
|
| Columns |
array |
搜尋返回的欄位名稱列表。 |
|
|
string |
搜尋返回的欄位名稱。 |
["ResourceId", "ResourceName"] |
|
| Values |
array |
搜尋返回的資源資料列表。 |
|
|
any |
搜尋返回的資源資料。 |
["eni-2ze5lq7xaluy5kb5****", "test-resource"] |
樣本
正常返回樣本
JSON格式
{
"RequestId": "D241DEBF-67A2-56AF-88CF-57BF78F0A850",
"QueryResults": {
"QueryResultList": {
"Columns": [
"[\"ResourceId\", \"ResourceName\"]"
],
"Values": [
"[\"eni-2ze5lq7xaluy5kb5****\", \"test-resource\"]"
]
}
}
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 404 | AccountNotExisted | Your account does not exist. | |
| 503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 服務不可用。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。