本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListFindings
檢索由指定的分析器生成的發現項目的列表。 ListFindings 和 ListFindings V2 都access-analyzer:ListFindings
在 IAM 政策聲明的Action
元素中使用。您必須具有執行access-analyzer:ListFindings
動作的權限。
若要了解可用來擷取發現項目清單的篩選金鑰,請參閱 IAM 使用者指南中的 IAM Access Analyzer 篩選金鑰。
請求語法
POST /finding HTTP/1.1
Content-type: application/json
{
"analyzerArn": "string
",
"filter": {
"string
" : {
"contains": [ "string
" ],
"eq": [ "string
" ],
"exists": boolean
,
"neq": [ "string
" ]
}
},
"maxResults": number
,
"nextToken": "string
",
"sort": {
"attributeName": "string
",
"orderBy": "string
"
}
}
URI 請求參數
請求不會使用任何 URI 參數。
請求主體
請求接受採用 JSON 格式的下列資料。
- analyzerArn
-
要從中擷取發現項目的分析器 ARN。
類型:String
模式:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}
必要:是
- filter
-
要比對要傳回之發現項目的篩選器。
類型:字串至Criterion物件對映
必要:否
- maxResults
-
要在回應中傳回的結果數目上限。
類型:整數
必要:否
- nextToken
-
用於分頁返回的結果的令牌。
類型:字串
必要:否
- sort
-
傳回的發現項目的排序順序。
類型:SortCriteria 物件
必要:否
回應語法
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"action": [ "string" ],
"analyzedAt": "string",
"condition": {
"string" : "string"
},
"createdAt": "string",
"error": "string",
"id": "string",
"isPublic": boolean,
"principal": {
"string" : "string"
},
"resource": "string",
"resourceOwnerAccount": "string",
"resourceType": "string",
"sources": [
{
"detail": {
"accessPointAccount": "string",
"accessPointArn": "string"
},
"type": "string"
}
],
"status": "string",
"updatedAt": "string"
}
],
"nextToken": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- findings
-
從分析器擷取的發現項目清單,符合指定的篩選條件 (如果有的話)。
類型:FindingSummary 物件陣列
- nextToken
-
用於分頁返回的結果的令牌。
類型:字串
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- AccessDeniedException
-
您沒有足夠存取權可執行此動作。
HTTP 狀態碼:403
- InternalServerException
-
內部伺服器錯誤。
HTTP 狀態碼:500
- ResourceNotFoundException
-
找不到指定的資源。
HTTP 狀態碼:404
- ThrottlingException
-
節流限制超過錯誤。
HTTP 狀態碼:429
- ValidationException
-
驗證異常錯誤。
HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: