翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
-
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 を使用する方法の詳細については、以下を参照してください。