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.

# GetFinding
<a name="API_GetFinding"></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.

**nota**  
GetFinding solo es compatible con analizadores de acceso externos. Debe utilizar la GetFinding versión 2 para los analizadores de acceso internos y los no utilizados.

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

```
GET /finding/id?analyzerArn=analyzerArn HTTP/1.1
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [analyzerArn](#API_GetFinding_RequestSyntax) **   <a name="accessanalyzer-GetFinding-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_GetFinding_RequestSyntax) **   <a name="accessanalyzer-GetFinding-request-uri-id"></a>
El ID del hallazgo que se va a recuperar.  
Obligatorio: sí

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

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<a name="API_GetFinding_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "finding": { 
      "action": [ "string" ],
      "analyzedAt": "string",
      "condition": { 
         "string" : "string" 
      },
      "createdAt": "string",
      "error": "string",
      "id": "string",
      "isPublic": boolean,
      "principal": { 
         "string" : "string" 
      },
      "resource": "string",
      "resourceControlPolicyRestriction": "string",
      "resourceOwnerAccount": "string",
      "resourceType": "string",
      "sources": [ 
         { 
            "detail": { 
               "accessPointAccount": "string",
               "accessPointArn": "string"
            },
            "type": "string"
         }
      ],
      "status": "string",
      "updatedAt": "string"
   }
}
```

## Elementos de respuesta
<a name="API_GetFinding_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.

 ** [finding](#API_GetFinding_ResponseSyntax) **   <a name="accessanalyzer-GetFinding-response-finding"></a>
`finding`Objeto que contiene los detalles de la búsqueda.  
Tipo: objeto [Finding](API_Finding.md)

## Errores
<a name="API_GetFinding_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 **   
Una 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_GetFinding_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/GetFinding) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/GetFinding) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/GetFinding)