ListFindings - IAM Access Analyzer

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

結果を取得するアナライザーの ARN

型: 文字列

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 を使用する方法の詳細については、以下を参照してください。