本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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 的詳細資訊，請參閱下列內容：
