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.
GetFindingRecommendation
Recupera información sobre una recomendación de hallazgo para el analizador especificado.
Sintaxis de la solicitud
GET /recommendation/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- analyzerArn
-
El ARN del analizador utilizado para generar la recomendación de hallazgo.
Patrón:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Obligatorio: sí
- id
-
El identificador único de la recomendación de búsqueda.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Obligatorio: sí
- maxResults
-
El número máximo de resultados que se devolverán en la respuesta.
Rango válido: valor mínimo de 1. Valor máximo de 1000.
- nextToken
-
Un token que se utiliza para la paginación de los resultados devueltos.
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"completedAt": "string",
"error": {
"code": "string",
"message": "string"
},
"nextToken": "string",
"recommendationType": "string",
"recommendedSteps": [
{ ... }
],
"resourceArn": "string",
"startedAt": "string",
"status": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- completedAt
-
El momento en el que se completó la recuperación de la recomendación de hallazgo.
Tipo: marca temporal
- error
-
Información detallada sobre el motivo por el que no se pudo recuperar una recomendación para la constatación.
Tipo: objeto RecommendationError
- nextToken
-
Un token utilizado para la paginación de los resultados devueltos.
Tipo: cadena
- recommendationType
-
El tipo de recomendación para el hallazgo.
Tipo: cadena
Valores válidos:
UnusedPermissionRecommendation - recommendedSteps
-
Un grupo de pasos recomendados para el hallazgo.
Tipo: matriz de objetos RecommendedStep
- resourceArn
-
El ARN del recurso del hallazgo.
Tipo: cadena
Patrón:
arn:[^:]*:[^:]*:[^:]*:[^:]*:.* - startedAt
-
El momento en que se inició la recuperación de la recomendación de hallazgo.
Tipo: marca temporal
- status
-
El estado de la recuperación de la recomendación de conclusión.
Tipo: cadena
Valores válidos:
SUCCEEDED | FAILED | IN_PROGRESS
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- 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 se deben 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
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
