Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Recupera información sobre el hallazgo especificado. GetFinding y GetFinding V2 se utilizan `access-analyzer:GetFinding` como `Action` elemento de una declaración de política de IAM. Debe tener permiso para realizar la `access-analyzer:GetFinding` acción.

## Sintaxis de la solicitud
<a name="API_GetFindingV2_RequestSyntax"></a>

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

## Parámetros de solicitud del URI
<a name="API_GetFindingV2_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [analyzerArn](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-analyzerArn"></a>
El [ARN del analizador que generó el](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources) hallazgo.  
Patrón: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Obligatorio: sí

 ** [id](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-id"></a>
El ID del hallazgo que se va a recuperar.  
Obligatorio: sí

 ** [maxResults](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-maxResults"></a>
El número máximo de resultados que se devolverán en la respuesta.

 ** [nextToken](#API_GetFindingV2_RequestSyntax) **   <a name="accessanalyzer-GetFindingV2-request-uri-nextToken"></a>
Un token utilizado para la paginación de los resultados devueltos.

## Cuerpo de la solicitud
<a name="API_GetFindingV2_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_GetFindingV2_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [analyzedAt](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-analyzedAt"></a>
El momento en que se analizó la política basada en los recursos o la entidad de IAM que generó el hallazgo.  
Tipo: marca temporal

 ** [createdAt](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-createdAt"></a>
El momento en que se creó el hallazgo.  
Tipo: marca temporal

 ** [error](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-error"></a>
Un error.  
Tipo: cadena

 ** [findingDetails](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-findingDetails"></a>
Un mensaje localizado que explica el hallazgo y proporciona orientación sobre cómo abordarlo.  
Tipo: matriz de objetos [FindingDetails](API_FindingDetails.md)

 ** [findingType](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-findingType"></a>
El tipo del resultado. Para los analizadores de acceso externo, el tipo es `ExternalAccess`. Para los analizadores de acceso no utilizado, el tipo puede ser `UnusedIAMRole`, `UnusedIAMUserAccessKey`, `UnusedIAMUserPassword` o `UnusedPermission`. Para los analizadores de acceso interno, el tipo es `InternalAccess`.  
Tipo: cadena  
Valores válidos: `ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission | InternalAccess` 

 ** [id](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-id"></a>
El identificador del hallazgo que se va a recuperar.  
Tipo: cadena

 ** [nextToken](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-nextToken"></a>
Un token que se utiliza para la paginación de los resultados devueltos.  
Tipo: cadena

 ** [resource](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-resource"></a>
El recurso que generó el hallazgo.  
Tipo: cadena

 ** [resourceOwnerAccount](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-resourceOwnerAccount"></a>
El Cuenta de AWS ID propietario del recurso.  
Tipo: cadena

 ** [resourceType](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-resourceType"></a>
El tipo de recurso identificado en el hallazgo.  
Tipo: cadena  
Valores válidos: `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>
El estado actual del resultado.  
Tipo: cadena  
Valores válidos: `ACTIVE | ARCHIVED | RESOLVED` 

 ** [updatedAt](#API_GetFindingV2_ResponseSyntax) **   <a name="accessanalyzer-GetFindingV2-response-updatedAt"></a>
El momento en que se actualizó el hallazgo.  
Tipo: marca temporal

## Errores
<a name="API_GetFindingV2_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.  
Código de estado HTTP: 403

 ** InternalServerException **   
Error interno de servicio    
 ** retryAfterSeconds **   
Los segundos que hay que esperar para volver a intentarlo.
Código de estado HTTP: 500

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.    
 ** resourceId **   
El ID del recurso.  
 ** resourceType **   
El tipo de recurso.
Código de estado HTTP: 404

 ** ThrottlingException **   
Error al superar el límite de aceleración.    
 ** retryAfterSeconds **   
Los segundos que hay que esperar para volver a intentarlo.
Código de estado HTTP: 429

 ** ValidationException **   
Error de excepción de validación.    
 ** fieldList **   
Lista de campos que no se validaron.  
 ** reason **   
El motivo de la excepción.
Código de estado HTTP: 400

## Véase también
<a name="API_GetFindingV2_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/GetFindingV2) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/GetFindingV2)