Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Implementazione di automazioni

Dopo aver creato e testato le automazioni in Amazon Quick Automate, il passaggio successivo consiste nel distribuirle in modo che possano essere eseguite regolarmente su un trigger. L'implementazione rende l'automazione operativa e pronta per l'esecuzione. È possibile aggiungere un trigger a un'automazione distribuita per eseguirla secondo una pianificazione predefinita. L'implementazione prevede la configurazione delle impostazioni di runtime, l'assegnazione degli utenti per le attività di tipo human-in-the-loop, la verifica delle credenziali e delle integrazioni.

Questa sezione spiega ogni fase del processo di distribuzione e come configurare l'automazione per garantire affidabilità, sicurezza e prestazioni ottimali.

Prerequisiti

Prima di implementare l'automazione, assicurati che i seguenti passaggi siano stati completati:

Implementazione di un'automazione

Puoi implementare un'automazione direttamente da Canvas facendo clic su Deploy o accedendo alla scheda Deployment nella pagina di destinazione dell'automazione. Una volta avviata la distribuzione, il sistema guida l'utente attraverso una serie di passaggi per completare il processo di configurazione e rilascio.

Dettagli sulla versione

Nella pagina Dettagli sulla versione, seleziona la versione dell'automazione che desideri distribuire. Solo le versioni impegnate sono disponibili per la distribuzione e verranno visualizzate nell'elenco a discesa.

Impostazioni aggiuntive

Le impostazioni aggiuntive includono:

Configurazione di runtime

Le configurazioni di runtime sono parametri che possono differire tra ambienti come sviluppo, test e produzione.

Ad esempio, una fase di automazione che invia un'e-mail può utilizzare il tuo indirizzo e-mail personale durante il test, ma dovrebbe passare a un indirizzo condiviso del team in produzione. Tali valori dipendenti dall'ambiente possono essere definiti come configurazioni di runtime durante la creazione dell'automazione.

Al momento dell'implementazione, è possibile rivedere e sovrascrivere queste configurazioni per garantire che l'automazione funzioni correttamente nell'ambiente previsto. I parametri di runtime possono includere:

Questa flessibilità aiuta a mantenere un'unica definizione di automazione tra gli ambienti, adattando al contempo i parametri chiave in base alle esigenze.

Processi

Seleziona gli utenti o i gruppi di utenti del resolver per ciascuna delle attività che richiedono l'approccio human-in-the-loop.

Accesso (credenziali e connessioni)

Le automazioni spesso devono connettersi a sistemi, database o servizi esterni. Amazon Quick Automate offre metodi sicuri per la gestione di credenziali e connessioni senza incorporare informazioni sensibili nella logica di automazione.

I dati di connessione e le credenziali vengono archiviati e crittografati in modo sicuro e resi disponibili ai flussi di lavoro in fase di esecuzione senza esporli agli autori o agli utenti finali. Questo design garantisce una forte separazione dei segreti dalle definizioni di automazione, migliorando sia la sicurezza che la manutenibilità.

È possibile archiviare e utilizzare due tipi principali di credenziali:

Al momento dell'implementazione, assicurati che siano selezionate le credenziali e le connessioni corrette in modo che l'automazione possa accedere a tutti i sistemi richiesti in modo sicuro e corretto.

Configurazione dei trigger

I trigger determinano quando e come vengono eseguite le automazioni. Puoi configurare le automazioni per avviarle in base a una pianificazione predefinita o richiamarle a livello di codice tramite l'API Amazon. QuickSight

Piani

Puoi configurare le automazioni in modo che vengano avviate in base a una pianificazione predefinita. Per configurare un trigger:

Trigger API

Le API Automation Job consentono di avviare e monitorare in modo programmatico i lavori di automazione da applicazioni esterne. Puoi utilizzare queste API per richiamare automazioni distribuite con payload di input personalizzati e recuperare i risultati di esecuzione tramite SDK e. AWS AWS CLI

Le API Automation Job includono due operazioni:

Queste API fanno parte del namespace del QuickSight servizio Amazon. Puoi accedervi tramite lo spazio dei quicksight nomi nell'SDK e. AWS AWS CLI

Per ulteriori informazioni su AWS SDK e toolkit, consulta il Getting Started Resource Center.AWS

Prerequisiti

Prima di chiamare le API di Automation Job, completa i seguenti passaggi di configurazione.

Trova i tuoi identificatori di automazione

Per chiamare le API di Automation Job, sono necessari i seguenti identificatori:

Puoi trovare l'ID del gruppo di automazione e l'ID di automazione nella sezione Distribuzioni quando apri un'automazione e disponi di una versione distribuita.

Per trovare i tuoi identificatori

Configurazione delle autorizzazioni IAM

Le API Automation Job richiedono autorizzazioni IAM associate alla tua identità IAM (utente, ruolo o gruppo). Ogni operazione richiede un'autorizzazione separata.

Autorizzazione per StartAutomationJob

Allega una politica che autorizzi l'quicksight:StartAutomationJobazione. Inquadra l'ARN della risorsa in base all'automazione specifica che desideri consentire.

{
    "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"
            ]
        }
    ]
}

Autorizzazione per DescribeAutomationJob

Allega una politica che autorizzi l'quicksight:DescribeAutomationJobazione. L'ARN della risorsa per questa operazione include il segmento Job ID. Per consentire la descrizione di qualsiasi lavoro nell'ambito di un'automazione, utilizza un carattere jolly (*) per il segmento di lavoro.

{
    "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 consiglia di assegnare ogni autorizzazione alla risorsa ARN più specifica possibile per seguire il principio del privilegio minimo. Per ulteriori informazioni, consulta gli argomenti seguenti:

Implementa la tua automazione

L' StartAutomationJob API si rivolge solo alle automazioni implementate. È necessario eseguire il commit e distribuire l'automazione nella console Amazon Quick Automate prima di poterla richiamare tramite l'API.

StartAutomationJob

Inizia un nuovo lavoro per un'automazione distribuita. L'operazione è asincrona: Amazon Quick Automate accetta la richiesta, mette in coda il lavoro e ne restituisce immediatamente uno. JobId L'automazione viene eseguita in background. Se l'automazione ha uno schema di input definito, Amazon Quick Automate lo convalida InputPayloadrispetto allo schema prima di accettare il lavoro. Un payload non valido genera un. InvalidParameterValueException

Sintassi della richiesta

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

{
    "InputPayload": "string"
}

Parametri della richiesta

Elementi di risposta

Errori

Per maggiori dettagli, consulta la guida di riferimento dell'API per StartAutomationJob.

DescribeAutomationJob

Recupera lo stato e i dettagli di un processo di automazione specifico, inclusi i timestamp di esecuzione e i payload di input e output opzionali. Utilizzate questa operazione per verificare il completamento del lavoro dopo la chiamata. StartAutomationJob

Per impostazione predefinita, la risposta non include i payload di input e output. Imposta i parametri IncludeInputPayloade IncludeOutputPayloadinterroga su true per richiederli. Amazon Quick Automate restituisce il payload di output solo quando sono soddisfatte tutte le seguenti condizioni:

Sintassi della richiesta

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

Parametri della richiesta

Campi di risposta

Errori

Per maggiori dettagli, consulta la guida di riferimento dell'API per DescribeAutomationJob.

Esegui automazioni con trigger API utilizzando input e output

Puoi includere valori di input come payload JSON quando avvii un processo di automazione tramite l'API. Amazon Quick Automate convalida il payload rispetto allo schema di input dell'automazione prima dell'inizio dell'esecuzione e restituisce valori di output strutturati al termine del processo.

Prerequisiti

Prima di eseguire un'automazione con trigger API, assicurati che siano presenti le seguenti condizioni:

Invio di valori di input tramite l'API

Per includere i valori di input, passate un payload JSON nella StartAutomationJobrichiesta utilizzando il InputPayloadparametro.

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"
}

Recupero dei valori di output tramite l'API

È possibile recuperare i valori di output chiamando l'API. DescribeAutomationJob Per includere i payload di input e output nella risposta, imposta i parametri di OutputPayload query di inclusione InputPayload e inclusione su. true

La risposta include il OutputPayloadcampo solo quando l'automazione viene completata correttamente.

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"
}

Implementa ed esegui automazioni con input e output

Questa sezione descrive come distribuire automazioni che utilizzano schemi di input e output, eseguirle manualmente o secondo una pianificazione e visualizzare i risultati di esecuzione.

Visualizza le informazioni sullo schema prima della distribuzione

Prima di distribuire un'automazione, è necessario confermarla per creare una versione. Per ulteriori informazioni, consulta Manutenzione delle versioni di automazione.

Dopo aver eseguito un'automazione con schemi di input o output, puoi visualizzare i dettagli dello schema nella sezione Modello di dati della pagina dei dettagli della versione. Questa sezione mostra le definizioni complete dei campi sia per gli input che per gli output.

Implementa automazioni con schemi di input e output

Quando si distribuisce un'automazione con schemi di input o output definiti, la finestra di dialogo di distribuzione visualizza le informazioni sullo schema nella sezione Modello di dati, tra cui:

Per completare la distribuzione, esamina le informazioni sullo schema e scegli Distribuisci.

Esegui le automazioni distribuite manualmente

Per avviare un'automazione distribuita con input, completa i seguenti passaggi:

Il modulo di input è identico a quello che usi quando esegui il test in Studio.

Esegui automazioni con trigger pianificati

Per i trigger pianificati, fornisci i valori di input quando crei o modifichi il trigger. I valori memorizzati vengono passati all'automazione ogni volta che si attiva il trigger.

È possibile effettuare le seguenti operazioni:

Per configurare gli input per un trigger pianificato, completa i seguenti passaggi:

Visualizzazione degli input e degli output per le esecuzioni distribuite

Al termine di un'esecuzione di automazione (avviata manualmente o da un trigger pianificato), i valori di input e output sono disponibili come artefatti strutturati nel pannello dei log della pagina Esecuzioni.

Gli artefatti appaiono come schede dedicate:

Per impostazione predefinita, entrambe le carte sono compresse. Quando le espandi, puoi: