Acciones de AWS SQS

Esta página proporciona una referencia de las acciones AWS SQS disponibles en el catálogo de acciones de automatización de flujo de trabajo. Use estas acciones para administrar colas y mensajes de Amazon SQS.

Requisitos previos

Para los requisitos previos y la configuración de credenciales, consulte Configurar las credenciales de AWS.

Enviar un mensaje a una cola de SQS

El identificador de la acción es aws.sqs.sendMessage.

Envía un mensaje a una cola específica de Amazon SQS.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola SQS objetivo.	`https://sqs.us-east-2.amazonaws.com/123456789012/my-queue`
`messageBody`	Cadena	Requerido. Cuerpo del mensaje para enviar a la cola.	`"This is a test message"`
`messageDeduplicationId`	Cadena	Opcional. Token utilizado para la deduplicación en colas FIFO.	`"abc123deduplicationId5678"`
`messageGroupId`	Cadena	Opcional. ID del grupo de mensajes para colas FIFO.	`"group1"`
`messageAttributes`	Mapa	Opcional. Atributos del mensaje como pares de valor principal.	`{"my_attribute_name_1": {"DataType": "String", "StringValue": "my_attribute_value_1"}}`
`delaySeconds`	En t	Opcional. Número de segundos para retrasar la entrega del mensaje.	`123`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"statusCode": 200, "payload": {"MessageId": "e9b73a52-...", "MD5OfMessageBody": "fae535c7f..."}}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	`"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."`

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

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

Recibir un mensaje de una cola SQS

El identificador de la acción es aws.sqs.receiveMessage.

Recupera uno o más mensajes de la cola especificada.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola SQS objetivo.	`https://sqs.us-east-2.amazonaws.com/123456789012/my-queue`
`maxNumberOfMessages`	En t	Opcional. Número máximo de mensajes a recuperar (1-10).	`10`
`waitTimeSeconds`	En t	Opcional. Duración en segundos para el sondeo largo.	`5`
`VisibilityTimeout`	En t	Opcional. Duración en segundos durante la cual los mensajes recibidos permanecen ocultos para otros consumidores.	`123`
`AttributeNames`	Lista	Opcional. Nombres de atributos de la cola a incluir en la respuesta.	`["All"]`
`messageAttributeNames`	Lista	Opcional. Nombres de atributos de mensajes para recuperar.	`["message_attribute_name"]`
`messageSystemAttributeNames`	Lista	Opcional. Atributos de mensaje del sistema a recuperar.	`["SenderId", "SentTimestamp"]`
`receiveRequestAttemptId`	Cadena	Opcional. Token de desduplicación para requests de recepción de cola FIFO.	`"req-1234abcd"`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"Messages": [{"MessageId": "...", "Body": "...", "ReceiptHandle": "..."}]}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	`"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."`

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

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

Crear una cola de SQS

El identificador de la acción es aws.sqs.createQueue.

Crea una nueva cola de Amazon SQS con la configuración especificada.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se creará la cola.	`us-east-1`
`queueName`	Cadena	Requerido. Nombre para la nueva cola (1-80 caracteres). Debe ser único dentro de su cuenta y región. Para las colas FIFO, el nombre debe terminar en `.fifo` .	`"my-app-queue"`
`attributes`	Mapa	Opcional. Atributos de la cola como pares de valor principal. Atributos comunes: `DelaySeconds` , `MessageRetentionPeriod` , `VisibilityTimeout` , `RedrivePolicy` . Todos los valores deben ser cadenas, incluidos los valores numéricos.	`{"DelaySeconds": "0", "MessageRetentionPeriod": "345600"}`
`tags`	Mapa	Opcional. Etiquetas a asignar a la cola como pares de valor principal. Máximo 50 etiquetas. El prefijo `aws:` está reservado.	`{"Environment": "production", "Team": "backend"}`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "queueUrl", "expression": ".response.QueueUrl"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"QueueUrl": "https://sqs.us-east-1.amazonaws.com/123456789012/my-queue"}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Eliminar una cola SQS

El identificador de la acción es aws.sqs.deleteQueue.

Elimina una cola de Amazon SQS. Todos los mensajes de la cola se eliminan de forma permanente y esta operación no se puede deshacer. Hay un retraso de 60 segundos antes de que pueda volver a crear una cola con el mismo nombre.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola a eliminar.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".success"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{}` (vacío en caso de éxito)
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{}

(vacío en caso de éxito)

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Obtener atributos de cola SQS

El identificador de la acción es aws.sqs.getQueueAttributes.

Recupera los atributos de una cola de Amazon SQS, incluidos los recuentos de mensajes, el ARN, el tiempo de espera de visibilidad y otra configuración. Los nombres de los atributos distinguen entre mayúsculas y minúsculas.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`attributeNames`	Lista	Opcional. Nombres de atributos a recuperar. Use `["All"]` para devolver todos los atributos. El valor predeterminado es todos.	`["ApproximateNumberOfMessages", "QueueArn"]`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "messageCount", "expression": ".response.Attributes.ApproximateNumberOfMessages"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"Attributes": {"QueueArn": "arn:aws:sqs:...", "ApproximateNumberOfMessages": "5", "VisibilityTimeout": "30"}}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Establecer atributos de la cola de SQS

El identificador de la acción es aws.sqs.setQueueAttributes.

Actualiza uno o más atributos de una cola de Amazon SQS. Todos los valores de los atributos deben ser cadenas, incluidos los valores numéricos.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola que se actualizará.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`attributes`	Mapa	Requerido. Atributos de la cola a establecer como pares de valor principal. Atributos comunes: `DelaySeconds` , `MessageRetentionPeriod` , `VisibilityTimeout` , `RedrivePolicy` , `KmsMasterKeyId` . Todos los valores deben ser cadenas.	`{"VisibilityTimeout": "60", "MessageRetentionPeriod": "345600"}`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".success"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{}` (vacío en caso de éxito)
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{}

(vacío en caso de éxito)

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Purgar una cola de SQS

El identificador de la acción es aws.sqs.purgeQueue.

Elimina todos los mensajes de una cola de Amazon SQS sin eliminar la cola en sí. Esta operación es irreversible. La purga puede tardar hasta 60 segundos en completarse, y los mensajes enviados durante esta ventana también pueden eliminarse.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola a purgar.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".success"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{}` (vacío en caso de éxito)
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{}

(vacío en caso de éxito)

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Listar colas SQS

El identificador de la acción es aws.sqs.listQueues.

Enumera las colas SQS en la cuenta de AWS, filtradas opcionalmente por el prefijo del nombre de la cola. La coincidencia del nombre de la cola distingue entre mayúsculas y minúsculas. Devuelve hasta 1000 resultados por solicitud de forma predeterminada.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS desde la cual listar las colas.	`us-east-2`
`queueNamePrefix`	Cadena	Opcional. Filtrar colas por prefijo de nombre.	`"prod-"`
`maxResults`	Número	Opcional. Número máximo de resultados que se devolverán (1-1000). El valor predeterminado es 1000.	`100`
`nextToken`	Cadena	Opcional. Token de paginación de una respuesta anterior para obtener la siguiente página de resultados.
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "queueUrls", "expression": ".response.QueueUrls // []"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"QueueUrls": ["https://sqs.us-east-1.amazonaws.com/123456789012/queue1", "..."], "NextToken": "..."}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Eliminar un mensaje de una cola de SQS

El identificador de la acción es aws.sqs.deleteMessage.

Elimina un mensaje específico de una cola de Amazon SQS mediante su identificador de recepción. Obtenga el identificador de recepción de aws.sqs.receiveMessage. Los identificadores de recepción caducan después del tiempo de espera de visibilidad de la cola. Si el tiempo de espera caduca, vuelva a recibir el mensaje para obtener un nuevo identificador.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola que contiene el mensaje.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`receiptHandle`	Cadena	Requerido. Identificador de recepción del mensaje a eliminar. Obtenido de `aws.sqs.receiveMessage` .
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".success"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{}` (vacío en caso de éxito)
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{}

(vacío en caso de éxito)

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Etiquetar una cola SQS

El identificador de la acción es aws.sqs.tagQueue.

Agrega o actualiza las etiquetas en una cola de Amazon SQS. Esta operación agrega o actualiza solo las etiquetas especificadas sin eliminar las etiquetas existentes. Máximo de 50 etiquetas por cola. Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. El prefijo aws: está reservado y no se puede utilizar.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola para etiquetar.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`tags`	Mapa	Requerido. Etiquetas para agregar o actualizar como pares de valor principal.	`{"Environment": "production", "Team": "backend"}`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".success"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{}` (vacío en caso de éxito)
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{}

(vacío en caso de éxito)

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Eliminar etiquetas de una cola de SQS

El identificador de la acción es aws.sqs.untagQueue.

Elimina las etiquetas especificadas de una cola de Amazon SQS. Las claves de etiqueta distinguen entre mayúsculas y minúsculas. Especificar claves que no existen no causa un error.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola de la que se eliminarán las etiquetas.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`tagKeys`	Lista	Requerido. Claves de etiqueta para eliminar de la cola.	`["TestRun", "ExpirationDate"]`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".success"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{}` (vacío en caso de éxito)
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{}

(vacío en caso de éxito)

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Listar las etiquetas de la cola de SQS

El identificador de la acción es aws.sqs.listQueueTags.

Enumera todas las etiquetas asociadas a una cola de Amazon SQS.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola.	`us-east-2`
`queueUrl`	Cadena	Requerido. URL de la cola.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "tags", "expression": ".response.Tags"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"Tags": {"Environment": "production", "Team": "backend"}}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Iniciar una tarea de movimiento de mensajes

El identificador de la acción es aws.sqs.startMessageMoveTask.

Inicia una tarea para mover mensajes de una cola a otra. El caso de uso principal es recuperar mensajes de una cola de mensajes no entregados (DLQ) y devolverlos a la cola de origen. Solo se permite una tarea activa de movimiento de mensajes por cola de origen a la vez.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentran las colas.	`us-east-2`
`sourceArn`	Cadena	Requerido. ARN de la cola de origen (generalmente una DLQ) desde la cual mover mensajes.	`arn:aws:sqs:us-east-1:123456789012:my-app-dlq`
`destinationArn`	Cadena	Opcional. ARN de la cola de destino. Si no se especifica, los mensajes vuelven a su cola de origen original.	`arn:aws:sqs:us-east-1:123456789012:my-app-queue`
`maxNumberOfMessagesPerSecond`	Número	Opcional. Máximo de mensajes para mover por segundo (1-500). Utilice valores más bajos para evitar sobrecargar la cola de destino.	`100`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "taskHandle", "expression": ".response.TaskHandle"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"TaskHandle": "AQEBIYN..."}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Listar tareas de movimiento de mensajes

El identificador de la acción es aws.sqs.listMessageMoveTasks.

Lista las tareas de movimiento de mensajes para una cola de origen y verifica su estado. Use esta acción para monitorear el progreso de las operaciones de recuperación de DLQ.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentra la cola de origen.	`us-east-2`
`sourceArn`	Cadena	Requerido. ARN de la cola de origen para la cual listar tareas.	`arn:aws:sqs:us-east-1:123456789012:my-app-dlq`
`maxResults`	Número	Opcional. Número máximo de resultados a devolver (1-10). El valor predeterminado es 10.	`10`
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "taskStatus", "expression": ".response.Results[0].Status"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"Results": [{"TaskHandle": "...", "Status": "RUNNING", "SourceArn": "...", "ApproximateNumberOfMessagesMoved": 42}]}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

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

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Cancelar una tarea de movimiento de mensajes

El identificador de la acción es aws.sqs.cancelMessageMoveTask.

Cancela una tarea de movimiento de mensajes en ejecución. La cancelación no es inmediata —el estado de la tarea pasa por CANCELLING antes de llegar a CANCELLED. Los mensajes que ya se movieron no se revierten.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS donde se encuentran las colas.	`us-east-2`
`taskHandle`	Cadena	Requerido. Identificador de tarea devuelto por `aws.sqs.startMessageMoveTask` . Los controladores de tareas caducan después de que se completa la tarea.
`selectors`	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "messagesMoved", "expression": ".response.ApproximateNumberOfMessagesMoved"}]`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"ApproximateNumberOfMessagesMoved": 127}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	Mensaje de error en caso de falla.

Producción

Tipo

Ejemplo

response

Objeto

{"ApproximateNumberOfMessagesMoved": 127}

success

Booleano

true

false

errorMessage

Cadena

Mensaje de error en caso de falla.

Te ofrecemos esta traducción automática para facilitar la lectura.

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

Enviar un mensaje a una cola de SQS

Recibir un mensaje de una cola SQS

Crear una cola de SQS

Eliminar una cola SQS

Obtener atributos de cola SQS

Establecer atributos de la cola de SQS

Purgar una cola de SQS

Listar colas SQS

Eliminar un mensaje de una cola de SQS

Etiquetar una cola SQS

Eliminar etiquetas de una cola de SQS

Listar las etiquetas de la cola de SQS

Iniciar una tarea de movimiento de mensajes

Listar tareas de movimiento de mensajes

Cancelar una tarea de movimiento de mensajes

Requisitos previos