• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Actions AWS DynamoDB

|View as Markdown (English)

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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

item

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.

{"id": {"S": "123"}, "status": {"S": "PLACED"}}

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

conditionExpression

Chaîne

Facultatif. Une condition qui doit être satisfaite pour que PutItem réussisse. Prend en charge les fonctions (attribute_exists, attribute_not_exists, contains), les opérateurs de comparaison, et les opérateurs logiques (AND, OR, NOT).

attribute_not_exists(id)

expressionAttributeNames

Carte

Facultatif. Jetons de substitution pour les noms d'attributs dans les expressions. Utilisez la syntaxe #name pour référencer des mots réservés ou des caractères spéciaux.

{"#n": "name"}

expressionAttributeValues

Carte

Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau. Utilisez la syntaxe :value.

{":id": {"S": "123"}}

parameters

Carte

Facultatif. Transfert direct pour tout champ put_item non modélisé ci-dessus. Les noms de champs doivent utiliser le format PascalCase de boto3. Valeurs courantes : ReturnValues (NONE par défaut | ALL_OLD), ReturnConsumedCapacity (NONE par défaut | TOTAL | INDEXES), ReturnValuesOnConditionCheckFailure (NONE par défaut | ALL_OLD). Consultez la référence de l’API PutItem.

{"ReturnValues": "ALL_OLD"}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "attributes", "expression": ".response.Attributes"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Réponse put_item brute. Contient Attributes si ReturnValues est défini via parameters. Consultez la référence de l’API PutItem.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: put-dynamodb-item
description: Write an order item to DynamoDB
steps:
- 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: end

Obtenir 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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

key

Carte

Obligatoire. La clé primaire de l’élément à récupérer, au format AttributeValue de bas niveau.

{"orderId": {"S": "123"}}

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

projectionExpression

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.

id, #n

expressionAttributeNames

Carte

Facultatif. Jetons de substitution pour les noms d'attributs dans les expressions. Utilisez la syntaxe #name pour référencer des mots réservés ou des caractères spéciaux.

{"#n": "name"}

consistentRead

Booléen

Facultatif. Si true, utilise des lectures fortement cohérentes. Par défaut : false (cohérence à terme).

false

parameters

Carte

Facultatif. Transfert direct pour tout champ get_item non modélisé ci-dessus. Valeur courante : ReturnConsumedCapacity (NONE par défaut | TOTAL | INDEXES). Consultez la référence de l'API GetItem.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "item", "expression": ".response.Item"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient Item si l’élément a été trouvé. Consultez la référence de l’API GetItem.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: get-dynamodb-item
description: Retrieve an order item from DynamoDB by primary key
steps:
- 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: end

Mettre à 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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

key

Carte

Obligatoire. La clé primaire de l’élément à mettre à jour, au format AttributeValue de bas niveau.

{"orderId": {"S": "123"}}

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

updateExpression

Chaîne

Facultatif. Définit les attributs à mettre à jour. Prend en charge les actions SET, REMOVE, ADD et DELETE.

SET #s = :status

conditionExpression

Chaîne

Facultatif. Une condition qui doit être satisfaite pour que le UpdateItem réussisse.

attribute_exists(orderId)

expressionAttributeNames

Carte

Facultatif. Jetons de substitution pour les noms d'attributs dans les expressions. Utilisez la syntaxe #name pour référencer des mots réservés ou des caractères spéciaux.

{"#s": "status"}

expressionAttributeValues

Carte

Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau.

{":status": {"S": "SHIPPED"}}

parameters

Carte

Facultatif. Transmission pour tout champ update_item non modélisé ci-dessus. Valeur courante : ReturnValues (NONE par défaut | ALL_OLD | UPDATED_OLD | ALL_NEW | UPDATED_NEW). Consultez la référence de l'API UpdateItem.

{"ReturnValues": "UPDATED_NEW"}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "attributes", "expression": ".response.Attributes"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient Attributes si ReturnValues est défini via parameters. Consultez la référence de l’API UpdateItem.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: update-dynamodb-item
description: Update the status of an order in DynamoDB
steps:
- 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: end

Supprimer 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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

key

Carte

Obligatoire. La clé primaire de l’élément à supprimer, au format AttributeValue de bas niveau.

{"orderId": {"S": "123"}}

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

conditionExpression

Chaîne

Facultatif. Une condition qui doit être satisfaite pour que le DeleteItem réussisse.

attribute_exists(orderId)

expressionAttributeNames

Carte

Facultatif. Jetons de substitution pour les noms d’attributs dans les expressions.

{"#n": "name"}

expressionAttributeValues

Carte

Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau.

{":id": {"S": "123"}}

parameters

Carte

Facultatif. Transfert direct pour tout champ delete_item non modélisé ci-dessus. Valeur courante : ReturnValues (NONE par défaut | ALL_OLD). Consultez la référence de l’API DeleteItem.

{"ReturnValues": "ALL_OLD"}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "attributes", "expression": ".response.Attributes"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient Attributes si ReturnValues est défini via parameters. Consultez la référence de l’API DeleteItem.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: delete-dynamodb-item
description: Delete an order item from DynamoDB
steps:
- 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: end

Analyser 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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

indexName

Chaîne

Facultatif. Nom d’un index secondaire local, ou global à analyser au lieu de la table de base.

my-gsi

filterExpression

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.

#s = :status

projectionExpression

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.

id, #n

expressionAttributeNames

Carte

Facultatif. Jetons de substitution pour les noms d’attributs dans les expressions.

{"#s": "status"}

expressionAttributeValues

Carte

Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau.

{":status": {"S": "ACTIVE"}}

select

Chaîne

Facultatif. Attributs à retourner. Valeurs autorisées : ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT.

ALL_ATTRIBUTES

limit

Entier

Facultatif. Nombre maximal d’éléments à évaluer (pas nécessairement les éléments retournés). Minimum : 1.

100

consistentRead

Booléen

Facultatif. Si true, utilise des lectures fortement cohérentes. Non pris en charge sur les index secondaires globaux. Par défaut : false.

false

exclusiveStartKey

Carte

Facultatif. Clé primaire du premier élément à évaluer. Utilisez le LastEvaluatedKey d’une analyse précédente pour paginer.

{"orderId": {"S": "123"}}

totalSegments

Entier

Facultatif. Nombre total de segments pour une analyse parallèle. Doit être utilisé avec segment. Plage autorisée : 1 à 1 000 000.

4

segment

Entier

Facultatif. ID de segment basé sur zéro pour une analyse parallèle. Doit être utilisé avec totalSegments.

0

parameters

Carte

Facultatif. Transfert direct pour tout champ scan non modélisé ci-dessus. Consultez la référence de l'API Scan.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "items", "expression": ".response.Items"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient Items (éléments correspondants), et LastEvaluatedKey (présent lorsque d’autres pages existent). Consultez la référence de l’API Scan.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: scan-dynamodb-table
description: Scan for active orders in DynamoDB
steps:
- 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: end

Interroger 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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

indexName

Chaîne

Facultatif. Nom d’un index secondaire local ou global pour la requête.

customerId-index

keyConditionExpression

Chaîne

Facultatif. Condition sur la clé de partition (requise), et facultativement sur la clé de tri.

customerId = :cid

filterExpression

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.

#s = :status

projectionExpression

Chaîne

Facultatif. Liste d’attributs séparés par des virgules à récupérer.

id, #n

expressionAttributeNames

Carte

Facultatif. Jetons de substitution pour les noms d’attributs dans les expressions.

{"#s": "status"}

expressionAttributeValues

Carte

Facultatif. Valeurs de substitution pour les expressions au format AttributeValue de bas niveau.

{":cid": {"S": "cust-1"}}

select

Chaîne

Facultatif. Attributs à retourner. Valeurs autorisées : ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT.

ALL_ATTRIBUTES

limit

Entier

Facultatif. Nombre maximal d'éléments à évaluer. Minimum : 1.

100

scanIndexForward

Booléen

Facultatif. Si true (par défaut), renvoie les résultats par ordre croissant de la clé de tri. Si false, renvoie par ordre décroissant.

true

consistentRead

Booléen

Facultatif. Si true, utilise des lectures fortement cohérentes. Non pris en charge sur les index secondaires globaux. Par défaut : false.

false

exclusiveStartKey

Carte

Facultatif. Clé primaire du premier élément à évaluer. Utilisez LastEvaluatedKey d’une requête précédente pour paginer.

{"orderId": {"S": "123"}}

parameters

Carte

Facultatif. Transfert direct pour tout champ query non modélisé ci-dessus. Consultez la référence de l’API de requête.

{"ReturnConsumedCapacity": "TOTAL"}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "items", "expression": ".response.Items"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient Items (éléments correspondants), et LastEvaluatedKey (présent lorsque d’autres pages existent). Consultez la référence de l’API de requête.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: query-dynamodb-table
description: Query orders by customer ID
steps:
- 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: end

Dé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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "tableStatus", "expression": ".response.Table.TableStatus"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient Table avec TableStatus, KeySchema, ProvisionedThroughput et Replicas pour les tables globales. Consultez la référence de l’API DescribeTable.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: describe-dynamodb-table
description: Get the status and configuration of a DynamoDB table
steps:
- 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: end

Lister 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

region

Chaîne

Obligatoire. Région AWS dans laquelle lister les tables.

us-east-2

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

exclusiveStartTableName

Chaîne

Facultatif. Premier nom de table à évaluer. Utilisez le LastEvaluatedTableName d'une réponse précédente pour paginer.

my-table

limit

Entier

Facultatif. Nombre maximum de noms de tables à renvoyer (1 à 100). Par défaut : 100.

50

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "tableNames", "expression": ".response.TableNames"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient TableNames (liste de chaînes de noms de tables), et LastEvaluatedTableName lorsque d’autres pages existent. Consultez la référence de l’API ListTables.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: list-dynamodb-tables
description: List all DynamoDB tables in a region
steps:
- 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: end

Mettre à 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

region

Chaîne

Obligatoire. Région AWS de la table cible.

us-east-2

tableName

Chaîne

Obligatoire. Nom de la table DynamoDB.

Orders

awsRoleArn

Chaîne

Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Chaîne

Facultatif. ID de clé d’accès AWS. Passer en tant que secret.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Chaîne

Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Chaîne

Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.

${{ :secrets:awsSessionToken }}

attributeDefinitions

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.

[{"AttributeName": "id", "AttributeType": "S"}]

billingMode

Chaîne

Facultatif. Contrôle la façon dont le débit est facturé. Valeurs autorisées : PROVISIONED, PAY_PER_REQUEST.

PAY_PER_REQUEST

provisionedThroughput

Carte

Facultatif. Requis lorsque billingMode est PROVISIONED. Ne peut pas être défini lorsque billingMode est PAY_PER_REQUEST.

{"ReadCapacityUnits": 5, "WriteCapacityUnits": 5}

globalSecondaryIndexUpdates

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.

[{"Update": {"IndexName": "my-gsi", "ProvisionedThroughput": {"ReadCapacityUnits": 5, "WriteCapacityUnits": 5}}}]

streamSpecification

Carte

Facultatif. Paramètres pour DynamoDB Streams.

{"StreamEnabled": true, "StreamViewType": "NEW_AND_OLD_IMAGES"}

sseSpecification

Carte

Facultatif. Paramètres de chiffrement côté serveur.

{"Enabled": true, "SSEType": "KMS"}

deletionProtectionEnabled

Booléen

Facultatif. Activez ou désactivez la protection contre la suppression sur la table.

true

parameters

Carte

Facultatif. Transfert direct pour tout champ update_table non modélisé ci-dessus. Valeurs courantes : ReplicaUpdates (ajouter/supprimer des réplicas de tables globales), TableClass (STANDARD | STANDARD_INFREQUENT_ACCESS). Consultez la référence de l’API UpdateTable.

{"ReplicaUpdates": [{"Create": {"RegionName": "eu-west-1"}}]}

selectors

List

Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.

[{"name": "tableStatus", "expression": ".response.TableDescription.TableStatus"}]

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir

Type

Exemple

success

Booléen

true ou false

response

Objet

Contient TableDescription. Consultez la référence de l’API UpdateTable.

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Exemple

name: update-dynamodb-table
description: Switch a DynamoDB table to on-demand billing
steps:
- 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
Droits d'auteur © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.