

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplos de Amazon SQS que utilizan AWS CLI
<a name="cli_2_sqs_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface mediante Amazon SQS.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `add-permission`
<a name="sqs_AddPermission_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `add-permission`.

**AWS CLI**  
**Para añadir un permiso a una cola**  
Este ejemplo permite a la AWS cuenta especificada enviar mensajes a la cola especificada.  
Comando:  

```
aws sqs add-permission --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --label SendMessagesFromMyQueue --aws-account-ids 12345EXAMPLE --actions SendMessage
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [AddPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/add-permission.html)la *Referencia de AWS CLI comandos*. 

### `cancel-message-move-task`
<a name="sqs_CancelMessageMoveTask_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `cancel-message-move-task`.

**AWS CLI**  
**Para cancelar una tarea de traslado de mensajes**  
En el siguiente ejemplo de `cancel-message-move-task`, se cancela la tarea de traslado de mensajes especificada.  

```
aws sqs cancel-message-move-task \
    --task-handle AQEB6nR4...HzlvZQ==
```
Salida:  

```
{
    "ApproximateNumberOfMessagesMoved": 102
}
```
Para obtener más información, consulte [Amazon SQS API permissions: Actions and resource reference](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-api-permissions-reference.html) en la *Guía para desarrolladores*.  
+  Para obtener más información sobre la API, consulte [CancelMessageMoveTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/cancel-message-move-task.html)la *Referencia de AWS CLI comandos*. 

### `change-message-visibility-batch`
<a name="sqs_ChangeMessageVisibilityBatch_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `change-message-visibility-batch`.

**AWS CLI**  
**Para cambiar la visibilidad del tiempo de espera de varios mensajes en un lote**  
En este ejemplo, se cambia la visibilidad del tiempo de espera de dos mensajes especificados a 10 horas (10 horas \$1 60 minutos \$1 60 segundos).  
Comando:  

```
aws sqs change-message-visibility-batch --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --entries file://change-message-visibility-batch.json
```
Archivo de entrada (change-message-visibility-batch.json):  

```
[
  {
    "Id": "FirstMessage",
        "ReceiptHandle": "AQEBhz2q...Jf3kaw==",
        "VisibilityTimeout": 36000
  },
  {
    "Id": "SecondMessage",
        "ReceiptHandle": "AQEBkTUH...HifSnw==",
        "VisibilityTimeout": 36000
  }
]
```
Salida:  

```
{
  "Successful": [
    {
      "Id": "SecondMessage"
    },
    {
      "Id": "FirstMessage"
    }
  ]
}
```
+  Para obtener más información sobre la API, consulte [ChangeMessageVisibilityBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/change-message-visibility-batch.html)la *Referencia de AWS CLI comandos*. 

### `change-message-visibility`
<a name="sqs_ChangeMessageVisibility_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `change-message-visibility`.

**AWS CLI**  
**Cambio de la visibilidad del tiempo de espera de un mensaje**  
En este ejemplo, se cambia la visibilidad del tiempo de espera del mensaje especificado a 10 horas (10 horas \$1 60 minutos \$1 60 segundos).  
Comando:  

```
aws sqs change-message-visibility --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --receipt-handle AQEBTpyI...t6HyQg== --visibility-timeout 36000
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [ChangeMessageVisibility](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/change-message-visibility.html)la *Referencia de AWS CLI comandos*. 

### `create-queue`
<a name="sqs_CreateQueue_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-queue`.

**AWS CLI**  
**Para crear una cola**  
En este ejemplo, se crea una cola con el nombre especificado, se establece el período de retención de mensajes en 3 días (3 días \$1 24 horas \$1 60 minutos \$1 60 segundos) y se establece la cola de mensajes fallidos en la cola especificada con un recuento máximo de 1000 mensajes recibidos.  
Comando:  

```
aws sqs create-queue --queue-name MyQueue --attributes file://create-queue.json
```
Archivo de entrada (create-queue.json):  

```
{
  "RedrivePolicy": "{\"deadLetterTargetArn\":\"arn:aws:sqs:us-east-1:80398EXAMPLE:MyDeadLetterQueue\",\"maxReceiveCount\":\"1000\"}",
  "MessageRetentionPeriod": "259200"
}
```
Salida:  

```
{
  "QueueUrl": "https://queue.amazonaws.com/80398EXAMPLE/MyQueue"
}
```
+  Para obtener más información sobre la API, consulte [CreateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/create-queue.html)la *Referencia de AWS CLI comandos*. 

### `delete-message-batch`
<a name="sqs_DeleteMessageBatch_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-message-batch`.

**AWS CLI**  
**Eliminación de varios mensajes en un lote**  
En este ejemplo, se eliminan los mensajes especificados.  
Comando:  

```
aws sqs delete-message-batch --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --entries file://delete-message-batch.json
```
Archivo de entrada (delete-message-batch.json):  

```
[
  {
        "Id": "FirstMessage",
        "ReceiptHandle": "AQEB1mgl...Z4GuLw=="
  },
  {
    "Id": "SecondMessage",
        "ReceiptHandle": "AQEBLsYM...VQubAA=="
  }
]
```
Salida:  

```
{
  "Successful": [
    {
      "Id": "FirstMessage"
    },
    {
      "Id": "SecondMessage"
    }
  ]
}
```
+  Para obtener más información sobre la API, consulte [DeleteMessageBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/delete-message-batch.html)la *Referencia de AWS CLI comandos*. 

### `delete-message`
<a name="sqs_DeleteMessage_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-message`.

**AWS CLI**  
**Eliminación de un mensaje**  
En este ejemplo, se elimina el mensaje especificado.  
Comando:  

```
aws sqs delete-message --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --receipt-handle AQEBRXTo...q2doVA==
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [DeleteMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/delete-message.html)la *Referencia de AWS CLI comandos*. 

### `delete-queue`
<a name="sqs_DeleteQueue_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-queue`.

**AWS CLI**  
**Para eliminar una cola**  
En este ejemplo, se elimina la cola especificada.  
Comando:  

```
aws sqs delete-queue --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyNewerQueue
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [DeleteQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/delete-queue.html)la *Referencia de AWS CLI comandos*. 

### `get-queue-attributes`
<a name="sqs_GetQueueAttributes_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-queue-attributes`.

**AWS CLI**  
**Obtención de los atributos de una cola**  
En este ejemplo, se obtienen todos los atributos de la cola especificada.  
Comando:  

```
aws sqs get-queue-attributes --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --attribute-names All
```
Salida:  

```
{
  "Attributes": {
    "ApproximateNumberOfMessagesNotVisible": "0",
    "RedrivePolicy": "{\"deadLetterTargetArn\":\"arn:aws:sqs:us-east-1:80398EXAMPLE:MyDeadLetterQueue\",\"maxReceiveCount\":1000}",
    "MessageRetentionPeriod": "345600",
    "ApproximateNumberOfMessagesDelayed": "0",
    "MaximumMessageSize": "262144",
    "CreatedTimestamp": "1442426968",
    "ApproximateNumberOfMessages": "0",
    "ReceiveMessageWaitTimeSeconds": "0",
    "DelaySeconds": "0",
    "VisibilityTimeout": "30",
    "LastModifiedTimestamp": "1442426968",
    "QueueArn": "arn:aws:sqs:us-east-1:80398EXAMPLE:MyNewQueue"
  }
}
```
En este ejemplo, se obtienen únicamente los atributos de tamaño máximo de mensaje y tiempo de espera de visibilidad de la cola especificada.  
Comando:  

```
aws sqs get-queue-attributes --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyNewQueue --attribute-names MaximumMessageSize VisibilityTimeout
```
Salida:  

```
{
  "Attributes": {
    "VisibilityTimeout": "30",
    "MaximumMessageSize": "262144"
  }
}
```
+  Para obtener más información sobre la API, consulte [GetQueueAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/get-queue-attributes.html)la *Referencia de AWS CLI comandos*. 

### `get-queue-url`
<a name="sqs_GetQueueUrl_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-queue-url`.

**AWS CLI**  
**Obtención de la URL de una cola**  
En este ejemplo, se obtiene la URL de la cola especificada.  
Comando:  

```
aws sqs get-queue-url --queue-name MyQueue
```
Salida:  

```
{
  "QueueUrl": "https://queue.amazonaws.com/80398EXAMPLE/MyQueue"
}
```
+  Para obtener más información sobre la API, consulte [GetQueueUrl](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/get-queue-url.html)la *Referencia de AWS CLI comandos*. 

### `list-dead-letter-source-queues`
<a name="sqs_ListDeadLetterSourceQueues_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-dead-letter-source-queues`.

**AWS CLI**  
**Para enumerar las colas de origen de mensajes fallidos**  
En este ejemplo, se muestran las colas asociadas a la cola de origen de mensajes fallidos especificada.  
Comando:  

```
aws sqs list-dead-letter-source-queues --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue
```
Salida:  

```
{
  "queueUrls": [
    "https://queue.amazonaws.com/80398EXAMPLE/MyQueue",
    "https://queue.amazonaws.com/80398EXAMPLE/MyOtherQueue"
  ]
}
```
+  Para obtener más información sobre la API, consulte [ListDeadLetterSourceQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/list-dead-letter-source-queues.html)la *Referencia de AWS CLI comandos*. 

### `list-message-move-tasks`
<a name="sqs_ListMessageMoveTasks_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-message-move-tasks`.

**AWS CLI**  
**Para enumerar las tareas de traslado de mensajes**  
En el siguiente ejemplo de `list-message-move-tasks`, se enumeran las dos tareas de traslado de mensajes más recientes de la cola especificada.  

```
aws sqs list-message-move-tasks \
    --source-arn arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue \
    --max-results 2
```
Salida:  

```
{
    "Results": [
        {
            "TaskHandle": "AQEB6nR4...HzlvZQ==",
            "Status": "RUNNING",
            "SourceArn": "arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue1",
            "DestinationArn": "arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue2",
            "MaxNumberOfMessagesPerSecond": 50,
            "ApproximateNumberOfMessagesMoved": 203,
            "ApproximateNumberOfMessagesToMove": 30,
            "StartedTimestamp": 1442428276921
         },

         {
            "Status": "COMPLETED",
            "SourceArn": "arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue1",
            "DestinationArn": "arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue2",
            "ApproximateNumberOfMessagesMoved": 29,
            "ApproximateNumberOfMessagesToMove": 0,
            "StartedTimestamp": 1342428272093
         }
    ]
}
```
Para obtener más información, consulte [Amazon SQS API permissions: Actions and resource reference](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-api-permissions-reference.html) en la *Guía para desarrolladores*.  
+  Para obtener más información sobre la API, consulte [ListMessageMoveTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/list-message-move-tasks.html)la *Referencia de AWS CLI comandos*. 

### `list-queue-tags`
<a name="sqs_ListQueueTags_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-queue-tags`.

**AWS CLI**  
**Para enumerar todas las etiquetas de asignación de costos de una cola**  
En el siguiente ejemplo de `list-queue-tags`, se muestran todas las etiquetas de asignación de costos asociadas a la cola especificada.  

```
aws sqs list-queue-tags \
    --queue-url https://sqs.us-west-2.amazonaws.com/123456789012/MyQueue
```
Salida:  

```
{
    "Tags": {
        "Team": "Alpha"
    }
}
```
Para obtener más información, consulte [Listing Cost Allocation Tags](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html) en la *Guía para desarrolladores de Amazon Simple Queue Service*.  
+  Para obtener más información sobre la API, consulte [ListQueueTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/list-queue-tags.html)la *Referencia de AWS CLI comandos*. 

### `list-queues`
<a name="sqs_ListQueues_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-queues`.

**AWS CLI**  
**Creación de una lista de las colas**  
En este ejemplo, se enumeran todas las colas.  
Comando:  

```
aws sqs list-queues
```
Salida:  

```
{
  "QueueUrls": [
    "https://queue.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue",
    "https://queue.amazonaws.com/80398EXAMPLE/MyQueue",
    "https://queue.amazonaws.com/80398EXAMPLE/MyOtherQueue",
    "https://queue.amazonaws.com/80398EXAMPLE/TestQueue1",
        "https://queue.amazonaws.com/80398EXAMPLE/TestQueue2"
  ]
}
```
En este ejemplo, solo se muestran las colas que comienzan por "My".  
Comando:  

```
aws sqs list-queues --queue-name-prefix My
```
Salida:  

```
{
  "QueueUrls": [
    "https://queue.amazonaws.com/80398EXAMPLE/MyDeadLetterQueue",
    "https://queue.amazonaws.com/80398EXAMPLE/MyQueue",
    "https://queue.amazonaws.com/80398EXAMPLE/MyOtherQueue"
  ]
}
```
+  Para obtener más información sobre la API, consulte [ListQueues](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/list-queues.html)la *Referencia de AWS CLI comandos*. 

### `purge-queue`
<a name="sqs_PurgeQueue_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `purge-queue`.

**AWS CLI**  
**Para purgar una cola**  
En este ejemplo, se eliminan los mensajes de la cola especificada.  
Comando:  

```
aws sqs purge-queue --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyNewQueue
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [PurgeQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/purge-queue.html)la *Referencia de AWS CLI comandos*. 

### `receive-message`
<a name="sqs_ReceiveMessage_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `receive-message`.

**AWS CLI**  
**Recepción de un mensaje**  
En este ejemplo, se reciben hasta 10 mensajes disponibles y se devuelven todos los atributos disponibles.  
Comando:  

```
aws sqs receive-message --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --attribute-names All --message-attribute-names All --max-number-of-messages 10
```
Salida:  

```
{
  "Messages": [
    {
      "Body": "My first message.",
      "ReceiptHandle": "AQEBzbVv...fqNzFw==",
      "MD5OfBody": "1000f835...a35411fa",
      "MD5OfMessageAttributes": "9424c491...26bc3ae7",
      "MessageId": "d6790f8d-d575-4f01-bc51-40122EXAMPLE",
      "Attributes": {
        "ApproximateFirstReceiveTimestamp": "1442428276921",
        "SenderId": "AIDAIAZKMSNQ7TEXAMPLE",
        "ApproximateReceiveCount": "5",
        "SentTimestamp": "1442428276921"
      },
      "MessageAttributes": {
        "PostalCode": {
          "DataType": "String",
          "StringValue": "ABC123"
        },
        "City": {
          "DataType": "String",
          "StringValue": "Any City"
        }
      }
    }
  ]
}
```
En este ejemplo, se recibe el siguiente mensaje disponible y se devuelven solo los SentTimestamp atributos SenderId y, además, el atributo del PostalCode mensaje.  
Comando:  

```
aws sqs receive-message --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --attribute-names SenderId SentTimestamp --message-attribute-names PostalCode
```
Salida:  

```
{
  "Messages": [
    {
      "Body": "My first message.",
      "ReceiptHandle": "AQEB6nR4...HzlvZQ==",
      "MD5OfBody": "1000f835...a35411fa",
      "MD5OfMessageAttributes": "b8e89563...e088e74f",
      "MessageId": "d6790f8d-d575-4f01-bc51-40122EXAMPLE",
      "Attributes": {
        "SenderId": "AIDAIAZKMSNQ7TEXAMPLE",
        "SentTimestamp": "1442428276921"
      },
      "MessageAttributes": {
        "PostalCode": {
          "DataType": "String",
          "StringValue": "ABC123"
        }
      }
    }
  ]
}
```
+  Para obtener más información sobre la API, consulte [ReceiveMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/receive-message.html)la *Referencia de AWS CLI comandos*. 

### `remove-permission`
<a name="sqs_RemovePermission_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `remove-permission`.

**AWS CLI**  
**Para eliminar un permiso**  
En este ejemplo, se quita el permiso con la etiqueta especificada de la cola indicada.  
Comando:  

```
aws sqs remove-permission --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --label SendMessagesFromMyQueue
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [RemovePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/remove-permission.html)la *Referencia de AWS CLI comandos*. 

### `send-message-batch`
<a name="sqs_SendMessageBatch_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `send-message-batch`.

**AWS CLI**  
**Envío de varios mensajes por lotes**  
En este ejemplo, se envían 2 mensajes con los cuerpos de los mensajes, los períodos de retraso y los atributos de los mensajes especificados a la cola especificada.  
Comando:  

```
aws sqs send-message-batch --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --entries file://send-message-batch.json
```
Archivo de entrada (send-message-batch.json):  

```
[
  {
    "Id": "FuelReport-0001-2015-09-16T140731Z",
        "MessageBody": "Fuel report for account 0001 on 2015-09-16 at 02:07:31 PM.",
        "DelaySeconds": 10,
        "MessageAttributes": {
          "SellerName": {
            "DataType": "String",
                "StringValue": "Example Store"
      },
          "City": {
        "DataType": "String",
        "StringValue": "Any City"
      },
          "Region": {
            "DataType": "String",
                "StringValue": "WA"
      },
          "PostalCode": {
            "DataType": "String",
                "StringValue": "99065"
          },
          "PricePerGallon": {
            "DataType": "Number",
                "StringValue": "1.99"
      }
        }
  },
  {
    "Id": "FuelReport-0002-2015-09-16T140930Z",
        "MessageBody": "Fuel report for account 0002 on 2015-09-16 at 02:09:30 PM.",
        "DelaySeconds": 10,
        "MessageAttributes": {
          "SellerName": {
            "DataType": "String",
                "StringValue": "Example Fuels"
      },
          "City": {
        "DataType": "String",
        "StringValue": "North Town"
      },
          "Region": {
            "DataType": "String",
                "StringValue": "WA"
      },
          "PostalCode": {
            "DataType": "String",
                "StringValue": "99123"
          },
          "PricePerGallon": {
            "DataType": "Number",
                "StringValue": "1.87"
      }
        }
  }
]
```
Salida:  

```
{
  "Successful": [
    {
      "MD5OfMessageBody": "203c4a38...7943237e",
      "MD5OfMessageAttributes": "10809b55...baf283ef",
      "Id": "FuelReport-0001-2015-09-16T140731Z",
      "MessageId": "d175070c-d6b8-4101-861d-adeb3EXAMPLE"
    },
    {
      "MD5OfMessageBody": "2cf0159a...c1980595",
      "MD5OfMessageAttributes": "55623928...ae354a25",
      "Id": "FuelReport-0002-2015-09-16T140930Z",
      "MessageId": "f9b7d55d-0570-413e-b9c5-a9264EXAMPLE"
    }
  ]
}
```
+  Para obtener más información sobre la API, consulte [SendMessageBatch](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/send-message-batch.html)la *Referencia de AWS CLI comandos*. 

### `send-message`
<a name="sqs_SendMessage_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `send-message`.

**AWS CLI**  
**Para enviar un mensaje**  
En este ejemplo, se envía un mensaje con el cuerpo del mensaje, el período de retraso y los atributos del mensaje especificados a la cola especificada.  
Comando:  

```
aws sqs send-message --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyQueue --message-body "Information about the largest city in Any Region." --delay-seconds 10 --message-attributes file://send-message.json
```
Archivo de entrada (send-message.json):  

```
{
  "City": {
    "DataType": "String",
    "StringValue": "Any City"
  },
  "Greeting": {
    "DataType": "Binary",
    "BinaryValue": "Hello, World!"
  },
  "Population": {
    "DataType": "Number",
    "StringValue": "1250800"
  }
}
```
Salida:  

```
{
  "MD5OfMessageBody": "51b0a325...39163aa0",
  "MD5OfMessageAttributes": "00484c68...59e48f06",
  "MessageId": "da68f62c-0c07-4bee-bf5f-7e856EXAMPLE"
}
```
+  Para obtener más información sobre la API, consulte [SendMessage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/send-message.html)la *Referencia de AWS CLI comandos*. 

### `set-queue-attributes`
<a name="sqs_SetQueueAttributes_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `set-queue-attributes`.

**AWS CLI**  
**Fijación de los atributos de una cola**  
Este ejemplo establece la cola especificada en un retraso de entrega de 10 segundos, un tamaño máximo de mensaje de 128 KB (128 KB \$1 1024 bytes), un período de retención de mensajes de 3 días (3 días \$1 24 horas \$1 60 minutos \$1 60 segundos), un tiempo de espera de recepción de mensajes de 20 segundos y un tiempo de espera de visibilidad predeterminado de 60 segundos. En este ejemplo, también se asocia la cola de mensajes fallidos especificada a un recuento máximo de 1000 mensajes recibidos.  
Comando:  

```
aws sqs set-queue-attributes --queue-url https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyNewQueue --attributes file://set-queue-attributes.json
```
Archivo de entrada (set-queue-attributes.json):  

```
{
  "DelaySeconds": "10",
  "MaximumMessageSize": "131072",
  "MessageRetentionPeriod": "259200",
  "ReceiveMessageWaitTimeSeconds": "20",
  "RedrivePolicy": "{\"deadLetterTargetArn\":\"arn:aws:sqs:us-east-1:80398EXAMPLE:MyDeadLetterQueue\",\"maxReceiveCount\":\"1000\"}",
  "VisibilityTimeout": "60"
}
```
Salida:  

```
None.
```
+  Para obtener más información sobre la API, consulte [SetQueueAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/set-queue-attributes.html)la *Referencia de AWS CLI comandos*. 

### `start-message-move-task`
<a name="sqs_StartMessageMoveTask_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `start-message-move-task`.

**AWS CLI**  
*Ejemplo 1: \$1inicio de una tarea de traslado de mensajes\$1*  
En el siguiente ejemplo de `start-message-move-task`, se inicia una tarea de traslado de mensajes para redirigir los mensajes de la cola de mensajes fallidos especificada a la cola de origen.  

```
aws sqs start-message-move-task \
    --source-arn arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue
```
Salida:  

```
{
    "TaskHandle": "AQEB6nR4...HzlvZQ=="
}
```
Para obtener más información, consulte [Título del tema](https://link.to.the/topic/page) en la *Nombre de la guía*.  
*Ejemplo 2: \$1Inicio de una tarea de traslado de mensajes con una velocidad máxima\$1*  
En el siguiente ejemplo de `start-message-move-task`, se inicia una tarea de traslado de mensajes para redirigir los mensajes de la cola de mensajes fallidos especificada a la cola de destino designada a una velocidad máxima de 50 mensajes por segundo.  

```
aws sqs start-message-move-task \
    --source-arn arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue1 \
    --destination-arn arn:aws:sqs:us-west-2:80398EXAMPLE:MyQueue2 \
    --max-number-of-messages-per-second 50
```
Salida:  

```
{
    "TaskHandle": "AQEB6nR4...HzlvZQ=="
}
```
Para obtener más información, consulte [Amazon SQS API permissions: Actions and resource reference](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-api-permissions-reference.html) en la *Guía para desarrolladores*.  
+  Para obtener más información sobre la API, consulte [StartMessageMoveTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/start-message-move-task.html)la *Referencia de AWS CLI comandos*. 

### `tag-queue`
<a name="sqs_TagQueue_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `tag-queue`.

**AWS CLI**  
**Para añadir etiquetas de asignación de costos a una cola**  
En el siguiente ejemplo de `tag-queue`, se añade una etiqueta de asignación de costos a la cola de Amazon SQS especificada.  

```
aws sqs tag-queue \
    --queue-url https://sqs.us-west-2.amazonaws.com/123456789012/MyQueue \
    --tags Priority=Highest
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Adding Cost Allocation Tags](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html) en la *Guía para desarrolladores de Amazon Simple Queue Service*.  
+  Para obtener más información sobre la API, consulte [TagQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/tag-queue.html)la *Referencia de AWS CLI comandos*. 

### `untag-queue`
<a name="sqs_UntagQueue_cli_2_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `untag-queue`.

**AWS CLI**  
**Para eliminar etiquetas de asignación de costos de una cola**  
En el siguiente ejemplo de `untag-queue`, se añade una etiqueta de asignación de costos a la cola de Amazon SQS especificada.  

```
aws sqs untag-queue \
    --queue-url https://sqs.us-west-2.amazonaws.com/123456789012/MyQueue \
    --tag-keys "Priority"
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Adding Cost Allocation Tags](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html) en la *Guía para desarrolladores de Amazon Simple Queue Service*.  
+  Para obtener más información sobre la API, consulte [UntagQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/untag-queue.html)la *Referencia de AWS CLI comandos*. 