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:

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 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:

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:

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:

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:

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.

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:

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

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:

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 InputPayloadcompará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

Elementos de respuesta

Errores

Para obtener más información, consulte la guía de referencia de la API para StartAutomationJob.

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 IncludeInputPayloadIncludeOutputPayloady consulte en true para solicitarlos. Amazon Quick Automate devuelve la carga útil de salida solo cuando se cumplen todas las condiciones siguientes:

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

Campos de respuesta

Errores

Para obtener más información, consulte la guía de referencia de la API para DescribeAutomationJob.

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:

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 StartAutomationJobsolicitud mediante el InputPayloadpará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"
}

Recuperar los valores de salida a través de la API

Puede recuperar los valores de salida llamando a la DescribeAutomationJobAPI. 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 OutputPayloadcampo 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"
}

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.

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:

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:

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:

Para configurar las entradas de un disparador programado, complete los siguientes pasos:

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:

Ambas tarjetas están contraídas de forma predeterminada. Al expandirlas, puede: