Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Déploiement d'automatisations

Après avoir créé et testé vos automatisations dans Amazon Quick Automate, l'étape suivante consiste à les déployer afin qu'elles puissent s'exécuter régulièrement sur un déclencheur. Le déploiement rend l'automatisation opérationnelle et prête à être exécutée. Vous pouvez ajouter un déclencheur à une automatisation déployée pour l'exécuter selon un calendrier prédéfini. Le déploiement implique de configurer les paramètres d'exécution, d'affecter des utilisateurs à des tâches humaines, de vérifier les informations d'identification et les intégrations.

Cette section explique chaque étape du processus de déploiement et explique comment configurer votre automatisation pour garantir fiabilité, sécurité et performances optimales.

Conditions préalables

Avant de déployer votre automatisation, assurez-vous que les étapes suivantes sont terminées :

Déploiement d'une automatisation

Vous pouvez déployer une automatisation directement depuis le Canvas en cliquant sur Déployer ou en accédant à l'onglet Déploiement sur la page d'accueil de l'automatisation. Une fois que vous avez lancé le déploiement, le système vous guide à travers une série d'étapes pour terminer le processus de configuration et de publication.

Détails de la version

Sur la page Détails de la version, sélectionnez la version de l'automatisation que vous souhaitez déployer. Seules les versions validées sont disponibles pour le déploiement et apparaîtront dans la liste déroulante.

Réglages supplémentaires

Les paramètres supplémentaires incluent :

Configuration de l’exécution

Les configurations d'exécution sont des paramètres qui peuvent différer selon les environnements tels que le développement, les tests et la production.

Par exemple, une étape d'automatisation qui envoie un e-mail peut utiliser votre adresse e-mail personnelle pendant les tests, mais doit passer à une adresse d'équipe partagée en production. Ces valeurs dépendantes de l'environnement peuvent être définies en tant que configurations d'exécution lors de la création de l'automatisation.

Au moment du déploiement, vous pouvez revoir et remplacer ces configurations pour vous assurer que l'automatisation fonctionne correctement dans l'environnement prévu. Les paramètres d'exécution peuvent inclure :

Cette flexibilité permet de conserver une définition d'automatisation unique dans tous les environnements tout en adaptant les paramètres clés selon les besoins.

Tâches

Sélectionnez les utilisateurs ou les groupes d'utilisateurs du résolveur pour chacune des tâches nécessitant une intervention humaine.

Accès (informations d'identification et connexions)

Les automatisations doivent souvent se connecter à des systèmes, des bases de données ou des services externes. Amazon Quick Automate fournit des méthodes sécurisées pour gérer les informations d'identification et les connexions sans intégrer d'informations sensibles dans votre logique d'automatisation.

Les données de connexion et d'identification sont stockées et cryptées de manière sécurisée, et mises à la disposition des flux de travail lors de l'exécution sans les exposer aux auteurs ou aux utilisateurs finaux. Cette conception garantit une séparation étroite entre les secrets et les définitions d'automatisation, améliorant à la fois la sécurité et la maintenabilité.

Vous pouvez stocker et utiliser deux principaux types d'informations d'identification :

Lors du déploiement, assurez-vous que les informations d'identification et les connexions appropriées sont sélectionnées afin que l'automatisation puisse accéder à tous les systèmes requis en toute sécurité et avec succès.

Configuration des déclencheurs

Les déclencheurs déterminent quand et comment vos automatisations s'exécutent. Vous pouvez configurer les automatisations pour qu'elles démarrent selon un calendrier prédéfini ou les invoquer par programmation via l'API Amazon. QuickSight

Schedules

Vous pouvez configurer les automatisations pour qu'elles démarrent selon un calendrier prédéfini. Pour configurer un déclencheur :

Déclencheurs API

Les API Automation Job vous permettent de démarrer et de surveiller par programmation des tâches d'automatisation à partir d'applications externes. Vous pouvez utiliser ces API pour invoquer des automatisations déployées avec des charges utiles d'entrée personnalisées et récupérer les résultats d'exécution via le AWS SDK et. AWS CLI

Les API Automation Job incluent deux opérations :

Ces API font partie de l'espace de noms des QuickSight services Amazon. Vous pouvez y accéder via l'quicksightespace de noms du AWS SDK et. AWS CLI

Pour plus d'informations sur AWS les SDK et les boîtes à outils, consultez le Centre de ressources AWS pour la mise en route.

Conditions préalables

Avant d'appeler les API Automation Job, effectuez les étapes de configuration suivantes.

Trouvez vos identifiants d'automatisation

Pour appeler les API Automation Job, vous avez besoin des identifiants suivants :

Vous trouverez l'ID du groupe d'automatisation et l'ID d'automatisation dans la section Déploiements lorsque vous ouvrez une automatisation et que vous disposez d'une version déployée.

Pour trouver vos identifiants

Configuration des autorisations IAM

Les API Automation Job nécessitent des autorisations IAM associées à votre identité IAM (utilisateur, rôle ou groupe). Chaque opération nécessite une autorisation distincte.

Autorisation pour StartAutomationJob

Joignez une politique qui autorise l'quicksight:StartAutomationJobaction. Étendez l'ARN de la ressource à l'automatisation spécifique que vous souhaitez autoriser.

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

Autorisation pour DescribeAutomationJob

Joignez une politique qui autorise l'quicksight:DescribeAutomationJobaction. L'ARN de la ressource pour cette opération inclut le segment d'ID de tâche. Pour permettre de décrire n'importe quel travail dans le cadre d'une automatisation, utilisez un caractère générique (*) pour le segment de travail.

{
    "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 recommande de délimiter chaque autorisation à l'ARN de ressource le plus spécifique possible afin de respecter le principe du moindre privilège. Pour plus d’informations, consultez les ressources suivantes :

Déployez votre automatisation

L' StartAutomationJob API cible uniquement les automatisations déployées. Vous devez valider et déployer votre automatisation dans la console Amazon Quick Automate avant de pouvoir l'invoquer via l'API.

StartAutomationJob

Démarre une nouvelle tâche pour une automatisation déployée. L'opération est asynchrone : Amazon Quick Automate accepte la demande, met la tâche en file d'attente et renvoie immédiatement un JobId L'automatisation s'exécute en arrière-plan. Si un schéma d'entrée est défini pour l'automatisation, Amazon Quick Automate le valide par InputPayloadrapport au schéma avant d'accepter la tâche. Une charge utile non valide entraîne un InvalidParameterValueException.

Syntaxe de demande

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

{
    "InputPayload": "string"
}

Paramètres de demande

Éléments de réponse

Erreurs

Pour plus de détails, consultez le guide de référence des API pour StartAutomationJob.

DescribeAutomationJob

Récupère le statut et les détails d'une tâche d'automatisation spécifiée, y compris les horodatages d'exécution et les charges utiles d'entrée et de sortie facultatives. Utilisez cette opération pour demander si le travail est terminé après l'appel StartAutomationJob.

La réponse n'inclut pas les charges utiles d'entrée et de sortie par défaut. Définissez les paramètres de IncludeOutputPayloadrequête IncludeInputPayloadet sur true pour les demander. Amazon Quick Automate renvoie la charge utile de sortie uniquement lorsque toutes les conditions suivantes sont remplies :

Syntaxe de demande

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

Paramètres de demande

Champs de réponse

Erreurs

Pour plus de détails, consultez le guide de référence des API pour DescribeAutomationJob.

Exécutez des automatisations avec des déclencheurs d'API en utilisant l'entrée et la sortie

Vous pouvez inclure des valeurs d'entrée sous forme de charge utile JSON lorsque vous démarrez une tâche d'automatisation via l'API. Amazon Quick Automate valide la charge utile par rapport au schéma d'entrée de l'automatisation avant le début de l'exécution, et renvoie des valeurs de sortie structurées une fois la tâche terminée.

Conditions préalables

Avant d'exécuter une automatisation avec des déclencheurs d'API, assurez-vous que les éléments suivants sont en place :

Envoi de valeurs d'entrée via l'API

Pour inclure des valeurs d'entrée, transmettez une charge utile JSON dans la StartAutomationJobdemande à l'aide du InputPayloadparamètre.

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

Récupération des valeurs de sortie via l'API

Vous pouvez récupérer les valeurs de sortie en appelant l'DescribeAutomationJobAPI. Pour inclure les charges utiles d'entrée et de sortie dans la réponse, définissez les paramètres de OutputPayload requête include InputPayload et include surtrue.

La réponse inclut le OutputPayloadchamp uniquement lorsque l'automatisation est terminée avec succès.

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

Déployez et exécutez des automatisations avec des entrées et des sorties

Cette section décrit comment déployer des automatisations qui utilisent des schémas d'entrée et de sortie, les exécuter manuellement ou selon un calendrier, et afficher les résultats d'exécution.

Afficher les informations du schéma avant le déploiement

Avant de déployer une automatisation, vous devez la valider pour créer une version. Pour plus d'informations, consultez la section Gestion des versions automatisées.

Après avoir validé une automatisation avec des schémas d'entrée ou de sortie, vous pouvez consulter les détails du schéma dans la section Modèle de données de la page des détails de la version. Cette section affiche les définitions complètes des champs pour les entrées et les sorties.

Déployez des automatisations avec des schémas d'entrée et de sortie

Lorsque vous déployez une automatisation pour laquelle des schémas d'entrée ou de sortie sont définis, la boîte de dialogue de déploiement affiche les informations relatives au schéma dans la section Modèle de données, notamment :

Pour terminer le déploiement, consultez les informations du schéma et choisissez Déployer.

Exécuter les automatisations déployées manuellement

Pour démarrer une automatisation déployée avec des entrées, procédez comme suit :

Le formulaire de saisie est identique à celui que vous utilisez lors des tests dans Studio.

Exécutez des automatisations avec des déclencheurs planifiés

Pour les déclencheurs planifiés, vous fournissez des valeurs d'entrée lorsque vous créez ou modifiez le déclencheur. Les valeurs enregistrées sont transmises à l'automatisme chaque fois que le déclencheur se déclenche.

Vous pouvez effectuer les opérations suivantes :

Pour configurer les entrées pour un déclencheur planifié, procédez comme suit :

Affichage des entrées et des sorties pour les exécutions déployées

Une fois qu'une exécution d'automatisation est terminée (qu'elle ait été lancée manuellement ou par un déclencheur planifié), les valeurs d'entrée et de sortie sont disponibles sous forme d'artefacts structurés dans le panneau des journaux de la page Exécutions.

Les artefacts apparaissent sous forme de cartes dédiées :

Les deux cartes sont réduites par défaut. Lorsque vous les développez, vous pouvez :