• /
  • 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 SQS

|View as Markdown (English)

Cette page fournit une référence pour les actions AWS SQS disponibles dans le catalogue des actions d’automatisation workflow. Utilisez ces actions pour gérer les files d’attente et les messages Amazon SQS.

Prérequis

Pour les prérequis et la configuration des identifiants, consultez Configurer les identifiants AWS.

Envoyer un message à une file d'attente SQS

L’identifiant de l’action est aws.sqs.sendMessage.

Envoie un message à une file d'attente Amazon SQS spécifiée.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente SQS cible.

https://sqs.us-east-2.amazonaws.com/123456789012/my-queue

messageBody

Chaîne

Obligatoire.

Corps du message à envoyer à la file d’attente.

"This is a test message"

messageDeduplicationId

Chaîne

Facultatif.

Jeton utilisé pour la déduplication dans les files d'attente FIFO.

"abc123deduplicationId5678"

messageGroupId

Chaîne

Facultatif.

ID de groupe de messages pour les files d’attente FIFO.

"group1"

messageAttributes

Carte

Facultatif.

Attributs de message sous forme de paires valeur clé.

{"my_attribute_name_1": {"DataType": "String", "StringValue": "my_attribute_value_1"}}

delaySeconds

Int

Facultatif.

Nombre de secondes pour retarder la distribution du message.

123

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

Sortir

Type

Exemple

response

Objet

{"statusCode": 200, "payload": {"MessageId": "e9b73a52-...", "MD5OfMessageBody": "fae535c7f..."}}

success

Booléen

true

ou

false

errorMessage

Chaîne

"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."

Recevoir un message d’une file d’attente SQS

L’identifiant de l’action est aws.sqs.receiveMessage.

Récupère un ou plusieurs messages de la file d’attente spécifiée.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente SQS cible.

https://sqs.us-east-2.amazonaws.com/123456789012/my-queue

maxNumberOfMessages

Int

Facultatif.

Nombre maximal de messages à récupérer (1 à 10).

10

waitTimeSeconds

Int

Facultatif.

Durée en secondes pour le long-polling.

5

VisibilityTimeout

Int

Facultatif.

Durée en secondes pendant laquelle les messages reçus sont masqués pour les autres consommateurs.

123

AttributeNames

List

Facultatif.

Noms des attributs de la file d'attente à inclure dans la réponse.

["All"]

messageAttributeNames

List

Facultatif.

Noms des attributs de message à récupérer.

["message_attribute_name"]

messageSystemAttributeNames

List

Facultatif.

Attributs de message système à récupérer.

["SenderId", "SentTimestamp"]

receiveRequestAttemptId

Chaîne

Facultatif.

Jeton de déduplication pour les requests de réception de file d'attente FIFO.

"req-1234abcd"

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

Sortir

Type

Exemple

response

Objet

{"Messages": [{"MessageId": "...", "Body": "...", "ReceiptHandle": "..."}]}

success

Booléen

true

ou

false

errorMessage

Chaîne

"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."

Créer une file d’attente SQS

L’identifiant de l’action est aws.sqs.createQueue.

Crée une nouvelle file d’attente Amazon SQS avec la configuration spécifiée.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente sera créée.

us-east-1

queueName

Chaîne

Obligatoire.

Nom de la nouvelle file d'attente (1 à 80 caractères). Doit être unique au sein de votre compte et de votre région. Pour les files d'attente FIFO, le nom doit se terminer par

.fifo

.

"my-app-queue"

attributes

Carte

Facultatif.

Attributs de file d’attente sous forme de paires valeur clé. Attributs communs :

DelaySeconds

,

MessageRetentionPeriod

,

VisibilityTimeout

,

RedrivePolicy

. Toutes les valeurs doivent être des chaînes, y compris les valeurs numériques.

{"DelaySeconds": "0", "MessageRetentionPeriod": "345600"}

tags

Carte

Facultatif.

Tags à attribuer à la file d’attente sous forme de paires valeur clé. Maximum 50 tags. Le préfixe

aws:

est réservé.

{"Environment": "production", "Team": "backend"}

selectors

List

Facultatif.

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

[{"name": "queueUrl", "expression": ".response.QueueUrl"}]

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

Sortir

Type

Exemple

response

Objet

{"QueueUrl": "https://sqs.us-east-1.amazonaws.com/123456789012/my-queue"}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Supprimer une file d'attente SQS

L’identifiant de l’action est aws.sqs.deleteQueue.

Supprime une file d’attente Amazon SQS. Tous les messages de la file d’attente sont définitivement supprimés et cette opération ne peut pas être annulée. Il y a un délai de 60 secondes avant que vous puissiez recréer une file d’attente avec le même nom.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente à supprimer.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

selectors

List

Facultatif.

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

[{"name": "status", "expression": ".success"}]

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

Sortir

Type

Exemple

response

Objet

{}

(vide en cas de succès)

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Obtenir les attributs de la file d’attente SQS

L’identifiant de l’action est aws.sqs.getQueueAttributes.

Récupère les attributs d’une file d’attente Amazon SQS, y compris le nombre de messages, l’ARN, le délai de visibilité et d'autre configuration. Les noms d’attribut sont sensibles à la casse.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

attributeNames

List

Facultatif.

Noms des attributs à récupérer. Utilisez

["All"]

pour renvoyer tous les attributs. Par défaut, tous.

["ApproximateNumberOfMessages", "QueueArn"]

selectors

List

Facultatif.

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

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

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

Sortir

Type

Exemple

response

Objet

{"Attributes": {"QueueArn": "arn:aws:sqs:...", "ApproximateNumberOfMessages": "5", "VisibilityTimeout": "30"}}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Définir les attributs de la file d'attente SQS

L’identifiant de l’action est aws.sqs.setQueueAttributes.

Met à jour un ou plusieurs attributs d’une file d’attente Amazon SQS. Toutes les valeurs d’attribut doivent être des chaînes, y compris les valeurs numériques.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente à mettre à jour.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

attributes

Carte

Obligatoire.

Attributs de la file d’attente à définir sous forme de paires valeur clé. Attributs courants :

DelaySeconds

,

MessageRetentionPeriod

,

VisibilityTimeout

,

RedrivePolicy

,

KmsMasterKeyId

. Toutes les valeurs doivent être des chaînes de caractères.

{"VisibilityTimeout": "60", "MessageRetentionPeriod": "345600"}

selectors

List

Facultatif.

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

[{"name": "status", "expression": ".success"}]

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

Sortir

Type

Exemple

response

Objet

{}

(vide en cas de succès)

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Purger une file d'attente SQS

L’identifiant de l’action est aws.sqs.purgeQueue.

Supprime tous les messages d’une file d’attente Amazon SQS sans supprimer la file d’attente elle-même. Cette opération est irréversible. La purge peut prendre jusqu'à 60 secondes pour se terminer, et les messages envoyés pendant cette fenêtre peuvent également être supprimés.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente à purger.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

selectors

List

Facultatif.

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

[{"name": "status", "expression": ".success"}]

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

Sortir

Type

Exemple

response

Objet

{}

(vide en cas de succès)

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Lister les files d’attente SQS

L’identifiant de l’action est aws.sqs.listQueues.

Répertorie les files d’attente SQS de votre compte AWS, éventuellement filtrées par préfixe de nom de file d’attente. La correspondance du nom de la file d’attente est sensible à la casse. Renvoie jusqu’à 1000 résultats par requête par défaut.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS à partir de laquelle lister les files d'attente.

us-east-2

queueNamePrefix

Chaîne

Facultatif.

Filtrer les files d'attente par préfixe de nom.

"prod-"

maxResults

Nombre

Facultatif.

Nombre maximal de résultats à renvoyer (1 à 1000). La valeur par défaut est 1000.

100

nextToken

Chaîne

Facultatif.

Jeton de pagination d'une réponse précédente pour récupérer la page de résultats suivante.

selectors

List

Facultatif.

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

[{"name": "queueUrls", "expression": ".response.QueueUrls // []"}]

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

Sortir

Type

Exemple

response

Objet

{"QueueUrls": ["https://sqs.us-east-1.amazonaws.com/123456789012/queue1", "..."], "NextToken": "..."}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Supprimer un message d'une file d'attente SQS

L’identifiant de l’action est aws.sqs.deleteMessage.

Supprime un message spécifique d’une file d’attente Amazon SQS à l’aide de son identifiant de réception. Obtenez l’identifiant de réception à partir de aws.sqs.receiveMessage. Les identifiants de réception expirent après le délai de visibilité de la file d’attente. Si le délai expire, recevez à nouveau le message pour obtenir un nouvel identifiant.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d’attente contenant le message.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

receiptHandle

Chaîne

Obligatoire.

Identifiant de réception du message à supprimer. Obtenu à partir de

aws.sqs.receiveMessage

.

selectors

List

Facultatif.

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

[{"name": "status", "expression": ".success"}]

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

Sortir

Type

Exemple

response

Objet

{}

(vide en cas de succès)

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Ajouter un tag à une file d'attente SQS

L’identifiant de l’action est aws.sqs.tagQueue.

Ajoute ou met à jour des tags sur une file d’attente Amazon SQS. Cette opération ajoute ou met à jour uniquement les tags spécifiés sans supprimer les tags existants. Maximum de 50 tags par file d’attente. Les clés et valeurs de tag sont sensibles à la casse. Le préfixe aws: est réservé et ne peut pas être utilisé.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d’attente à tag.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

tags

Carte

Obligatoire.

Tags à ajouter ou à mettre à jour sous forme de paires valeur clé.

{"Environment": "production", "Team": "backend"}

selectors

List

Facultatif.

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

[{"name": "status", "expression": ".success"}]

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

Sortir

Type

Exemple

response

Objet

{}

(vide en cas de succès)

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Supprimer des tags d'une file d'attente SQS

L’identifiant de l’action est aws.sqs.untagQueue.

Supprime les tags spécifiés d’une file d’attente Amazon SQS. Les clés de tag sont sensibles à la casse. Spécifier des clés qui n’existent pas ne provoque pas d’erreur.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente à détaguer.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

tagKeys

List

Obligatoire.

Clés de tag à supprimer de la file d'attente.

["TestRun", "ExpirationDate"]

selectors

List

Facultatif.

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

[{"name": "status", "expression": ".success"}]

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

Sortir

Type

Exemple

response

Objet

{}

(vide en cas de succès)

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Lister les tags de la file d'attente SQS

L’identifiant de l’action est aws.sqs.listQueueTags.

Répertorie tous les tags associés à une file d’attente Amazon SQS.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où la file d'attente est située.

us-east-2

queueUrl

Chaîne

Obligatoire.

URL de la file d'attente.

https://sqs.us-east-1.amazonaws.com/123456789012/my-queue

selectors

List

Facultatif.

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

[{"name": "tags", "expression": ".response.Tags"}]

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

Sortir

Type

Exemple

response

Objet

{"Tags": {"Environment": "production", "Team": "backend"}}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Démarrer une tâche de déplacement de message

L’identifiant de l’action est aws.sqs.startMessageMoveTask.

Démarre une tâche pour déplacer des messages d’une file d’attente à une autre. Le cas d’utilisation principal est la récupération de messages d’une file d’attente de lettres mortes (DLQ) vers la file d’attente source. Une seule tâche de déplacement de message active est autorisée par file d’attente source à la fois.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où les files d'attente sont situées.

us-east-2

sourceArn

Chaîne

Obligatoire.

ARN de la file d'attente source (généralement une DLQ) à partir de laquelle déplacer les messages.

arn:aws:sqs:us-east-1:123456789012:my-app-dlq

destinationArn

Chaîne

Facultatif.

ARN de la file d'attente de destination. Si non spécifié, les messages retournent à leur file d'attente source d'origine.

arn:aws:sqs:us-east-1:123456789012:my-app-queue

maxNumberOfMessagesPerSecond

Nombre

Facultatif.

Nombre maximum de messages à déplacer par seconde (1 à 500). Utilisez des valeurs plus faibles pour éviter de surcharger la file d’attente de destination.

100

selectors

List

Facultatif.

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

[{"name": "taskHandle", "expression": ".response.TaskHandle"}]

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

Sortir

Type

Exemple

response

Objet

{"TaskHandle": "AQEBIYN..."}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Lister les tâches de déplacement de messages

L’identifiant de l’action est aws.sqs.listMessageMoveTasks.

Liste les tâches de déplacement de messages pour une file d'attente source, et vérifie leur statut. Utilisez cette action pour monitorer la progression des opérations de récupération de DLQ.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où se trouve la file d'attente source.

us-east-2

sourceArn

Chaîne

Obligatoire.

ARN de la file d’attente source pour laquelle lister les tâches.

arn:aws:sqs:us-east-1:123456789012:my-app-dlq

maxResults

Nombre

Facultatif.

Nombre maximal de résultats à renvoyer (1 à 10). La valeur par défaut est 10.

10

selectors

List

Facultatif.

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

[{"name": "taskStatus", "expression": ".response.Results[0].Status"}]

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

Sortir

Type

Exemple

response

Objet

{"Results": [{"TaskHandle": "...", "Status": "RUNNING", "SourceArn": "...", "ApproximateNumberOfMessagesMoved": 42}]}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Annuler une tâche de déplacement de message

L’identifiant de l’action est aws.sqs.cancelMessageMoveTask.

Annule une tâche de déplacement de message en cours. L’annulation n’est pas immédiate : le statut de la tâche passe par CANCELLING avant d’atteindre CANCELLED. Les messages déjà déplacés ne sont pas annulés.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir

Type

Description

Exemple

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

region

Chaîne

Obligatoire.

Région AWS où les files d'attente sont situées.

us-east-2

taskHandle

Chaîne

Obligatoire.

Identifiant de tâche renvoyé par

aws.sqs.startMessageMoveTask

. Les descripteurs de tâche expirent une fois la tâche terminée.

selectors

List

Facultatif.

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

[{"name": "messagesMoved", "expression": ".response.ApproximateNumberOfMessagesMoved"}]

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

Sortir

Type

Exemple

response

Objet

{"ApproximateNumberOfMessagesMoved": 127}

success

Booléen

true

ou

false

errorMessage

Chaîne

Message d’erreur en cas d’échec.

Droits d'auteur © 2026 New Relic Inc.

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