1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139
|
.. Copyright 2010-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License (the "License"). You may not use this file except in compliance with the
License. A copy of the License is located at http://creativecommons.org/licenses/by-nc-sa/4.0/.
This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions and
limitations under the License.
.. _aws-boto3-sqs-using-queues:
##########################
Using queues in Amazon SQS
##########################
This Python example shows you how to:
* Get a list of all of your message queues
* Obtain the URL for a particular queue
* Create and delete queues
The scenario
============
In this example, Python code is used to work with queues. The code uses the AWS SDK for Python to use
queues using these methods of the AWS.SQS client class:
* `list_queues <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.list_queues>`_.
* `create_queue <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.create_queue>`_.
* `get_queue_url <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.get_queue_url>`_.
* `delete_queue <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.delete_queue>`_.
For more information about Amazon SQS messages, see
`How Queues Work <http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-how-it-works.html>`_
in the *Amazon Simple Queue Service Developer Guide*.
List your queues
================
The example below shows how to:
* List queues using
`list_queues <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.list_queues>`_.
Example
-------
.. code-block:: python
import boto3
# Create SQS client
sqs = boto3.client('sqs')
# List SQS queues
response = sqs.list_queues()
print(response['QueueUrls'])
.. _aws-boto3-sqs-create-queue:
Create a queue
==============
The example below shows how to:
* Create a queue using
`create_queue <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.create_queue>`_.
Example
-------
.. code-block:: python
import boto3
# Create SQS client
sqs = boto3.client('sqs')
# Create a SQS queue
response = sqs.create_queue(
QueueName='SQS_QUEUE_NAME',
Attributes={
'DelaySeconds': '60',
'MessageRetentionPeriod': '86400'
}
)
print(response['QueueUrl'])
Get the URL for a queue
=======================
The example below shows how to:
* Get the URL for a queue using
`get_queue_url <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.get_queue_url>`_.
Example
-------
.. code-block:: python
import boto3
# Create SQS client
sqs = boto3.client('sqs')
# Get URL for SQS queue
response = sqs.get_queue_url(QueueName='SQS_QUEUE_NAME')
print(response['QueueUrl'])
Delete a queue
==============
The example below shows how to:
* Delete a queue using
`delete_queue <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs.html#SQS.Client.delete_queue>`_.
Example
-------
.. code-block:: python
import boto3
# Create SQS client
sqs = boto3.client('sqs')
# Delete SQS queue
sqs.delete_queue(QueueUrl='SQS_QUEUE_URL')
|