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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente SQS cible. |
|
| Chaîne | Obligatoire. Corps du message à envoyer à la file d’attente. |
|
| Chaîne | Facultatif. Jeton utilisé pour la déduplication dans les files d'attente FIFO. |
|
| Chaîne | Facultatif. ID de groupe de messages pour les files d’attente FIFO. |
|
| Carte | Facultatif. Attributs de message sous forme de paires valeur clé. |
|
| Int | Facultatif. Nombre de secondes pour retarder la distribution du message. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| Chaîne |
|
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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente SQS cible. |
|
| Int | Facultatif. Nombre maximal de messages à récupérer (1 à 10). |
|
| Int | Facultatif. Durée en secondes pour le long-polling. |
|
| Int | Facultatif. Durée en secondes pendant laquelle les messages reçus sont masqués pour les autres consommateurs. |
|
| List | Facultatif. Noms des attributs de la file d'attente à inclure dans la réponse. |
|
| List | Facultatif. Noms des attributs de message à récupérer. |
|
| List | Facultatif. Attributs de message système à récupérer. |
|
| Chaîne | Facultatif. Jeton de déduplication pour les requests de réception de file d'attente FIFO. |
|
Le tableau suivant décrit les champs de sortie pour cette action.
Sortir | Type | Exemple |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| Chaîne |
|
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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente sera créée. |
|
| 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
. |
|
| Carte | Facultatif. Attributs de file d’attente sous forme de paires valeur clé. Attributs communs :
,
,
,
. Toutes les valeurs doivent être des chaînes, y compris les valeurs numériques. |
|
| Carte | Facultatif. Tags à attribuer à la file d’attente sous forme de paires valeur clé. Maximum 50 tags. Le préfixe
est réservé. |
|
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente à supprimer. |
|
| 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 |
|---|---|---|
| Objet |
(vide en cas de succès) |
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente. |
|
| List | Facultatif. Noms des attributs à récupérer. Utilisez
pour renvoyer tous les attributs. Par défaut, tous. |
|
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente à mettre à jour. |
|
| Carte | Obligatoire. Attributs de la file d’attente à définir sous forme de paires valeur clé. Attributs courants :
,
,
,
,
. Toutes les valeurs doivent être des chaînes de caractères. |
|
| 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 |
|---|---|---|
| Objet |
(vide en cas de succès) |
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente à purger. |
|
| 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 |
|---|---|---|
| Objet |
(vide en cas de succès) |
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS à partir de laquelle lister les files d'attente. |
|
| Chaîne | Facultatif. Filtrer les files d'attente par préfixe de nom. |
|
| Nombre | Facultatif. Nombre maximal de résultats à renvoyer (1 à 1000). La valeur par défaut est 1000. |
|
| Chaîne | Facultatif. Jeton de pagination d'une réponse précédente pour récupérer la page de résultats suivante. | |
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d’attente contenant le message. |
|
| Chaîne | Obligatoire. Identifiant de réception du message à supprimer. Obtenu à partir de
. | |
| 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 |
|---|---|---|
| Objet |
(vide en cas de succès) |
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d’attente à tag. |
|
| Carte | Obligatoire. Tags à ajouter ou à mettre à jour sous forme de paires valeur clé. |
|
| 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 |
|---|---|---|
| Objet |
(vide en cas de succès) |
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente à détaguer. |
|
| List | Obligatoire. Clés de tag à supprimer de la file d'attente. |
|
| 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 |
|---|---|---|
| Objet |
(vide en cas de succès) |
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où la file d'attente est située. |
|
| Chaîne | Obligatoire. URL de la file d'attente. |
|
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où les files d'attente sont situées. |
|
| Chaîne | Obligatoire. ARN de la file d'attente source (généralement une DLQ) à partir de laquelle déplacer les messages. |
|
| 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. |
|
| 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. |
|
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où se trouve la file d'attente source. |
|
| Chaîne | Obligatoire. ARN de la file d’attente source pour laquelle lister les tâches. |
|
| Nombre | Facultatif. Nombre maximal de résultats à renvoyer (1 à 10). La valeur par défaut est 10. |
|
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| 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 |
|---|---|---|---|
| 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 | Obligatoire. Région AWS où les files d'attente sont situées. |
|
| Chaîne | Obligatoire. Identifiant de tâche renvoyé par
. Les descripteurs de tâche expirent une fois la tâche terminée. | |
| 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 |
|---|---|---|
| Objet |
|
| Booléen |
ou
|
| Chaîne | Message d’erreur en cas d’échec. |