GetFindingV2 - IAM Access Analyzer

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

GetFindingV2

指定された結果に関する情報を取得します。 GetFinding と GetFinding V2 はどちらも IAM access-analyzer:GetFinding Action ポリシーステートメントの要素で使用します。アクションを実行するには権限が必要です。access-analyzer:GetFinding

リクエストの構文

GET /findingv2/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

analyzerArn

結果を生成したアナライザーの ARN

Pattern: [^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

必須:はい

id

取得する結果の ID。

必須: はい

maxResults

レスポンスで返される結果の最大数。

nextToken

返された結果をページ分割するために使用されるトークン。

リクエスト本文

リクエストにリクエスト本文がありません。

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "analyzedAt": "string", "createdAt": "string", "error": "string", "findingDetails": [ { ... } ], "findingType": "string", "id": "string", "nextToken": "string", "resource": "string", "resourceOwnerAccount": "string", "resourceType": "string", "status": "string", "updatedAt": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

analyzedAt

結果を生成したリソースベースのポリシーまたは IAM エンティティが分析された日時。

型: タイムスタンプ

createdAt

結果が作成された日時。

型: タイムスタンプ

error

エラー。

型: 文字列

findingDetails

検出結果を説明し、対処方法に関するガイダンスを提供するローカライズされたメッセージ。

型: FindingDetails オブジェクトの配列

findingType

結果のタイプ。外部アクセスアナライザーの場合、タイプはです。ExternalAccess未使用のアクセスアナライザーの場合、タイプは、、、またはになります。UnusedIAMRole UnusedIAMUserAccessKey UnusedIAMUserPassword UnusedPermission

型: 文字列

有効な値:ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission

id

取得する結果の ID。

型: 文字列

nextToken

返された結果のページ分割に使用されるトークン。

型: 文字列

resource

結果を生成したリソース。

型: 文字列

resourceOwnerAccount

リソースを所有する AWS アカウント ID。

型: 文字列

resourceType

結果で特定されたリソースのタイプ。

型: 文字列

有効な値:AWS::S3::Bucket | AWS::IAM::Role | AWS::SQS::Queue | AWS::Lambda::Function | AWS::Lambda::LayerVersion | AWS::KMS::Key | AWS::SecretsManager::Secret | AWS::EFS::FileSystem | AWS::EC2::Snapshot | AWS::ECR::Repository | AWS::RDS::DBSnapshot | AWS::RDS::DBClusterSnapshot | AWS::SNS::Topic | AWS::S3Express::DirectoryBucket | AWS::DynamoDB::Table | AWS::DynamoDB::Stream

status

調査結果のステータス。

型: 文字列

有効な値:ACTIVE | ARCHIVED | RESOLVED

updatedAt

結果が更新された日時。

型: タイムスタンプ

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AccessDeniedException

このアクションを実行する十分なアクセス権限がありません。

HTTP ステータスコード: 403

InternalServerException

内部サーバーエラー。

HTTP ステータスコード:500

ResourceNotFoundException

指定したリソースが見つかりませんでした。

HTTP ステータスコード: 404

ThrottlingException

スロットリング制限超過エラー。

HTTP ステータスコード: 429

ValidationException

検証例外エラー。

HTTP ステータスコード:400

その他の参照資料

言語固有の AWS SDK の 1 つでこの API を使用する方法の詳細については、以下を参照してください。