As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Implantação de automações

Depois de criar e testar suas automações no Amazon Quick Automate, a próxima etapa é implantá-las para que possam ser executadas regularmente em um gatilho. A implantação torna a automação operacional e pronta para execução. Você pode adicionar um gatilho a uma automação implantada para executá-la em um cronograma predefinido. A implantação envolve a definição das configurações de tempo de execução, a atribuição de usuários para tarefas humanas no circuito, a verificação de credenciais e integrações.

Esta seção explica cada etapa do processo de implantação e como configurar sua automação para obter confiabilidade, segurança e desempenho ideal.

Pré-requisitos

Antes de implantar sua automação, certifique-se de que as seguintes etapas estejam concluídas:

Implantando uma automação

Você pode implantar uma automação diretamente do Canvas clicando em Implantar ou navegando até a guia Implantação na página inicial da automação. Depois de iniciar a implantação, o sistema o guiará por uma série de etapas para concluir o processo de configuração e lançamento.

Detalhes do lançamento

Na página Detalhes da versão, selecione a versão da automação que você deseja implantar. Somente versões confirmadas estão disponíveis para implantação e aparecerão na lista suspensa.

Configurações adicionais

As configurações adicionais incluem:

Configuração de runtime

As configurações de tempo de execução são parâmetros que podem diferir entre ambientes, como desenvolvimento, teste e produção.

Por exemplo, uma etapa de automação que envia um e-mail pode usar seu endereço de e-mail pessoal durante o teste, mas deve mudar para um endereço de equipe compartilhado na produção. Esses valores dependentes do ambiente podem ser definidos como configurações de tempo de execução ao criar a automação.

No momento da implantação, você pode revisar e substituir essas configurações para garantir que a automação seja executada corretamente no ambiente pretendido. Os parâmetros de tempo de execução podem incluir:

Essa flexibilidade ajuda a manter uma única definição de automação em todos os ambientes, ao mesmo tempo em que adapta os principais parâmetros conforme necessário.

Tarefas

Selecione os usuários ou grupos de usuários do resolvedor para cada uma das tarefas que exigem human-in-the-loop.

Acesso (credenciais e conexões)

As automações geralmente precisam se conectar a sistemas, bancos de dados ou serviços externos. O Amazon Quick Automate fornece métodos seguros para gerenciar credenciais e conexões sem incorporar informações confidenciais em sua lógica de automação.

Os dados de conexão e credencial são armazenados e criptografados com segurança e disponibilizados para fluxos de trabalho em tempo de execução sem serem expostos aos autores ou usuários finais. Esse design garante uma forte separação dos segredos das definições de automação, melhorando a segurança e a capacidade de manutenção.

Você pode armazenar e usar dois tipos principais de credenciais:

Na implantação, certifique-se de que as credenciais e conexões corretas sejam selecionadas para que a automação possa acessar todos os sistemas necessários com segurança e sucesso.

Configurando gatilhos

Os gatilhos determinam quando e como suas automações são executadas. Você pode configurar as automações para começar com base em um cronograma predefinido ou invocá-las programaticamente por meio da API da Amazon. QuickSight

Programações

Você pode configurar as automações para serem iniciadas com base em um cronograma predefinido. Para configurar um gatilho:

Acionadores de API

As APIs do Automation Job permitem que você inicie e monitore programaticamente trabalhos de automação a partir de aplicativos externos. Você pode usar essas APIs para invocar automações implantadas com cargas de entrada personalizadas e recuperar os resultados da execução por meio do SDK e. AWS AWS CLI

As APIs do Automation Job incluem duas operações:

Essas APIs fazem parte do namespace de QuickSight serviços da Amazon. Você os acessa por meio do quicksight namespace no AWS SDK e. AWS CLI

Para obter mais informações sobre AWS SDKs e kits de ferramentas, consulte o AWS Getting Started Resource Center.

Pré-requisitos

Antes de chamar as APIs do Automation Job, conclua as etapas de configuração a seguir.

Encontre seus identificadores de automação

Para chamar as APIs do Automation Job, você precisa dos seguintes identificadores:

Você pode encontrar o ID do grupo de automação e o ID de automação na seção Implantações ao abrir qualquer automação e ter uma versão implantada.

Para encontrar seus identificadores

Configurar permissões do IAM

As APIs do Automation Job exigem permissões do IAM anexadas à sua identidade do IAM (usuário, função ou grupo). Cada operação requer uma permissão separada.

Permissão para StartAutomationJob

Anexe uma política que conceda a quicksight:StartAutomationJob ação. Defina o escopo do ARN do recurso para a automação específica que você deseja 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"
            ]
        }
    ]
}

Permissão para DescribeAutomationJob

Anexe uma política que conceda a quicksight:DescribeAutomationJob ação. O ARN do recurso para essa operação inclui o segmento de ID do trabalho. Para permitir a descrição de qualquer trabalho em uma automação, use um caractere curinga (*) para o segmento de trabalho.

{
    "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 recomenda definir o escopo de cada permissão para o ARN de recurso mais específico possível para seguir o princípio do menor privilégio. Para saber mais, consulte:

Implemente sua automação

A StartAutomationJob API tem como alvo somente automações implantadas. Você deve confirmar e implantar sua automação no console do Amazon Quick Automate antes de poder invocá-la por meio da API.

StartAutomationJob

Inicia um novo trabalho para uma automação implantada. A operação é assíncrona — o Amazon Quick Automate aceita a solicitação, coloca o trabalho em fila e retorna imediatamente. JobId A automação é executada em segundo plano. Se a automação tiver um esquema de entrada definido, o Amazon Quick Automate o valida em InputPayloadrelação ao esquema antes de aceitar o trabalho. Uma carga inválida resulta em um. InvalidParameterValueException

Sintaxe da solicitação

POST /accounts/AwsAccountId/automation-groups/AutomationGroupId/automations/AutomationId/jobs HTTP/1.1
Content-type: application/json

{
    "InputPayload": "string"
}

Parâmetros de solicitação

Elementos de resposta

Erros

Para obter mais detalhes, consulte o guia de referência da API para StartAutomationJob.

DescribeAutomationJob

Recupera o status e os detalhes de um trabalho de automação especificado, incluindo registros de data e hora de execução e cargas opcionais de entrada e saída. Use essa operação para pesquisar a conclusão do trabalho após a chamada StartAutomationJob.

A resposta não inclui cargas de entrada e saída por padrão. Defina os parâmetros IncludeInputPayloade de IncludeOutputPayloadconsulta true para solicitá-los. O Amazon Quick Automate retorna a carga de saída somente quando todas as seguintes condições são atendidas:

Sintaxe da solicitação

GET /accounts/AwsAccountId/automation-groups/AutomationGroupId/automations/AutomationId/jobs/JobId?IncludeInputPayload=boolean&IncludeOutputPayload=boolean HTTP/1.1

Parâmetros de solicitação

Campos de resposta

Erros

Para obter mais detalhes, consulte o guia de referência da API para DescribeAutomationJob.

Execute automações com acionadores de API usando entrada e saída

Você pode incluir valores de entrada como uma carga JSON ao iniciar um trabalho de automação por meio da API. O Amazon Quick Automate valida a carga em relação ao esquema de entrada da automação antes do início da execução e retorna valores de saída estruturados quando o trabalho é concluído.

Pré-requisitos

Antes de executar uma automação com acionadores de API, verifique se o seguinte está em vigor:

Envio de valores de entrada por meio da API

Para incluir valores de entrada, transmita uma carga JSON na StartAutomationJobsolicitação usando o 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"
}

Recuperando valores de saída por meio da API

Você pode recuperar os valores de saída chamando a DescribeAutomationJobAPI. Para incluir cargas de entrada e saída na resposta, defina os parâmetros de OutputPayload consulta de inclusão InputPayload e inclusão comotrue.

A resposta inclui o OutputPayloadcampo somente quando a automação é concluída com êxito.

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 e execute automações com entradas e saídas

Esta seção descreve como implantar automações que usam esquemas de entrada e saída, executá-las manualmente ou em um cronograma e visualizar os resultados da execução.

Visualize as informações do esquema antes da implantação

Antes de implantar uma automação, você deve confirmá-la para criar uma versão. Para obter mais informações, consulte Manutenção de versões de automação.

Depois de confirmar uma automação com esquemas de entrada ou saída, você pode visualizar os detalhes do esquema na seção Modelo de dados da página de detalhes da versão. Esta seção exibe as definições de campo completas para entradas e saídas.

Implemente automações com esquemas de entrada e saída

Quando você implanta uma automação com esquemas de entrada ou saída definidos, a caixa de diálogo de implantação exibe as informações do esquema na seção Modelo de dados, incluindo:

Para concluir a implantação, revise as informações do esquema e escolha Implantar.

Execute as automações implantadas manualmente

Para iniciar uma automação implantada com entradas, conclua as seguintes etapas:

O formulário de entrada é idêntico ao que você usa ao testar no Studio.

Execute automações com gatilhos programados

Para acionadores programados, você fornece valores de entrada ao criar ou editar o gatilho. Os valores armazenados são passados para a automação sempre que o gatilho é acionado.

Você pode fazer o seguinte:

Para configurar as entradas para um acionador programado, conclua as seguintes etapas:

Visualizando entradas e saídas para execuções implantadas

Após a conclusão de uma execução de automação (seja iniciada manualmente ou por um gatilho programado), os valores de entrada e saída estarão disponíveis como artefatos estruturados no painel de registros na página Execuções.

Os artefatos aparecem como cartões dedicados:

Ambas as cartas estão fechadas por padrão. Ao expandi-las, você pode: