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.
StartPolicyGeneration
Inicia la solicitud de generación de políticas.
Sintaxis de la solicitud
PUT /policy/generation HTTP/1.1
Content-type: application/json
{
"clientToken": "string",
"cloudTrailDetails": {
"accessRole": "string",
"endTime": "string",
"startTime": "string",
"trails": [
{
"allRegions": boolean,
"cloudTrailArn": "string",
"regions": [ "string" ]
}
]
},
"policyGenerationDetails": {
"principalArn": "string"
}
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- clientToken
-
Un identificador único con distinción entre mayúsculas y minúsculas, que se proporciona para garantizar la idempotencia de la solicitud. La idempotencia garantiza que una solicitud de API se complete solo una vez. En el caso de una solicitud idempotente, si la solicitud original se completa correctamente, los reintentos posteriores con el mismo token de cliente devuelven el resultado de la solicitud original correcta y no tienen ningún efecto adicional.
Si no especificas un token de cliente, el SDK generará uno automáticamente. AWS
Tipo: cadena
Requerido: no
- cloudTrailDetails
-
CloudTrailDetailsObjeto que contiene detalles sobre un objetoTrailque desea analizar para generar políticas.Tipo: objeto CloudTrailDetails
Obligatorio: no
- policyGenerationDetails
-
Contiene el ARN de la entidad de IAM (usuario o rol) para la que está generando una política.
Tipo: objeto PolicyGenerationDetails
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"jobId": "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.
- jobId
-
El
JobIdque devuelve laStartPolicyGenerationoperación. SeJobIdpuede usar conGetGeneratedPolicypara recuperar las políticas generadas oCancelPolicyGenerationpara cancelar la solicitud de generación de políticas.Tipo: cadena
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Tipos de errores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403
- ConflictException
-
Un error de excepción por conflicto.
- resourceId
-
El ID del recurso.
- resourceType
-
El tipo de recurso.
Código de estado HTTP: 409
- InternalServerException
-
Error interno de servicio
- retryAfterSeconds
-
Los segundos de espera para volver a intentarlo.
Código de estado HTTP: 500
- ServiceQuotaExceededException
-
Se produjo un error en la cotización del servicio.
- resourceId
-
El ID del recurso.
- resourceType
-
El tipo de recurso.
Código de estado HTTP: 402
- ThrottlingException
-
Error superado el límite de velocidad.
- retryAfterSeconds
-
Los segundos de espera 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 han validado.
- 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 AWS SDK específicos del idioma, consulta lo siguiente:
