community.aws.sqs_queue – Создаёт или удаляет очереди AWS SQS

Примечание

Этот плагин входит в коллекцию community.aws (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.aws.

Чтобы использовать его в плейбуке, укажите: community.aws.sqs_queue.

Новый в версии 1.0.0: of community.aws

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создать или удалить очереди AWS SQS.
Обновить атрибуты существующих очередей.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

boto
boto3
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key строка		Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Если задан параметр profile, этот параметр игнорируется. Передача параметров aws_access_key и profile одновременно устарела и будет исключена после 2022-06-01. псевдонимы: ec2_access_key, access_key
aws_ca_bundle путь		Расположение файла с набором сертификатов CA для проверки SSL-сертификатов. Используется только для модулей, основанных на boto3. Примечание: набор сертификатов CA считывается со стороны модуля и может потребоваться явное копирование с контроллера, если модуль не выполняется локально.
aws_config словарь		Словарь для изменения конфигурации botocore. Параметры можно найти по адресу https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config. Для модулей boto используется только ключ 'user_agent'. Более подробную информацию о конфигурации boto см. по адресу http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto.
aws_secret_key строка		Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Если задан параметр profile, этот параметр игнорируется. Передача параметров aws_secret_key и profile одновременно устарела и будет исключена после 2022-06-01. псевдонимы: ec2_secret_key, secret_key
content_based_deduplication булево	Варианты: no yes	Включает дедупликацию на основе содержимого. Используется только для FIFOs. Значение по умолчанию `false`.
debug_botocore_endpoint_logs булево	Варианты: нет ← да	Использует логирование botocore.endpoint для анализа уникальных (а не всех) API-вызовов «ресурс:действие», производимых во время задачи, выводя набор в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода полного списка, созданного во время выполнения playbook. Также может быть использована переменная окружения ANSIBLE_DEBUG_BOTOCORE_LOGS.
delay_seconds целое число		Задержка доставки в секундах. псевдонимы: delivery_delay
ec2_url строка		URL для подключения к EC2 или вашей облачной системе Eucalyptus (по умолчанию модуль использует адреса EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если не используется регион. Если не задан, используется значение переменной окружения EC2_URL, если она есть. псевдонимы: aws_endpoint_url, endpoint_url
kms_data_key_reuse_period_seconds целое число		Срок в секундах, в течение которого Amazon SQS может повторно использовать ключ данных для шифрования или дешифрования сообщений перед повторным обращением к AWS KMS. псевдонимы: kms_data_key_reuse_period
kms_master_key_id строка		Идентификатор управляемого AWS ключа мастер-ключа (CMK) для Amazon SQS или пользовательского CMK.
maximum_message_size целое число		Максимальный размер сообщения в байтах.
message_retention_period целое число		Срок хранения сообщений в секундах.
name строка / обязательно		Имя очереди.
policy словарь		Политика в формате JSON, которая должна быть прикреплена к очереди.
profile строка		Использует профиль boto. Работает только с boto >= 2.24.0. Использование profile переопределяет aws_access_key, aws_secret_key и security_token. Поддержка одновременной передачи этих параметров с profile устарела. aws_access_key, aws_secret_key и security_token станут взаимоисключающими с profile после 2022-06-01. псевдонимы: aws_profile
purge_tags булево	Варианты: нет ← да	Удаление тегов, не перечисленных в tags.
queue_type строка	Варианты: стандартный ← fifo	Стандартная или FIFO-очередь. Параметр queue_type может быть установлен только при создании очереди и в противном случае будет проигнорирован.
receive_message_wait_time_seconds целое число		Время ожидания получения сообщения в секундах. псевдонимы: receive_message_wait_time
redrive_policy словарь		Словарь JSON с параметрами redrive_policy (см. пример).
region строка		AWS-регион. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если она есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
security_token строка		Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Если задан параметр profile, этот параметр игнорируется. Передача параметров security_token и profile одновременно устарела и будет исключена после 2022-06-01. псевдонимы: aws_security_token, access_token
state строка	Варианты: present ← absent	Создание или удаление очереди.
tags словарь		Словарь тегов для применения к очереди (требуется botocore 1.5.40 или выше). Для удаления всех тегов установите tags={} и purge_tags=true.
validate_certs булево	Варианты: нет да ←	При значении «нет» SSL-сертификаты не будут проверены для версий boto >= 2.6.0.
visibility_timeout целое число		Значение тайм-аута видимости по умолчанию в секундах. псевдонимы: default_visibility_timeout

Примечания

Примечание

Если параметры не установлены в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета AWS_URL или EC2_URL, AWS_PROFILE или AWS_DEFAULT_PROFILE, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION, AWS_CA_BUNDLE
Ansible использует файл конфигурации boto (обычно ~/.boto), если данные о доступе не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используются для указания AWS-региона, когда это необходимо, но это также можно настроить в файле конфигурации boto

Примеры

- name: Create SQS queue with redrive policy
  community.aws.sqs_queue:
    name: my-queue
    region: ap-southeast-2
    default_visibility_timeout: 120
    message_retention_period: 86400
    maximum_message_size: 1024
    delivery_delay: 30
    receive_message_wait_time: 20
    policy: "{{ json_dict }}"
    redrive_policy:
      maxReceiveCount: 5
      deadLetterTargetArn: arn:aws:sqs:eu-west-1:123456789012:my-dead-queue

- name: Drop redrive policy
  community.aws.sqs_queue:
    name: my-queue
    region: ap-southeast-2
    redrive_policy: {}

- name: Create FIFO queue
  community.aws.sqs_queue:
    name: fifo-queue
    region: ap-southeast-2
    queue_type: fifo
    content_based_deduplication: yes

- name: Tag queue
  community.aws.sqs_queue:
    name: fifo-queue
    region: ap-southeast-2
    tags:
      example: SomeValue

- name: Configure Encryption, automatically uses a new data key every hour
  community.aws.sqs_queue:
    name: fifo-queue
    region: ap-southeast-2
    kms_master_key_id: alias/MyQueueKey
    kms_data_key_reuse_period_seconds: 3600

- name: Delete SQS queue
  community.aws.sqs_queue:
    name: my-queue
    region: ap-southeast-2
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
content_based_deduplication boolean	всегда	Включает дублирование по содержимому. Используется только для FIFOs. Пример: True
delay_seconds integer	всегда	Задержка доставки в секундах.
kms_data_key_reuse_period_seconds integer	всегда	Длительность, в секундах, в течение которой Amazon SQS может повторно использовать ключ данных для шифрования или расшифровки сообщений перед обращением к AWS KMS снова. Пример: 300
kms_master_key_id string	всегда	Идентификатор управляемого AWS ключа шифрования (CMK) для Amazon SQS или пользовательского CMK. Пример: alias/MyAlias
maximum_message_size integer	всегда	Максимальный размер сообщения в байтах. Пример: 262144
message_retention_period integer	всегда	Срок хранения сообщений в секундах. Пример: 345600
name string	всегда	Имя очереди SQS Пример: queuename-987d2de0
queue_arn string	при успехе	Идентификатор ресурса Amazon (ARN) очереди. Пример: arn:aws:sqs:us-east-1:199999999999:queuename-987d2de0
queue_url string	при успехе	URL для доступа к очереди Пример: https://queue.amazonaws.com/123456789012/MyQueue
receive_message_wait_time_seconds integer	всегда	Время ожидания получения сообщения в секундах.
region string	всегда	Регион, в котором была создана очередь. Пример: us-east-1
tags dictionary	всегда	Список тегов очереди Пример: {"Env": "prod"}
visibility_timeout integer	всегда	Стандартный таймаут видимости в секундах. Пример: 30

Авторы

Alan Loi (@loia)
Fernando Jose Pando (@nand0p)
Nadir Lloret (@nadirollo)
Dennis Podkovyrin (@sbj-ss)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/aws/sqs_queue_module.html