Flux de travail - AWS Glue

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.

Flux de travail

L'API de flux décrit les types de données et l'API liée à la création, la mise à jour ou l'affichage de flux dans AWS Glue. L’historique d’exécution des tâches est accessible pendant 90 jours pour votre flux de travail et l’exécution des tâches.

Types de données

Structure JobNodeDetails

Détails d'un nœud de tâches présent dans le flux de travail.

Champs
  • JobRuns : un tableau d’objets JobRun.

    Informations relatives aux exécutions de tâches représentées par le nœud de tâches.

Structure crawlerNodeDetails

Détails d'un nœud d'crawler présent dans le flux de travail.

Champs
  • Crawls : un tableau d’objets Crawl.

    Liste de crawlers représentés par le nœud de crawler.

Structure TriggerNodeDetails

Détails d'un nœud Trigger présent dans le flux de travail.

Champs
  • Trigger – Un objet Déclencheur.

    Informations relatives au déclencheur représenté par le nœud de déclencheur.

Structure Crawl

Détails d'un crawler dans le flux de travail.

Champs
  • State – Chaîne UTF-8 (valeurs valides : RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED | ERROR).

    État de l'crawler.

  • StartedOn – Horodatage.

    Date et heure auxquelles le crawler a démarré.

  • CompletedOn – Horodatage.

    Date et heure auxquelles l’analyse a terminé.

  • ErrorMessage – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au URI address multi-line string pattern.

    Message d'erreur associé au crawler

  • LogGroup – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au Log group string pattern.

    Groupe de journaux associés au crawler.

  • LogStream – Chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets, correspondant au Log-stream string pattern.

    Flux de journaux associé au crawler.

Structure de nœud

Un nœud représente un composant AWS Glue (déclencheur, crawler ou tâche) sur un graphique de flux de travail.

Champs
  • Type – Chaîne UTF-8 (valeurs valides : CRAWLER | JOB | TRIGGER).

    Type de composant AWS Glue représenté par le nœud.

  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du composant AWS Glue représenté par le nœud.

  • UniqueId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID unique affecté au nœud au sein du flux de travail.

  • TriggerDetails – Un objet TriggerNodeDetails.

    Détails du déclencheur lorsque le nœud représente un déclencheur.

  • JobDetails – Un objet JobNodeDetails.

    Détails de la tâche lorsque le nœud représente une tâche.

  • CrawlerDetails – Un objet crawlerNodeDetails.

    Détails de l'crawler lorsque le nœud représente un crawler.

Structure Edge

Une périphérie représente une connexion dirigée entre deux AWS Glue composants qui font partie du flux de travail auquel appartient la périphérie.

Champs
  • SourceId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaîne unique du nœud au sein du flux de travail où démarre la périphérie.

  • DestinationId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaîne unique du nœud au sein du flux de travail où la périphérie se termine.

Structure de flux de travail

Un flux de travail est un ensemble de plusieurs crawlers et tâches AWS Glue dépendants qui sont exécutés pour effectuer une tâche ETL complexe. Un flux de travail gère l'exécution et le suivi de tous ses jobs et crawlers.

Champs
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail.

  • Description – Chaîne UTF-8.

    Description du flux de travail.

  • DefaultRunProperties – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Collection de propriétés à utiliser dans le cadre de chaque exécution du flux de travail. Les propriétés d’exécution sont mises à la disposition de chaque tâche du flux de travail. Une tâche peut modifier les propriétés des tâches suivants dans le flux de travail.

  • CreatedOn – Horodatage.

    Date et heure auxquelles le flux de travail a été créé.

  • LastModifiedOn – Horodatage.

    Date et heure auxquelles le flux de travail a été modifié pour la dernière fois.

  • LastRun – Un objet WorkflowRun.

    Informations relatives à la dernière exécution du flux de travail.

  • Graph – Un objet WorkflowGraph.

    Graphique représentant tous les composants AWS Glue qui appartiennent au flux de travail comme les nœuds et les connexions dirigées entre eux en tant que périphéries.

  • CreationStatus – Chaîne UTF-8 (valeurs valides : CREATING | CREATED | CREATION_FAILED).

    État de création du flux de travail.

  • MaxConcurrentRuns : nombre (entier).

    Vous pouvez utiliser ce paramètre pour empêcher plusieurs mises à jour indésirables des données, pour contrôler les coûts ou, dans certains cas, pour empêcher le dépassement du nombre maximal d’exécutions simultanées de l’un des travaux de composant. Si vous laissez ce paramètre vide, le nombre d’exécutions de flux de travail simultanées est illimité.

  • BlueprintDetails – Un objet BlueprintDetails.

    Cette structure indique les détails du plan à partir duquel ce flux de travail particulier est créé.

Structure WorkflowGraph

Un graphique de flux de travail représente le flux de travail complet contenant tous les composants AWS Glue présents dans le flux de travail et toutes les connexions dirigées entre eux.

Champs
  • Nodes : un tableau d’objets Nœud.

    Liste des composants AWS Glue appartenant au flux de travail représentés sous la forme de nœuds.

  • Edges : un tableau d’objets Edge.

    Liste de toutes les connexions dirigées entre les nœuds appartenant au flux de travail.

Structure WorkflowRun

Une exécution de flux de travail est une exécution de flux de travail qui fournit toutes les informations d’exécution.

Champs
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail qui a été exécuté.

  • WorkflowRunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de cette exécution de flux de travail.

  • PreviousRunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de la précédente exécution de flux de travail.

  • WorkflowRunProperties – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Propriétés d’exécution de flux de travail qui ont été définies au cours de l’exécution.

  • StartedOn – Horodatage.

    Date et heure auxquelles l’exécution de flux de travail a démarré.

  • CompletedOn – Horodatage.

    Date et heure auxquelles l’exécution de flux de travail a s’est terminée.

  • Status – Chaîne UTF-8 (valeurs valides : RUNNING | COMPLETED | STOPPING | STOPPED | ERROR).

    État de l’exécution de flux de travail.

  • ErrorMessage – Chaîne UTF-8.

    Ce message d’erreur décrit toute erreur qui peut s’être produite lors du démarrage de l’exécution du flux de travail. Actuellement, le seul message d’erreur est « Concurrent runs exceeded for workflow: foo » (Exécutions simultanées dépassées pour le flux de travail : foo).

  • Statistics – Un objet WorkflowRunStatistics.

    Statistiques de l’exécution.

  • Graph – Un objet WorkflowGraph.

    Graphique représentant tous les composants AWS Glue qui appartiennent au flux de travail comme les nœuds et les connexions dirigées entre eux en tant que périphéries.

  • StartingEventBatchCondition – Un objet StartingEventBatchCondition.

    Condition de lot qui a démarré l’exécution du flux de travail.

Structure WorkflowRunStatistics

Le flux de travail exécut des statistiques et fournit des statistiques sur l’exécution du flux de travail.

Champs
  • TotalActions : nombre (entier).

    Nombre total d’actions dans l’exécution du flux de travail.

  • TimeoutActions : nombre (entier).

    Nombre total d’actions qui ont expiré.

  • FailedActions : nombre (entier).

    Nombre total d’actions qui ont échoué.

  • StoppedActions : nombre (entier).

    Nombre total d’actions qui sont arrêtées.

  • SucceededActions : nombre (entier).

    Nombre total d’actions qui ont réussi.

  • RunningActions : nombre (entier).

    Nombre total d’actions en cours d’exécution.

  • ErroredActions : nombre (entier).

    Indique le nombre d’exécutions de tâches dans l’état ERROR dans l’exécution du flux de travail.

  • WaitingActions : nombre (entier).

    Indique le nombre d’exécutions de tâches en état WAITING dans l’exécution du flux de travail.

Structure StartingEventBatchCondition

Condition de lot qui a démarré l’exécution du flux de travail. Soit le nombre d’événements dans la taille du lot est arrivé, auquel cas le membre BatchSize est différent de zéro, soit la fenêtre de lot a expiré, auquel cas le membre BatchWindow est différent de zéro.

Champs
  • BatchSize : nombre (entier).

    Nombre d’événements dans le lot.

  • BatchWindow : nombre (entier).

    Durée de la fenêtre de traitement par lots en secondes.

Structure du plan

Détails d’un plan.

Champs
  • Name – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • Description – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

    Description du plan.

  • CreatedOn – Horodatage.

    Date et heure d’enregistrement du plan.

  • LastModifiedOn – Horodatage.

    Date et heure auxquelles le plan a été modifié pour la dernière fois.

  • ParameterSpec – chaîne UTF-8, d’une longueur comprise entre 1 et 131 072 octets.

    Chaîne JSON qui indique la liste des spécifications de paramètres pour le plan.

  • BlueprintLocation – Chaîne UTF-8.

    Spécifie le chemin dans Amazon S3 où le plan est publié.

  • BlueprintServiceLocation – Chaîne UTF-8.

    Spécifie un chemin dans Amazon S3 où le plan est copié lorsque vous appelez CreateBlueprint/UpdateBlueprint pour enregistrer le plan dans AWS Glue.

  • Status – Chaîne UTF-8 (valeurs valides : CREATING | ACTIVE | UPDATING | FAILED).

    Statut de l’enregistrement du plan.

    • Création : l’enregistrement du plan est en cours.

    • Actif : le plan a été enregistré avec succès.

    • Mise à jour : une mise à jour de l’enregistrement du plan est en cours.

    • Échec : l’enregistrement du plan a échoué.

  • ErrorMessage – Chaîne UTF-8.

    Message d’erreur.

  • LastActiveDefinition – Un objet LastActiveDefinition.

    Lorsqu’il existe plusieurs versions d’un plan et que la dernière version contient des erreurs, cet attribut indique la dernière définition de plan réussie qui est disponible avec le service.

Structure BlueprintDetails

Détails d’un plan.

Champs
  • BlueprintName – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • RunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID d’exécution de ce plan.

Structure LastActiveDefinition

Lorsqu’il existe plusieurs versions d’un plan et que la dernière version contient des erreurs, cet attribut indique la dernière définition de plan réussie qui est disponible avec le service.

Champs
  • Description – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

    Description du plan.

  • LastModifiedOn – Horodatage.

    Date et heure auxquelles le plan a été modifié pour la dernière fois.

  • ParameterSpec – chaîne UTF-8, d’une longueur comprise entre 1 et 131 072 octets.

    Chaîne JSON spécifiant les paramètres du plan.

  • BlueprintLocation – Chaîne UTF-8.

    Spécifie un chemin dans Amazon S3 où le plan est publié par le développeur AWS Glue.

  • BlueprintServiceLocation – Chaîne UTF-8.

    Spécifie un chemin dans Amazon S3 où le plan est copié lorsque vous créez ou mettez à jour ce dernier.

Structure BlueprintRun

Détails d’une exécution de plan.

Champs
  • BlueprintName – chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • RunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID d’exécution de cette exécution de plan.

  • WorkflowName – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom d’un flux de travail créé à la suite d’une exécution réussie du plan. Si une exécution de plan comporte une erreur, aucun flux de travail ne sera créé.

  • State – Chaîne UTF-8 (valeurs valides : RUNNING | SUCCEEDED | FAILED | ROLLING_BACK).

    État de l’exécution du plan. Les valeurs possibles sont :

    • En cours d’exécution : l’exécution du plan est en cours.

    • Réussi : l’exécution du plan s’est terminée.

    • Échec : l’exécution du plan a échoué et la restauration est terminée.

    • Annuler : l’exécution du plan a échoué et la restauration est en cours.

  • StartedOn – Horodatage.

    Date et heure auxquelles l’exécution du plan a démarré.

  • CompletedOn – Horodatage.

    Date et heure auxquelles le modèle a été exécuté.

  • ErrorMessage – Chaîne UTF-8.

    Indique les erreurs détectées lors de l’exécution du plan.

  • RollbackErrorMessage – Chaîne UTF-8.

    S’il y a des erreurs lors de la création des entités d’un flux de travail, nous essayons de restaurer les entités créées jusqu’à ce point et de les supprimer. Cet attribut indique les erreurs rencontrées lors de la tentative de suppression des entités créées.

  • Parameters – chaîne UTF-8, d’une longueur comprise entre 1 et 131 072 octets.

    Paramètres du plan sous la forme d’une chaîne. Vous devrez fournir une valeur pour chaque clé requise à partir de la spécification de paramètre définie dans Blueprint$ParameterSpec.

  • RoleArn – Chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au Custom string pattern #30.

    ARN du rôle. Ce rôle sera endossé par le service AWS Glue et sera utilisé pour créer le flux de travail et les autres entités d’un flux de travail.

Opérations

Action CreateWorkflow (Python : create_workflow)

Crée un nouveau flux de travail.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom à affecter ai flux de travail. Il doit être unique au sein de votre compte.

  • Description – Chaîne UTF-8, d’une longueur maximale de 120 000 octets.

    Description du flux de travail.

  • DefaultRunProperties – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Collection de propriétés à utiliser dans le cadre de chaque exécution du flux de travail.

    Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez des secrets à partir d’une connexion AWS Glue, d’AWS Secrets Manager ou de tout autre mécanisme de gestion de secrets si vous avez l’intention de les utiliser dans l’exécution du flux de travail.

  • Tags – Tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

    Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

    Balises à utiliser avec ce flux de travail.

  • MaxConcurrentRuns : nombre (entier).

    Vous pouvez utiliser ce paramètre pour empêcher plusieurs mises à jour indésirables des données, pour contrôler les coûts ou, dans certains cas, pour empêcher le dépassement du nombre maximal d’exécutions simultanées de l’un des travaux de composant. Si vous laissez ce paramètre vide, le nombre d’exécutions de flux de travail simultanées est illimité.

Réponse
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail qui a été fourni dans le cadre de la requête.

Erreurs
  • AlreadyExistsException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

Action UpdateWorkflow (Python : update_workflow)

Met à jour un flux de travail existant.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail à mettre à jour.

  • Description – Chaîne UTF-8, d’une longueur maximale de 120 000 octets.

    Description du flux de travail.

  • DefaultRunProperties – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Collection de propriétés à utiliser dans le cadre de chaque exécution du flux de travail.

    Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez des secrets à partir d’une connexion AWS Glue, d’AWS Secrets Manager ou de tout autre mécanisme de gestion de secrets si vous avez l’intention de les utiliser dans l’exécution du flux de travail.

  • MaxConcurrentRuns : nombre (entier).

    Vous pouvez utiliser ce paramètre pour empêcher plusieurs mises à jour indésirables des données, pour contrôler les coûts ou, dans certains cas, pour empêcher le dépassement du nombre maximal d’exécutions simultanées de l’un des travaux de composant. Si vous laissez ce paramètre vide, le nombre d’exécutions de flux de travail simultanées est illimité.

Réponse
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail qui a été spécifié dans l’entrée.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

Action DeleteWorkflow (Python : delete_workflow)

Supprime un flux de travail.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail à supprimer.

Réponse
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail spécifié dans l’entrée.

Erreurs
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

Action GetWorkflow (Python : get_workflow)

Récupère les métadonnées de ressource pour un flux de travail.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail à récupérer.

  • IncludeGraph : booléen.

    Indique si un graphique doit être inclus lors du renvoi de métadonnées de ressource de flux de travail.

Réponse
  • Workflow – Un objet Flux de travail.

    Métadonnées de ressource du flux de travail.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Action ListWorkflows (Python : list_workflows)

Affiche les noms des flux de travail créés dans le compte.

Demande
  • NextToken – Chaîne UTF-8.

    Jeton de continuation, s’il s’agit d’une requête de continuation.

  • MaxResults – Nombre (entier), compris entre 1 et 25.

    La taille maximale d’une liste à renvoyer.

Réponse
  • Workflows – tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

    Liste des noms des flux de travail dans le compte.

  • NextToken – Chaîne UTF-8.

    Jeton de continuation, si tous les noms de flux de travail n’ont pas été retournés.

Erreurs
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

Action BatchGetWorkflows (Python : batch_get_workflows)

Retourne la liste des métadonnées de ressource pour une liste donnée de noms de flux de travail. Après avoir appelé l’opération ListWorkflows, vous pouvez appeler cette opération pour accéder aux données sur lesquelles des autorisations vous ont été octroyées. Cette opération prend en charge toutes les autorisations IAM, y compris les conditions d’autorisation qui utilisent des balises.

Demande
  • NamesObligatoire : Tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

    Liste des noms de flux de travail, qui peuvent être les noms renvoyés à partir de l’opération ListWorkflows.

  • IncludeGraph : booléen.

    Indique si un graphique doit être inclus lors du renvoi de métadonnées de ressource de flux de travail.

Réponse
  • Workflows – tableau d’objets Flux de travail, avec 1 structure minimum et 25 structures maximum.

    Liste de métadonnées de ressource de flux de travail.

  • MissingWorkflows – tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

    Liste des noms de flux de travail non trouvés.

Erreurs
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

Action GetWorkflowRun (Python : get_workflow_run)

Extrait les métadonnées pour une exécution de flux de travail donnée. L’historique d’exécution des tâches est accessible pendant 90 jours pour votre flux de travail et l’exécution des tâches.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail en cours d’exécution.

  • RunIdObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de l’exécution de flux de travail.

  • IncludeGraph : booléen.

    Indique si le graphique de flux de travail doit être inclus en réponse ou non.

Réponse
  • Run – Un objet WorkflowRun.

    Métadonnées d’exécution de flux de travail demandées.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Action GetWorkflowRuns (Python : get_workflow_runs)

Extrait les métadonnées de toutes les exécutions d’un flux de travail donné.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail dont les métadonnées des exécutions doivent être renvoyées.

  • IncludeGraph : booléen.

    Indique si le graphique de flux de travail doit être inclus en réponse ou non.

  • NextToken – Chaîne UTF-8.

    Taille maximale de la réponse.

  • MaxResults – Nombre (entier), compris entre 1 et 1 000.

    Nombre maximal d’exécutions de flux de travail à inclure dans la réponse.

Réponse
  • Runs – tableau d’objets WorkflowRun, avec 1 structure minimum et 1 000 structures maximum.

    Liste d’objets des métadonnées d’exécution de flux de travail.

  • NextToken – Chaîne UTF-8.

    Jeton de continuation, si toutes les exécutions de tâche demandées ne sont pas renvoyées.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Action GetWorkflowRunProperties (Python : get_workflow_run_properties)

Extrait les propriétés d’exécution de flux de travail qui ont été définies au cours de l’exécution.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail qui a été exécuté.

  • RunIdObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de l’exécution de flux de travail dont les propriétés d’exécution doivent être renvoyées.

Réponse
  • RunProperties – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Propriétés d’exécution de flux de travail qui ont été définies au cours de l’exécution spécifiée.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Action PutWorkflowRunProperties (Python : put_workflow_run_properties)

Place les propriétés d’exécution de flux de travail spécifiées pour l’exécution de flux de travail donnée. Si une propriété existe déjà pour l’exécution spécifiée, elle remplace la valeur et ajoute la propriété aux propriétés existantes.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail qui a été exécuté.

  • RunIdObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de l’exécution de flux de travail pour laquelle les propriétés d’exécution doivent être mises à jour.

  • RunPropertiesobligatoire : tableau de mappage de paires clé-valeur.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Propriétés à placer pour l’exécution spécifiée.

    Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez des secrets à partir d’une connexion AWS Glue, d’AWS Secrets Manager ou de tout autre mécanisme de gestion de secrets si vous avez l’intention de les utiliser dans l’exécution du flux de travail.

Réponse
  • Paramètres d’absence de réponse.

Erreurs
  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

Action CreateBlueprint (Python : create_blueprint)

Enregistre un plan avec AWS Glue.

Demande
  • Nameobligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • Description – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

    Description du plan.

  • BlueprintLocationobligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 8 192 octets, correspondant au Custom string pattern #32.

    Spécifie un chemin dans Amazon S3 où le plan est publié.

  • Tags – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

    Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

    Balises à appliquer à ce plan.

Réponse
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Renvoie le nom du plan qui a été enregistré.

Erreurs
  • AlreadyExistsException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • ResourceNumberLimitExceededException

Action UpdateBlueprint (Python : update_blueprint)

Met à jour un plan enregistré.

Demande
  • Nameobligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • Description – chaîne UTF-8, d’une longueur comprise entre 1 et 512 octets.

    Description du plan.

  • BlueprintLocationobligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 8 192 octets, correspondant au Custom string pattern #32.

    Spécifie un chemin dans Amazon S3 où le plan est publié.

Réponse
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Renvoie le nom du plan qui a été mis à jour.

Erreurs
  • EntityNotFoundException

  • ConcurrentModificationException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • IllegalBlueprintStateException

Action DeleteBlueprint (Python : delete_blueprint)

Supprime un plan existant.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du plan à supprimer.

Réponse
  • Name – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Renvoie le nom du plan qui a été supprimé.

Erreurs
  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

Action ListBlueprints (Python : list_blueprints)

Répertorie tous les noms de plan d’un compte.

Demande
  • NextToken – Chaîne UTF-8.

    Jeton de continuation, s’il s’agit d’une requête de continuation.

  • MaxResults – Nombre (entier), compris entre 1 et 25.

    La taille maximale d’une liste à renvoyer.

  • Tags – tableau de mappage de paires clé-valeur, avec 50 paires au maximum.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets.

    Chaque valeur est une chaîne UTF-8, d’une longueur maximale de 256 octets.

    Filtre la liste par une balise de ressource AWS.

Réponse
  • Blueprints – Tableau de chaînes UTF-8.

    Liste des noms des plans dans le compte.

  • NextToken – Chaîne UTF-8.

    Jeton de continuation, si tous les noms de plan n’ont pas été renvoyés.

Erreurs
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

Action BatchGetBlueprints (Python : batch_get_blueprints)

Extrait des informations sur une liste de plans.

Demande
  • NamesObligatoire : Tableau de chaînes UTF-8, avec 1 chaîne minimum et 25 chaînes maximum.

    Une liste de noms de plan.

  • IncludeBlueprint : booléen.

    Indique si le plan doit être inclus dans la réponse ou non.

  • IncludeParameterSpec : booléen.

    Spécifie s’il faut ou non inclure les paramètres, sous forme de chaîne JSON, pour le plan dans la réponse.

Réponse
  • Blueprints : un tableau d’objets Plan .

    Renvoie la liste des plans sous forme d’objet Blueprints.

  • MissingBlueprints – Tableau de chaînes UTF-8.

    Renvoie une liste de BlueprintNames qui ont été introuvables.

Erreurs
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

Action StartBlueprintRun (Python : start_blueprint_run)

Démarre une nouvelle exécution du plan spécifié.

Demande
  • BlueprintNameobligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • Parameters – chaîne UTF-8, d’une longueur comprise entre 1 et 131 072 octets.

    Spécifie les paramètres en tant qu’objet BlueprintParameters.

  • RoleArnObligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 1024 octets, correspondant au Custom string pattern #30.

    Spécifie le rôle IAM utilisé pour créer le flux de travail.

Réponse
  • RunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID d’exécution de cette exécution de plan.

Erreurs
  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • ResourceNumberLimitExceededException

  • EntityNotFoundException

  • IllegalBlueprintStateException

Action GetBlueprintRun (Python : get_blueprint_run)

Récupère les détails d’une exécution de plan.

Demande
  • BlueprintNameobligatoire : chaîne UTF-8, d’une longueur comprise entre 1 et 128 octets, correspondant au Custom string pattern #31.

    Nom du plan.

  • RunIdObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID d’exécution de l’exécution de plan que vous souhaitez récupérer.

Réponse
  • BlueprintRun – Un objet BlueprintRun.

    Renvoie un objet BlueprintRun.

Erreurs
  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Action GetBlueprintRuns (Python : get_blueprint_runs)

Récupère les détails des exécutions de plan pour un plan spécifié.

Demande
  • BlueprintNameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du plan.

  • NextToken – Chaîne UTF-8.

    Jeton de continuation, s’il s’agit d’une requête de continuation.

  • MaxResults – Nombre (entier), compris entre 1 et 1 000.

    La taille maximale d’une liste à renvoyer.

Réponse
  • BlueprintRuns : un tableau d’objets BlueprintRun.

    Envoie la liste des objets BlueprintRun.

  • NextToken – Chaîne UTF-8.

    Jeton de continuation, si toutes les exécutions de plan ne sont pas renvoyées.

Erreurs
  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

Action StartWorkflowRun (Python : start_workflow_run)

Démarre une nouvelle exécution du flux de travail spécifié.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail à démarrer.

  • RunProperties – Tableau de mappage de paires valeur-clé.

    Chaque clé est une chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Chaque valeur est une chaîne UTF-8.

    Les propriétés d’exécution de flux de travail pour la nouvelle exécution de flux de travail.

    Les propriétés d’exécution peuvent être journalisées. Ne transmettez pas de secrets en texte clair comme propriétés. Récupérez des secrets à partir d’une connexion AWS Glue, d’AWS Secrets Manager ou de tout autre mécanisme de gestion de secrets si vous avez l’intention de les utiliser dans l’exécution du flux de travail.

Réponse
  • RunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID pour la nouvelle exécution.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

Action StopWorkflowRun (Python : stop_workflow_run)

Arrête l’exécution du cycle de flux de travail spécifié.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail à arrêter.

  • RunIdObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de du cycle de flux de travail à arrêter.

Réponse
  • Paramètres d’absence de réponse.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • IllegalWorkflowStateException

Action ResumeWorkflowRun (Python : resume_workflow_run)

Redémarre les nœuds sélectionnés d’une précédente exécution de flux de travail partiellement terminée et reprend l’exécution de flux de travail. Les nœuds sélectionnés et tous les nœuds en aval des nœuds sélectionnés sont exécutés.

Demande
  • NameObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nom du flux de travail à reprendre.

  • RunIdObligatoire : Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    ID de l’exécution du flux de travail à reprendre.

  • NodeIdsobligatoire : tableau de chaînes UTF-8.

    Liste des ID de nœud pour les nœuds que vous souhaitez redémarrer. Les nœuds qui doivent être redémarrés doivent avoir une tentative d’exécution dans l’exécution d’origine.

Réponse
  • RunId – Chaîne UTF-8, d’une longueur comprise entre 1 et 255 octets, correspondant au Single-line string pattern.

    Nouvel ID attribué à l’exécution de flux de travail reprise. Chaque résumé d’exécution de flux de travail aura un nouvel ID d’exécution.

  • NodeIds – Tableau de chaînes UTF-8.

    Liste des ID de nœud pour les nœuds qui ont été réellement redémarrés.

Erreurs
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentRunsExceededException

  • IllegalWorkflowStateException