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

# GetFindingV2
<a name="API_GetFindingV2"></a>

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

## リクエストの構文
<a name="API_GetFindingV2_RequestSyntax"></a>

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

## URI リクエストパラメータ
<a name="API_GetFindingV2_RequestParameters"></a>

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

 ** [analyzerArn](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-analyzerArn"></a>
検出結果を生成した[アナライザーの ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources)。  
パターン: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
必須: はい

 ** [id](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-id"></a>
取得する結果の ID。  
必須: はい

 ** [maxResults](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-maxResults"></a>
レスポンスで返される結果の最大数。

 ** [nextToken](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-nextToken"></a>
返された結果のページ分割に使用されるトークン。

## リクエスト本文
<a name="API_GetFindingV2_RequestBody"></a>

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

## レスポンスの構文
<a name="API_GetFindingV2_ResponseSyntax"></a>

```
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"
}
```

## レスポンス要素
<a name="API_GetFindingV2_ResponseElements"></a>

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

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

 ** [analyzedAt](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-analyzedAt"></a>
検出結果を生成したリソースベースのポリシーまたは IAM エンティティが分析された時刻。  
タイプ: タイムスタンプ

 ** [createdAt](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-createdAt"></a>
検出結果が作成された時刻。  
タイプ: タイムスタンプ

 ** [error](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-error"></a>
エラー。  
タイプ: 文字列

 ** [findingDetails](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-findingDetails"></a>
検出結果について説明し、それに対処する方法についてのガイダンスを提供するローカライズされたメッセージ。  
型: [FindingDetails](API_FindingDetails.md) オブジェクトの配列

 ** [findingType](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-findingType"></a>
 結果のタイプ。外部アクセスアナライザーの場合、タイプは `ExternalAccess` です。未使用のアクセスアナライザーの場合、タイプは `UnusedIAMRole`、`UnusedIAMUserAccessKey`、`UnusedIAMUserPassword`、または `UnusedPermission` です。内部アクセスアナライザーの場合、タイプは `InternalAccess` です。  
型: 文字列  
有効な値：`ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission | InternalAccess`

 ** [id](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-id"></a>
取得する結果の ID。  
タイプ: 文字列

 ** [nextToken](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-nextToken"></a>
返された結果のページ分割に使用されるトークン。  
タイプ: 文字列

 ** [resource](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-resource"></a>
検出結果を生成したリソース。  
タイプ: 文字列

 ** [resourceOwnerAccount](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-resourceOwnerAccount"></a>
リソースを所有する Tye AWS アカウント ID。  
タイプ: 文字列

 ** [resourceType](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-resourceType"></a>
検出結果で識別されるリソースのタイプ。  
型: 文字列  
有効な値：`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 | AWS::IAM::User`

 ** [status](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-status"></a>
調査結果のステータス。  
型: 文字列  
有効な値：`ACTIVE | ARCHIVED | RESOLVED`

 ** [updatedAt](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-updatedAt"></a>
検出結果が更新された時刻。  
タイプ: タイムスタンプ

## エラー
<a name="API_GetFindingV2_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
このアクションを実行する十分なアクセス権限がありません。  
HTTP ステータスコード: 403

 ** InternalServerException **   
内部サーバーエラー。    
 ** retryAfterSeconds **   
再試行を待機する秒数。
HTTP ステータスコード: 500

 ** ResourceNotFoundException **   
指定したリソースが見つかりませんでした。    
 ** resourceId **   
リソースの ID。  
 ** resourceType **   
リソースのタイプ。
HTTP ステータスコード: 404

 ** ThrottlingException **   
スロットリング制限超過エラー。    
 ** retryAfterSeconds **   
再試行を待機する秒数。
HTTP ステータスコード: 429

 ** ValidationException **   
検証例外エラー。    
 ** fieldList **   
が検証しなかったフィールドのリスト。  
 ** reason **   
例外の理由。
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_GetFindingV2_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/GetFindingV2)