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.
# Implementación de automatizaciones
Tras crear y probar las automatizaciones en Amazon Quick Automate, el siguiente paso es **implementarlas** para que puedan ejecutarse con regularidad en un disparador. La implementación hace que la automatización sea operativa y esté lista para su ejecución. Puede añadir un activador a una automatización implementada para ejecutarla según un cronograma predefinido. La implementación implica configurar los ajustes de tiempo de ejecución, asignar a los usuarios tareas informales y verificar las credenciales y las integraciones.
En esta sección se explica cada paso del proceso de despliegue y cómo configurar la automatización para garantizar la fiabilidad, la seguridad y un rendimiento óptimo.
## Requisitos previos
Antes de implementar la automatización, asegúrese de completar los siguientes pasos:
+ **La automatización se prueba exhaustivamente**: valide su automatización mediante pruebas integrales para confirmar que toda la lógica, las acciones y las interacciones entre los agentes funcionan según lo esperado.
+ **Versión comprometida para su implementación**: solo se pueden implementar las versiones de automatización comprometidas. Revise los cambios, finalice la versión y confírmela antes de continuar.
+ **Integraciones configuradas**: si tu automatización interactúa con aplicaciones externas como Salesforce o Jira a través de las API, asegúrate de que estén configuradas todas las integraciones necesarias.
+ Ve a **Conexiones → Integraciones** en el panel izquierdo para crear nuevas integraciones.
+ Actualmente, Amazon Quick Automate solo admite las integraciones disponibles en la pestaña **Acciones**.
+ Una vez creada una acción de integración, asóciela al **grupo de automatización** en el que se utilizará.
+ Las acciones asociadas aparecerán entonces en el lienzo. Durante el despliegue, puede seleccionar la conexión adecuada que utilizará la automatización desplegada.
+ **Credenciales configuradas**: compruebe que todas las credenciales requeridas por la automatización estén configuradas correctamente.
## Implementación de una automatización
Puede implementar una automatización directamente desde Canvas haciendo clic en Implementar o navegando a la pestaña Implementación en la página de inicio de la automatización. Una vez que inicie la implementación, el sistema lo guiará a través de una serie de pasos para completar el proceso de configuración y lanzamiento.
### Detalles del lanzamiento
En la página de **detalles** de la versión, seleccione la versión de la automatización que desee implementar. Solo **las versiones confirmadas** están disponibles para su implementación y aparecerán en la lista desplegable.
### Ajustes adicionales
Los ajustes adicionales incluyen:
+ **Configuración en tiempo de ejecución**
+ **Tareas (para asignaciones de HITL)**
+ **Acceso**
#### Configuración del tiempo de ejecución
Las configuraciones de tiempo de ejecución son parámetros que pueden diferir entre entornos como el desarrollo, las pruebas y la producción.
Por ejemplo, un paso de automatización que envía un correo electrónico puede utilizar tu dirección de correo electrónico personal durante las pruebas, pero debería cambiar a una dirección de equipo compartida en producción. Estos valores que dependen del entorno se pueden definir como **configuraciones de tiempo de ejecución** al crear la automatización.
En el momento de la implementación, puede revisar y anular estas configuraciones para garantizar que la automatización se ejecute correctamente en el entorno previsto. Los parámetros de tiempo de ejecución pueden incluir:
+ Direcciones de correo electrónico o destinatarios de notificaciones
+ Rutas de archivos o URL específicas del entorno
Esta flexibilidad ayuda a mantener una definición de automatización única en todos los entornos y, al mismo tiempo, adapta los parámetros clave según sea necesario.
#### Tareas
Seleccione los usuarios o grupos de usuarios de la resolución para cada una de las tareas que requieren la intervención de una persona al día.
#### Acceso (credenciales y conexiones)
Las automatizaciones suelen necesitar conectarse a sistemas, bases de datos o servicios externos. Amazon Quick Automate proporciona métodos seguros para administrar las credenciales y las conexiones sin incluir información confidencial en la lógica de automatización.
Los datos de conexión y credenciales se almacenan y cifran de forma segura, y se ponen a disposición de los flujos de trabajo en tiempo de ejecución sin exponerlos a los autores o usuarios finales. Este diseño garantiza una fuerte separación entre los secretos y las definiciones de automatización, lo que mejora tanto la seguridad como la facilidad de mantenimiento.
Puede almacenar y usar dos tipos principales de credenciales:
+ **Credenciales del sitio web**: se utilizan para los pasos de automatización de la interfaz de usuario que requieren iniciar sesión en el sitio web (nombre de usuario y contraseña).
+ **Credenciales de acción (integraciones)**: se utilizan para conectar AWS servicios (por ejemplo, S3) o sistemas externos mediante integraciones configuradas (por ejemplo, Salesforce o Jira).
En el momento de la implementación, asegúrese de seleccionar las credenciales y conexiones correctas para que la automatización pueda acceder a todos los sistemas necesarios de forma segura y correcta.
## Configuración de los activadores
Los activadores determinan cuándo y cómo se ejecutan tus automatizaciones. Puedes configurar las automatizaciones para que se inicien según un cronograma predefinido o invocarlas mediante programación a través de la API de Amazon. QuickSight
### Programas
Puede configurar las automatizaciones para que se inicien en función de un cronograma predefinido. Para configurar un disparador:
+ En la página de despliegue, haga clic en «Crear activador» y configure las reglas.
+ Seleccione la frecuencia
+ Seleccione la fecha y la hora de inicio (tenga en cuenta que la ejecución real se iniciará 15 minutos después de la hora de inicio seleccionada)
+ Seleccione la fecha y la hora de finalización
+ Selecciona la zona horaria
+ Amazon Quick Automate ofrecía escalabilidad integrada. Seleccione el número de ejecuciones paralelas de la automatización (puede seleccionar un máximo de 10 ejecuciones paralelas por activador y 50 en todas las automatizaciones de una cuenta). Póngase en contacto con) AWS
+ Para necesidades de programación complejas, puedes usar expresiones cron para definir patrones de ejecución precisos. Por ejemplo, para ejecutar una automatización a las 2:30 a.m. todos los lunes, miércoles y viernes, usaría la expresión cron:. `30 2 * * 1,3,5`
### Activadores de API
Las API de Automation Job le permiten iniciar y supervisar mediante programación los trabajos de automatización desde aplicaciones externas. Puede usar estas API para invocar las automatizaciones implementadas con cargas útiles de entrada personalizadas y recuperar los resultados de la ejecución a través del SDK y. AWS AWS CLI
Las API de Automation Job incluyen dos operaciones:
+ **StartAutomationJob**— Inicia un nuevo trabajo para una automatización implementada con una carga útil de entrada opcional.
+ **DescribeAutomationJob**— Recupera el estado, las marcas de tiempo y las cargas útiles de entrada y salida opcionales para un trabajo específico.
Estas API forman parte del espacio de nombres del QuickSight servicio de Amazon. Puede acceder a ellas a través del espacio de `quicksight` nombres del SDK y. AWS AWS CLI
Para obtener más información sobre AWS los SDK y los kits de herramientas, consulta el Centro de recursos de [AWS introducción](https://aws.amazon.com/getting-started/tools-sdks/).
#### Requisitos previos
Antes de llamar a las API de Automation Job, complete los siguientes pasos de configuración.
##### Encuentra tus identificadores de automatización
Para llamar a las API de Automation Job, necesitas los siguientes identificadores:
+ **AWS ID de cuenta**: su ID de AWS cuenta de 12 dígitos.
+ **ID del grupo de automatización**: el ID único del grupo de automatización que contiene tu automatización.
+ **ID de automatización**: el ID único de la automatización que quieres invocar.
Puedes encontrar el ID del grupo de automatización y el ID de automatización en la sección Implementaciones cuando abras cualquier automatización y tengas una versión implementada.
**Para encontrar tus identificadores**
+ Inicia sesión en Amazon Quick Automate.
+ En el panel de navegación izquierdo, selecciona **Automatizaciones.**
+ Elija el grupo de automatizaciones que contiene su automatización.
+ Elija el nombre de la automatización para abrir el editor de automatización.
+ Elija la pestaña **Implementaciones**.
+ Seleccione **Acciones ()** y **Ver detalles de la implementación** para obtener el ID de **automatización y el ID** de **grupo** en la parte superior, justo debajo del encabezado Detalles de implementación.
##### Configurar los permisos de IAM
Las API de Automation Job requieren permisos de IAM asociados a su identidad de IAM (usuario, función o grupo). Cada operación requiere un permiso independiente.
**Permiso para StartAutomationJob**
Adjunta una política que conceda la `quicksight:StartAutomationJob` acción. Limite el ARN del recurso a la automatización específica que desee permitir.
```
{
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "AllowStartAutomationJob",
"Effect": "Allow",
"Action": [
"quicksight:StartAutomationJob"
],
"Resource": [
"arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
]
}
]
}
```
**Permiso para DescribeAutomationJob**
Adjunta una política que conceda la `quicksight:DescribeAutomationJob` acción. El ARN del recurso para esta operación incluye el segmento de ID de trabajo. Para poder describir cualquier trabajo en el marco de una automatización, utilice un comodín (\*) para el segmento de trabajo.
```
{
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "AllowDescribeAutomationJob",
"Effect": "Allow",
"Action": [
"quicksight:DescribeAutomationJob"
],
"Resource": [
"arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
]
}
]
}
```
AWS recomienda limitar cada permiso al ARN de recurso más específico posible para seguir el principio del privilegio mínimo. Para obtener más información, consulte los siguientes temas:
+ [Ejemplos de políticas de IAM para Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)
+ [Claves de condiciones, recursos y acciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)
+ [Elementos de la política JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)
##### Implemente su automatización
La StartAutomationJob API se dirige únicamente a las automatizaciones implementadas. Debe confirmar e implementar la automatización en la consola de Amazon Quick Automate antes de poder invocarla a través de la API.
#### StartAutomationJob
Inicia un nuevo trabajo para una automatización implementada. La operación es asíncrona: Amazon Quick Automate acepta la solicitud, pone en cola el trabajo y devuelve un inmediatamente. **JobId** La automatización se ejecuta en segundo plano. Si la automatización tiene un esquema de entrada definido, Amazon Quick Automate lo valida **InputPayload**comparándolo con el esquema antes de aceptar el trabajo. Una carga útil no válida da como resultado un. **InvalidParameterValueException**
##### Sintaxis de la solicitud
```
POST /accounts/{{AwsAccountId}}/automation-groups/{{AutomationGroupId}}/automations/{{AutomationId}}/jobs HTTP/1.1
Content-type: application/json
{
"InputPayload": "string"
}
```
##### Parámetros de solicitud
+ **AwsAccountId**(Cadena, obligatoria): tu ID de AWS cuenta (12 dígitos).
+ **AutomationGroupId**(Cadena, obligatorio): el ID del grupo de automatización (UUID).
+ **AutomationId**(Cadena, obligatorio): el ID de la automatización que se va a ejecutar (UUID).
+ **InputPayload**(Cadena, opcional): entrada para el trabajo como cadena JSON.
##### Elementos de respuesta
+ **Arn** (String): ARN del trabajo de automatización.
+ **JobId**(String): ID del trabajo iniciado. Úselo `DescribeAutomationJob` para realizar un seguimiento del estado.
+ **Estado** (entero): código de estado HTTP de la respuesta.
+ **RequestId**(String): ID de AWS solicitud.
##### Errores
+ **AccessDeniedException**— Permisos insuficientes o credenciales no válidas.
+ **InvalidParameterValueException**— Uno o más parámetros tienen un valor que no es válido.
+ **ResourceNotFoundException**— No se encontró el grupo de automatización o la automatización.
+ **LimitExceededException**— Se ha superado un límite.
+ **ThrottlingException**— La solicitud se ha limitado.
+ **InternalFailureException**— Error de servicio interno.
Para obtener más información, consulte la [guía de referencia de la API para StartAutomationJob](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_StartAutomationJob.html).
#### DescribeAutomationJob
Recupera el estado y los detalles de un trabajo de automatización específico, incluidas las marcas de tiempo de ejecución y las cargas útiles de entrada y salida opcionales. Utilice esta operación para comprobar si se ha completado el trabajo después de la llamada. **StartAutomationJob**
La respuesta no incluye las cargas útiles de entrada y salida de forma predeterminada. Defina los parámetros **IncludeInputPayload**IncludeOutputPayload****y consulte en `true` para solicitarlos. Amazon Quick Automate devuelve la carga útil de salida solo cuando se cumplen todas las condiciones siguientes:
+ **IncludeOutputPayload** es `true`.
+ **JobStatus** es `SUCCEEDED`.
+ La automatización produjo valores de salida.
##### Sintaxis de la solicitud
```
GET /accounts/{{AwsAccountId}}/automation-groups/{{AutomationGroupId}}/automations/{{AutomationId}}/jobs/{{JobId}}?IncludeInputPayload={{boolean}}&IncludeOutputPayload={{boolean}} HTTP/1.1
```
##### Parámetros de solicitud
+ **AwsAccountId**(Cadena, obligatorio): el identificador de su AWS cuenta (12 dígitos).
+ **AutomationGroupId**(Cadena, obligatorio): el ID del grupo de automatización (UUID).
+ **AutomationId**(Cadena, obligatorio): el ID de la automatización (UUID).
+ **JobId**(Cadena, obligatorio): el ID del trabajo devuelto por `StartAutomationJob` (UUID).
+ **IncludeInputPayload**(Booleano, opcional): incluye la carga útil de entrada en la respuesta. Predeterminado: `false`.
+ **IncludeOutputPayload**(Booleano, opcional): incluye la carga útil de salida en la respuesta. Predeterminado: `false`.
##### Campos de respuesta
+ **Arn** (String): ARN del trabajo de automatización.
+ **CreatedAt**(Marca de tiempo): cuándo se creó el trabajo (segundos de época).
+ **StartedAt**(Marca de tiempo): cuando la tarea comenzó a ejecutarse (segundos de época).
+ **EndedAt**(Marca de tiempo): cuando finalizó el trabajo (segundos de época).
+ **JobStatus**(Cadena) —`QUEUED`,, `RUNNING``SUCCEEDED`, `FAILED` o. `STOPPED`
+ **InputPayload**(String): la carga útil de entrada. Se omite en la respuesta a menos que lo esté`IncludeInputPayload`. `true`
+ **OutputPayload**(String): la carga útil de salida. Se omite en la respuesta a menos que sea`IncludeOutputPayload`. `true`
+ **RequestId**(String): ID de AWS solicitud.
##### Errores
+ **AccessDeniedException**— Permisos insuficientes o credenciales no válidas.
+ **InvalidParameterValueException**— Uno o más parámetros tienen un valor que no es válido.
+ **ResourceNotFoundException**— No se encontró el trabajo, la automatización o el grupo de automatización.
+ **ThrottlingException**— La solicitud se ha limitado.
+ **InternalFailureException**— Error de servicio interno.
Para obtener más información, consulte la [guía de referencia de la API para DescribeAutomationJob](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeAutomationJob.html).
## Ejecute automatizaciones con activadores de API mediante entradas y salidas
Puedes incluir valores de entrada como carga útil de JSON al iniciar un trabajo de automatización a través de la API. Amazon Quick Automate valida la carga útil comparándola con el esquema de entrada de la automatización antes de que comience la ejecución y devuelve valores de salida estructurados cuando se completa el trabajo.
### Requisitos previos
Antes de ejecutar una automatización con activadores de API, asegúrese de que se cumpla lo siguiente:
+ La automatización está implementada.
+ La automatización tiene un esquema de entrada definido en el nodo de inicio.
+ Tiene el ID del grupo de automatización y el ID de automatización.
### Envío de valores de entrada a través de la API
Para incluir los valores de entrada, pasa una carga útil JSON a la **StartAutomationJob**solicitud mediante el **InputPayload**parámetro.
```
Sample Request
POST /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs
{
"InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}"
}
Sample Response
{
"Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"JobId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"Status": 200,
"RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}
```
**nota**
El `InputPayload` valor debe ser una JSON-serialized cadena que contenga los valores de los campos de entrada que coincidan con el esquema de entrada de tu automatización.
### Recuperar los valores de salida a través de la API
Puede recuperar los valores de salida llamando a la **DescribeAutomationJob**API. Para incluir las cargas útiles de entrada y salida en la respuesta, defina los parámetros de OutputPayload consulta **incluir InputPayload** **e incluir** en. `true`
La respuesta incluye el **OutputPayload**campo solo cuando la automatización se completa correctamente.
```
Sample Request
GET /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?includeInputPayload=true&includeOutputPayload=true
Sample Response
{
"Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"JobStatus": "SUCCEEDED",
"CreatedAt": "2026-03-11T09:59:50Z",
"StartedAt": "2026-03-11T10:00:00Z",
"EndedAt": "2026-03-11T10:05:00Z",
"InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}",
"OutputPayload": "{\"result\":\"success\",\"records_processed\":42,\"summary\":{\"passed\":40,\"failed\":2}}",
"RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}
```
**nota**
El **OutputPayload**campo solo está disponible después de que la automatización se complete correctamente (cuando **JobStatus**lo esté`SUCCEEDED`). Si la automatización falla o sigue ejecutándose, la respuesta no incluye el **OutputPayload**campo.
## Implemente y ejecute automatizaciones con entradas y salidas
En esta sección se describe cómo implementar automatizaciones que utilizan esquemas de entrada y salida, cómo ejecutarlas manualmente o según una programación y cómo ver los resultados de la ejecución.
### Consulte la información del esquema antes de la implementación
Antes de implementar una automatización, debes comprometerla a crear una versión. Para obtener más información, consulte [Mantenimiento de las versiones de automatización](https://docs.aws.amazon.com/quicksuite/latest/userguide/building-automations.html#managing-automation-versions).
Después de ejecutar una automatización con esquemas de entrada o salida, puede ver los detalles del esquema en la sección **Modelo de datos** de la página de detalles de la versión. En esta sección se muestran las definiciones de campo completas para las entradas y las salidas.
### Implemente automatizaciones con esquemas de entrada y salida
Al implementar una automatización que tiene esquemas de entrada o salida definidos, el cuadro de diálogo de despliegue muestra la información del esquema en la sección del **modelo de datos**, que incluye:
+ Definiciones de campos de entrada y salida (nombre, tipo de datos, descripción, estado obligatorio u opcional y valores predeterminados).
+ Esquemas JSON copiables para entradas y salidas que las personas que llaman a la API pueden usar para la integración.
**importante**
El esquema se congela en el momento de la implementación junto con el código de automatización. Si actualiza el esquema después de la implementación, debe volver a implementar la automatización para que los cambios surtan efecto.
**Para completar la implementación, revise la información del esquema y elija Implementar.**
### Ejecute manualmente las automatizaciones implementadas
Para iniciar una automatización implementada con entradas, complete los siguientes pasos:
+ En la página de despliegue, seleccione el menú **Acciones** (※).
+ Selecciona **Ejecutar ahora**.
+ En el cuadro de diálogo **Proporcionar valores de entrada**, introduzca valores para cada campo de entrada.
+ Seleccione **Iniciar** para iniciar la ejecución de automatización.
El formulario de entrada es idéntico al que se utiliza al realizar las pruebas en Studio.
### Ejecuta automatizaciones con activadores programados
En el caso de los activadores programados, los valores de entrada se proporcionan al crear o editar el activador. Los valores almacenados se pasan a la automatización cada vez que se activa el disparador.
Se puede hacer lo siguiente:
+ Cree varios disparadores con valores de entrada diferentes para la misma automatización
+ Edite los valores de entrada de un disparador sin volver a implementar la automatización
Para configurar las entradas de un disparador programado, complete los siguientes pasos:
+ Navegue hasta la página de implementación de su automatización.
+ Seleccione **Crear activador**.
+ En el **paso 1: Establecer el disparador**, configure la programación.
+ En el **paso 2: Definir la ejecución**, introduzca valores para cada campo de entrada del formulario generado automáticamente.
+ Seleccione **Siguiente**, revise la configuración y elija **Crear disparador**.
**nota**
Si crea un disparador con una versión de esquema específica y luego implementa la automatización con un esquema actualizado, debe modificar el disparador. El desencadenador deja de ser compatible cuando la versión del esquema cambia y las ejecuciones de automatización fallan.
### Visualización de las entradas y salidas de las ejecuciones implementadas
Una vez completada una ejecución de automatización (ya sea que se inicie manualmente o mediante un activador programado), los valores de entrada y salida están disponibles como artefactos estructurados en el panel de registros de la página **Ejecuciones**.
Los artefactos aparecen como cartas dedicadas:
+ **Artefacto de entrada**: se muestra en la parte superior del panel de registros
+ **Artefacto de salida**: se muestra en la parte inferior del panel de registros (solo está disponible si la automatización se completa correctamente)
Ambas tarjetas están contraídas de forma predeterminada. Al expandirlas, puede:
+ Ver el esquema completo y los valores reales
+ Descargue cualquier objeto de archivo incluido en las entradas o salidas
+ Copie los datos estructurados como JSON
+ Descarga la carga completa como un archivo JSON