StartPolicyGeneration - IAM Access Analyzer
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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. Con 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

Un CloudTrailDetails objeto que contiene detalles sobre un objeto Trail que 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 JobId que devuelve la StartPolicyGeneration operación. JobIdSe puede usar con GetGeneratedPolicy para recuperar las políticas generadas o se puede usar con CancelPolicyGeneration para 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 Errores comunes.

AccessDeniedException

No tiene acceso suficiente para realizar esta acción.

Código de estado HTTP: 403

ConflictException

Error de excepción de conflicto.

Código de estado HTTP: 409

InternalServerException

Error interno de servicio

Código de estado HTTP: 500

ServiceQuotaExceededException

Se encontró un error en la cotización del servicio.

Código de estado HTTP: 402

ThrottlingException

Error al superar el límite de regulación.

Código de estado HTTP: 429

ValidationException

Error en la excepción de validació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: