翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ListFindings
指定されたアナライザーによって生成された結果のリストを取得します。 ListFindings と ListFindings V2 はどちらも IAM access-analyzer:ListFindings
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
-
型: 文字列
Pattern:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*: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 の 1 つでこの API を使用する方法の詳細については、以下を参照してください。