Cette page fournit une référence pour les actions AWS DynamoDB disponibles dans le catalogue des actions d’automatisation des workflows. Utilisez ces actions pour lire, écrire, mettre à jour, et supprimer des éléments dans les tables DynamoDB, et pour inspecter ou modifier la configuration des tables directement à partir d’une définition de workflow.
Prérequis
Pour les prérequis et la configuration des identifiants, consultez Configurer les identifiants AWS.
Toutes les actions DynamoDB acceptent les mêmes entrées d’authentification. Utilisez awsRoleArn (recommandé) ou la paire de clés d’accès.
Placer un élément
L’identifiant de l’action est aws.dynamodb.putItem.
Crée un nouvel élément, ou remplace un élément existant, dans une table DynamoDB. Utilise le format bas niveau AttributeValue de DynamoDB pour la map item.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Carte | Obligatoire. Une map de paires nom/valeur d'attribut au format bas niveau AttributeValue de DynamoDB. Seul l'attribut de clé primaire est requis ; tout autre attribut est facultatif. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Une condition qui doit être satisfaite pour que |
|
| Carte | Facultatif. Jetons de substitution pour les noms d'attributs dans les expressions. Utilisez la syntaxe |
|
| Carte | Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau. Utilisez la syntaxe |
|
| Carte | Facultatif. Transfert direct pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Réponse |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: put-dynamodb-itemdescription: Write an order item to DynamoDBsteps: - name: putOrderItem type: action action: aws.dynamodb.putItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders item: orderId: { "S": "123" } status: { "S": "PLACED" } next: endObtenir un élément
L’identifiant de l’action est aws.dynamodb.getItem.
Récupère un élément unique d'une table DynamoDB par sa clé primaire.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Carte | Obligatoire. La clé primaire de l’élément à récupérer, au format AttributeValue de bas niveau. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Liste d’attributs séparés par des virgules à récupérer. En cas d’omission, tous les attributs sont renvoyés. |
|
| Carte | Facultatif. Jetons de substitution pour les noms d'attributs dans les expressions. Utilisez la syntaxe |
|
| Booléen | Facultatif. Si |
|
| Carte | Facultatif. Transfert direct pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: get-dynamodb-itemdescription: Retrieve an order item from DynamoDB by primary keysteps: - name: getOrderItem type: action action: aws.dynamodb.getItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders key: orderId: { "S": "123" } selectors: - name: item expression: '.response.Item' next: endMettre à jour un élément
L’identifiant de l’action est aws.dynamodb.updateItem.
Modifie les attributs d’un élément existant, ou ajoute un nouvel élément s’il n’existe pas déjà.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Carte | Obligatoire. La clé primaire de l’élément à mettre à jour, au format AttributeValue de bas niveau. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Définit les attributs à mettre à jour. Prend en charge les actions |
|
| Chaîne | Facultatif. Une condition qui doit être satisfaite pour que le |
|
| Carte | Facultatif. Jetons de substitution pour les noms d'attributs dans les expressions. Utilisez la syntaxe |
|
| Carte | Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau. |
|
| Carte | Facultatif. Transmission pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: update-dynamodb-itemdescription: Update the status of an order in DynamoDBsteps: - name: updateOrderStatus type: action action: aws.dynamodb.updateItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders key: orderId: { "S": "123" } updateExpression: 'SET #s = :status' expressionAttributeNames: '#s': status expressionAttributeValues: ':status': { "S": "SHIPPED" } parameters: ReturnValues: UPDATED_NEW selectors: - name: attributes expression: '.response.Attributes' next: endSupprimer un élément
L’identifiant de l’action est aws.dynamodb.deleteItem.
Supprime un seul élément d’une table DynamoDB par sa clé primaire.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Carte | Obligatoire. La clé primaire de l’élément à supprimer, au format AttributeValue de bas niveau. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Une condition qui doit être satisfaite pour que le |
|
| Carte | Facultatif. Jetons de substitution pour les noms d’attributs dans les expressions. |
|
| Carte | Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau. |
|
| Carte | Facultatif. Transfert direct pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: delete-dynamodb-itemdescription: Delete an order item from DynamoDBsteps: - name: deleteOrderItem type: action action: aws.dynamodb.deleteItem version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders key: orderId: { "S": "123" } next: endAnalyser une table
L’identifiant de l’action est aws.dynamodb.scan.
Renvoie des éléments d’une table ou d’un index DynamoDB en parcourant toute la table, avec un filtrage facultatif. Une seule réponse d’analyse est limitée à 100 Ko par Workflow Automation (la propre limite de DynamoDB est de 1 Mo). Utilisez limit et exclusiveStartKey pour parcourir des tables volumineuses.
Important
Workflow Automation impose une limite de taille de sortie de 100 Ko par action. aws.dynamodb.scan lève une exception de dépassement de limite de taille de sortie lorsque la réponse dépasse cette limite, même si elle peut se situer dans la limite de 1 Mo par réponse propre à DynamoDB. Utilisez limit et exclusiveStartKey pour paginer les résultats, et rester dans cette limite.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Nom d’un index secondaire local, ou global à analyser au lieu de la table de base. |
|
| Chaîne | Facultatif. Une condition appliquée après la lecture des éléments. Les éléments filtrés ne sont pas renvoyés, mais ils consomment tout de même de la capacité de lecture. |
|
| Chaîne | Facultatif. Liste d’attributs séparés par des virgules à récupérer. En cas d’omission, tous les attributs sont renvoyés. |
|
| Carte | Facultatif. Jetons de substitution pour les noms d’attributs dans les expressions. |
|
| Carte | Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau. |
|
| Chaîne | Facultatif. Attributs à retourner. Valeurs autorisées : |
|
| Entier | Facultatif. Nombre maximal d’éléments à évaluer (pas nécessairement les éléments retournés). Minimum : 1. |
|
| Booléen | Facultatif. Si |
|
| Carte | Facultatif. Clé primaire du premier élément à évaluer. Utilisez le |
|
| Entier | Facultatif. Nombre total de segments pour une analyse parallèle. Doit être utilisé avec |
|
| Entier | Facultatif. ID de segment basé sur zéro pour une analyse parallèle. Doit être utilisé avec |
|
| Carte | Facultatif. Transfert direct pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: scan-dynamodb-tabledescription: Scan for active orders in DynamoDBsteps: - name: scanActiveOrders type: action action: aws.dynamodb.scan version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders filterExpression: '#s = :status' expressionAttributeNames: '#s': status expressionAttributeValues: ':status': { "S": "ACTIVE" } limit: 50 selectors: - name: items expression: '.response.Items' - name: lastKey expression: '.response.LastEvaluatedKey' next: endInterroger une table
L’identifiant de l’action est aws.dynamodb.query.
Renvoie les éléments d’une table ou d’un index DynamoDB qui correspondent à une clé de partition, éventuellement restreints par une condition de clé de tri ou une expression de filtre. Plus efficace qu’un scan pour les recherches basées sur des clés.
Important
Workflow Automation impose une limite de taille de sortie de 100 Ko par action. aws.dynamodb.query lève une exception de dépassement de limite de taille de sortie lorsque la réponse dépasse cette limite, même si elle peut se situer dans la limite de 1 Mo par réponse propre à DynamoDB. Utilisez limit et exclusiveStartKey pour paginer les résultats, et rester dans cette limite.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Nom d’un index secondaire local ou global pour la requête. |
|
| Chaîne | Facultatif. Condition sur la clé de partition (requise), et facultativement sur la clé de tri. |
|
| Chaîne | Facultatif. Une condition appliquée après la lecture des éléments. Vous ne pouvez pas référencer les attributs clés. Les éléments filtrés ne sont pas retournés, mais consomment toujours de la capacité de lecture. |
|
| Chaîne | Facultatif. Liste d’attributs séparés par des virgules à récupérer. |
|
| Carte | Facultatif. Jetons de substitution pour les noms d’attributs dans les expressions. |
|
| Carte | Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau. |
|
| Chaîne | Facultatif. Attributs à retourner. Valeurs autorisées : |
|
| Entier | Facultatif. Nombre maximal d'éléments à évaluer. Minimum : 1. |
|
| Booléen | Facultatif. Si |
|
| Booléen | Facultatif. Si |
|
| Carte | Facultatif. Clé primaire du premier élément à évaluer. Utilisez |
|
| Carte | Facultatif. Transfert direct pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: query-dynamodb-tabledescription: Query orders by customer IDsteps: - name: queryCustomerOrders type: action action: aws.dynamodb.query version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders indexName: customerId-index keyConditionExpression: 'customerId = :cid' expressionAttributeValues: ':cid': { "S": "cust-1" } selectors: - name: items expression: '.response.Items' next: endDécrire une table
L’identifiant de l’action est aws.dynamodb.describeTable.
Retourne les informations de la table, y compris le statut, le schéma de clé primaire, le débit provisionné, et (pour les tables globales) le statut du réplica.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: describe-dynamodb-tabledescription: Get the status and configuration of a DynamoDB tablesteps: - name: describeOrdersTable type: action action: aws.dynamodb.describeTable version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders selectors: - name: tableStatus expression: '.response.Table.TableStatus' next: endLister les tables
L’identifiant de l’action est aws.dynamodb.listTables.
Renvoie une liste de noms de tables DynamoDB dans le compte AWS et la région actuels. Les résultats sont paginés ; utilisez exclusiveStartTableName avec le LastEvaluatedTableName d'une réponse précédente pour parcourir les résultats.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS dans laquelle lister les tables. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| Chaîne | Facultatif. Premier nom de table à évaluer. Utilisez le |
|
| Entier | Facultatif. Nombre maximum de noms de tables à renvoyer (1 à 100). Par défaut : 100. |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: list-dynamodb-tablesdescription: List all DynamoDB tables in a regionsteps: - name: listDynamoTables type: action action: aws.dynamodb.listTables version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 selectors: - name: tableNames expression: '.response.TableNames' next: endMettre à jour une table
L’identifiant de l’action est aws.dynamodb.updateTable.
Modifie les paramètres de débit provisionné, le mode de facturation, les index secondaires globaux, les régions de réplication, ou d'autres paramètres d'une table DynamoDB.
Le tableau suivant décrit les champs d’entrée pour cette action.
Saisir | Type | Description | Exemple |
|---|---|---|---|
| Chaîne | Obligatoire. Région AWS de la table cible. |
|
| Chaîne | Obligatoire. Nom de la table DynamoDB. |
|
| Chaîne | Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS. |
|
| Chaîne | Facultatif. ID de clé d’accès AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Clé d’accès secrète AWS. Passer en tant que secret. |
|
| Chaîne | Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret. |
|
| List | Facultatif. Éventail de définitions d’attributs pour la table, et les index. Requis lors de l’ajout d’un nouvel index secondaire global. |
|
| Chaîne | Facultatif. Contrôle la façon dont le débit est facturé. Valeurs autorisées : |
|
| Carte | Facultatif. Requis lorsque |
|
| List | Facultatif. Une ou plusieurs actions de mise à jour d’index secondaire global (créer, mettre à jour, ou supprimer). Maximum de 20 GSI par table. |
|
| Carte | Facultatif. Paramètres pour DynamoDB Streams. |
|
| Carte | Facultatif. Paramètres de chiffrement côté serveur. |
|
| Booléen | Facultatif. Activez ou désactivez la protection contre la suppression sur la table. |
|
| Carte | Facultatif. Transfert direct pour tout champ |
|
| List | Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Booléen |
|
| Objet | Contient |
| Chaîne | Message d’erreur en cas d’échec. |
Exemple
name: update-dynamodb-tabledescription: Switch a DynamoDB table to on-demand billingsteps: - name: setPayPerRequest type: action action: aws.dynamodb.updateTable version: '1' inputs: awsRoleArn: ${{ :secrets:awsRoleArn }} region: us-east-2 tableName: Orders billingMode: PAY_PER_REQUEST selectors: - name: tableStatus expression: '.response.TableDescription.TableStatus' next: end