Ações do AWS SQS

Esta página fornece uma referência para as ações do AWS SQS disponíveis no catálogo de ações de automação de fluxo de trabalho. Use essas ações para gerenciar filas e mensagens do Amazon SQS.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Enviar uma mensagem para uma fila SQS

O identificador da ação é aws.sqs.sendMessage.

Envia uma mensagem para uma fila específica do Amazon SQS.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila SQS de destino.	`https://sqs.us-east-2.amazonaws.com/123456789012/my-queue`
`messageBody`	Corda	Obrigatório. Corpo da mensagem para enviar à fila.	`"This is a test message"`
`messageDeduplicationId`	Corda	Opcional. Token usado para desduplicação em filas FIFO.	`"abc123deduplicationId5678"`
`messageGroupId`	Corda	Opcional. ID do grupo de mensagens para filas FIFO.	`"group1"`
`messageAttributes`	Mapa	Opcional. Atributos de mensagem como pares de valor principal.	`{"my_attribute_name_1": {"DataType": "String", "StringValue": "my_attribute_value_1"}}`
`delaySeconds`	Interno	Opcional. Número de segundos para atrasar a entrega da mensagem.	`123`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"statusCode": 200, "payload": {"MessageId": "e9b73a52-...", "MD5OfMessageBody": "fae535c7f..."}}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."`

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

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

Receber uma mensagem de uma fila SQS

O identificador da ação é aws.sqs.receiveMessage.

Recupera uma ou mais mensagens da fila especificada.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila SQS de destino.	`https://sqs.us-east-2.amazonaws.com/123456789012/my-queue`
`maxNumberOfMessages`	Interno	Opcional. Número máximo de mensagens a serem recuperadas (1–10).	`10`
`waitTimeSeconds`	Interno	Opcional. Duração em segundos para long-polling.	`5`
`VisibilityTimeout`	Interno	Opcional. Duração em segundos em que as mensagens recebidas ficam ocultas de outros consumidores.	`123`
`AttributeNames`	Lista	Opcional. Nomes dos atributos da fila a serem incluídos na resposta.	`["All"]`
`messageAttributeNames`	Lista	Opcional. Nomes de atributos de mensagem a serem recuperados.	`["message_attribute_name"]`
`messageSystemAttributeNames`	Lista	Opcional. Atributos de mensagem do sistema a serem recuperados.	`["SenderId", "SentTimestamp"]`
`receiveRequestAttemptId`	Corda	Opcional. Token de desduplicação para requests de recebimento de fila FIFO.	`"req-1234abcd"`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"Messages": [{"MessageId": "...", "Body": "...", "ReceiptHandle": "..."}]}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"SQS.Client.exceptions.QueueDoesNotExist: The specified queue does not exist."`

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

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

Criar uma fila SQS

O identificador da ação é aws.sqs.createQueue.

Cria uma nova fila do Amazon SQS com a configuração especificada.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila será criada.	`us-east-1`
`queueName`	Corda	Obrigatório. Nome para a nova fila (1–80 caracteres). Deve ser único na sua conta e região. Para filas FIFO, o nome deve terminar com `.fifo` .	`"my-app-queue"`
`attributes`	Mapa	Opcional. Atributos da fila como pares de valor principal. Atributos comuns: `DelaySeconds` , `MessageRetentionPeriod` , `VisibilityTimeout` , `RedrivePolicy` . Todos os valores devem ser strings, incluindo valores numéricos.	`{"DelaySeconds": "0", "MessageRetentionPeriod": "345600"}`
`tags`	Mapa	Opcional. Tags para atribuir à fila como pares de valor principal. Máximo de 50 tags. O prefixo `aws:` é reservado.	`{"Environment": "production", "Team": "backend"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "queueUrl", "expression": ".response.QueueUrl"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"QueueUrl": "https://sqs.us-east-1.amazonaws.com/123456789012/my-queue"}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Excluir uma fila SQS

O identificador da ação é aws.sqs.deleteQueue.

Exclui uma fila do Amazon SQS. Todas as mensagens na fila são excluídas permanentemente e esta operação não pode ser desfeita. Há um atraso de 60 segundos antes que você possa recriar uma fila com o mesmo nome.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila a ser excluída.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{}` (vazio em caso de sucesso)
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{}

(vazio em caso de sucesso)

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Obter atributos da fila do SQS

O identificador da ação é aws.sqs.getQueueAttributes.

Recupera atributos de uma fila do Amazon SQS, incluindo contagens de mensagens, ARN, tempo limite de visibilidade e outra configuração. Os nomes de atributos diferenciam maiúsculas de minúsculas.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`attributeNames`	Lista	Opcional. Nomes dos atributos a recuperar. Use `["All"]` para retornar todos os atributos. O padrão é todos.	`["ApproximateNumberOfMessages", "QueueArn"]`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "messageCount", "expression": ".response.Attributes.ApproximateNumberOfMessages"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"Attributes": {"QueueArn": "arn:aws:sqs:...", "ApproximateNumberOfMessages": "5", "VisibilityTimeout": "30"}}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Definir atributos da fila SQS

O identificador da ação é aws.sqs.setQueueAttributes.

Atualiza um ou mais atributos de uma fila do Amazon SQS. Todos os valores de atributo devem ser strings, incluindo valores numéricos.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila a ser atualizada.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`attributes`	Mapa	Obrigatório. Atributos da fila a serem definidos como pares de valor principal. Atributos comuns: `DelaySeconds` , `MessageRetentionPeriod` , `VisibilityTimeout` , `RedrivePolicy` , `KmsMasterKeyId` . Todos os valores devem ser strings.	`{"VisibilityTimeout": "60", "MessageRetentionPeriod": "345600"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{}` (vazio em caso de sucesso)
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{}

(vazio em caso de sucesso)

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Limpar uma fila SQS

O identificador da ação é aws.sqs.purgeQueue.

Exclui todas as mensagens em uma fila do Amazon SQS sem excluir a própria fila. Esta operação é irreversível. A limpeza pode levar até 60 segundos para ser concluída, e as mensagens enviadas durante essa janela também podem ser excluídas.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila a ser limpa.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{}` (vazio em caso de sucesso)
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{}

(vazio em caso de sucesso)

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Listar filas SQS

O identificador da ação é aws.sqs.listQueues.

Lista as filas do SQS na sua conta da AWS, opcionalmente filtradas pelo prefixo do nome da fila. A correspondência do nome da fila diferencia maiúsculas de minúsculas. Retorna até 1.000 resultados por solicitação por padrão.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS para listar filas.	`us-east-2`
`queueNamePrefix`	Corda	Opcional. Filtrar filas por prefixo de nome.	`"prod-"`
`maxResults`	Número	Opcional. Número máximo de resultados a serem retornados (1–1000). O padrão é 1000.	`100`
`nextToken`	Corda	Opcional. Token de paginação de uma resposta anterior para recuperar a próxima página de resultados.
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "queueUrls", "expression": ".response.QueueUrls // []"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"QueueUrls": ["https://sqs.us-east-1.amazonaws.com/123456789012/queue1", "..."], "NextToken": "..."}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Excluir uma mensagem de uma fila SQS

O identificador da ação é aws.sqs.deleteMessage.

Exclui uma mensagem específica de uma fila do Amazon SQS usando seu identificador de recebimento. Obtenha o identificador de recebimento de aws.sqs.receiveMessage. Os identificadores de recebimento expiram após o tempo limite de visibilidade da fila. Se o tempo limite expirar, receba a mensagem novamente para obter um novo identificador.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila que contém a mensagem.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`receiptHandle`	Corda	Obrigatório. Identificador de recebimento da mensagem a excluir. Obtido de `aws.sqs.receiveMessage` .
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{}` (vazio em caso de sucesso)
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{}

(vazio em caso de sucesso)

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Adicionar tag a uma fila SQS

O identificador da ação é aws.sqs.tagQueue.

Adiciona ou atualiza tags em uma fila do Amazon SQS. Esta operação adiciona ou atualiza apenas as tags especificadas sem remover as tags existentes. Máximo de 50 tags por fila. As chaves e os valores de tag diferenciam maiúsculas de minúsculas. O prefixo aws: é reservado e não pode ser usado.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila para adicionar a tag.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`tags`	Mapa	Obrigatório. Tags para adicionar ou atualizar como pares de valor principal.	`{"Environment": "production", "Team": "backend"}`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{}` (vazio em caso de sucesso)
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{}

(vazio em caso de sucesso)

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Remover tags de uma fila SQS

O identificador da ação é aws.sqs.untagQueue.

Remove as tags especificadas de uma fila do Amazon SQS. As chaves de tag diferenciam maiúsculas de minúsculas. Especificar chaves que não existem não causa um erro.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila para remover as tags.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`tagKeys`	Lista	Obrigatório. Chaves de tag para remover da fila.	`["TestRun", "ExpirationDate"]`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".success"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{}` (vazio em caso de sucesso)
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{}

(vazio em caso de sucesso)

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Listar tags da fila SQS

O identificador da ação é aws.sqs.listQueueTags.

Lista todas as tags associadas a uma fila do Amazon SQS.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila está localizada.	`us-east-2`
`queueUrl`	Corda	Obrigatório. URL da fila.	`https://sqs.us-east-1.amazonaws.com/123456789012/my-queue`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "tags", "expression": ".response.Tags"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"Tags": {"Environment": "production", "Team": "backend"}}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Iniciar uma tarefa de movimentação de mensagens

O identificador da ação é aws.sqs.startMessageMoveTask.

Inicia uma tarefa para mover mensagens de uma fila para outra. O principal caso de uso é recuperar mensagens de uma fila de mensagens mortas (DLQ) de volta para a fila de origem. Apenas uma tarefa ativa de movimentação de mensagens é permitida por fila de origem por vez.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde as filas estão localizadas.	`us-east-2`
`sourceArn`	Corda	Obrigatório. ARN da fila de origem (normalmente uma DLQ) da qual mover as mensagens.	`arn:aws:sqs:us-east-1:123456789012:my-app-dlq`
`destinationArn`	Corda	Opcional. ARN da fila de destino. Se não especificado, as mensagens retornam para a fila de origem original.	`arn:aws:sqs:us-east-1:123456789012:my-app-queue`
`maxNumberOfMessagesPerSecond`	Número	Opcional. Máximo de mensagens para mover por segundo (1–500). Use valores mais baixos para evitar sobrecarregar a fila de destino.	`100`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "taskHandle", "expression": ".response.TaskHandle"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"TaskHandle": "AQEBIYN..."}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Listar tarefas de movimentação de mensagens

O identificador da ação é aws.sqs.listMessageMoveTasks.

Lista as tarefas de movimentação de mensagens para uma fila de origem e verifica seu status. Use esta ação para monitorar o progresso das operações de recuperação de DLQ.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde a fila de origem está localizada.	`us-east-2`
`sourceArn`	Corda	Obrigatório. ARN da fila de origem para a qual listar tarefas.	`arn:aws:sqs:us-east-1:123456789012:my-app-dlq`
`maxResults`	Número	Opcional. Número máximo de resultados a retornar (1–10). O padrão é 10.	`10`
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "taskStatus", "expression": ".response.Results[0].Status"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"Results": [{"TaskHandle": "...", "Status": "RUNNING", "SourceArn": "...", "ApproximateNumberOfMessagesMoved": 42}]}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Cancelar uma tarefa de movimentação de mensagem

O identificador da ação é aws.sqs.cancelMessageMoveTask.

Cancela uma tarefa de movimentação de mensagens em execução. O cancelamento não é imediato — o status da tarefa transita por CANCELLING antes de chegar a CANCELLED. As mensagens já movidas não são revertidas.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS onde as filas estão localizadas.	`us-east-2`
`taskHandle`	Corda	Obrigatório. Identificador de tarefa retornado por `aws.sqs.startMessageMoveTask` . Os identificadores de tarefa expiram após a conclusão da tarefa.
`selectors`	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "messagesMoved", "expression": ".response.ApproximateNumberOfMessagesMoved"}]`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"ApproximateNumberOfMessagesMoved": 127}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	Mensagem de erro em caso de falha.

Saída

Tipo

Exemplo

response

Objeto

{"ApproximateNumberOfMessagesMoved": 127}

success

Boleano

true

false

errorMessage

Corda

Mensagem de erro em caso de falha.

Esta tradução de máquina é fornecida para sua comodidade.

Pré-requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Enviar uma mensagem para uma fila SQS

Receber uma mensagem de uma fila SQS

Criar uma fila SQS

Excluir uma fila SQS

Obter atributos da fila do SQS

Definir atributos da fila SQS

Limpar uma fila SQS

Listar filas SQS

Excluir uma mensagem de uma fila SQS

Adicionar tag a uma fila SQS

Remover tags de uma fila SQS

Listar tags da fila SQS

Iniciar uma tarefa de movimentação de mensagens

Listar tarefas de movimentação de mensagens

Cancelar uma tarefa de movimentação de mensagem

Pré-requisitos