route53_zone - добавление или удаление зон Route53

Новая версия с 2.0.

Обзор
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
- Автор

Обзор

Создаёт и удаляет частные и публичные зоны Route53.

Требования

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

python >= 2.6
boto

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	По умолчанию: None	Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY.
aws_secret_key	По умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY.
comment	По умолчанию:	Комментарий, связанный с зоной.
ec2_url	По умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковое имеется.
hosted_zone_id (добавлено в 2.4)	По умолчанию: None	Уникальный идентификатор зоны, которую требуется удалить, или «all», если существует множество зон с одинаковым именем домена. Требуется, если несколько зон идентифицируются вышеуказанными параметрами.
profile (добавлено в 1.6)	По умолчанию: None	Использует профиль boto. Работает только с boto >= 2.24.0.
region		Регион AWS для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если таковое имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
security_token (добавлено в 1.6)	По умолчанию: None	Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN.
state	Варианты: present ← absent	Указывает, должна ли зона существовать или нет.
validate_certs (добавлено в 1.5)	Варианты: no yes ←	При значении «no» сертификаты SSL не будут проверяться для версий boto >= 2.6.0.
vpc_id	По умолчанию: None	ID VPC, частью которого должна быть зона (если это частная зона).
vpc_region	По умолчанию: None	Регион VPC, частью которого должна быть зона (если это частная зона).
zone требуется		Запись DNS зоны (например: foo.com.).

Примечания

Примечание

Если параметры не заданы в модуле, могут быть использованы следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, 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.
Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не указаны. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используются для указания региона AWS, когда это необходимо, но его также можно настроить в конфигурационном файле boto

Примеры

- name: create a public zone
  route53_zone:
    zone: example.com
    comment: this is an example

- name: delete a public zone
  route53_zone:
    zone: example.com
    state: absent

- name: create a private zone
  route53_zone:
    zone: devel.example.com
    vpc_id: '{{ myvpc_id }}'
    vpc_region: us-west-2
    comment: developer domain

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

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

Ключ	Возвращаемое значение	Описание
comment строка	при существовании зоны	необязательный комментарий к зоне Пример: Частная зона
name строка	при существовании зоны	имя зоны Пример: private.local.
private_zone логическое значение	при существовании зоны	является ли зона частной или публичной Пример: True
vpc_id строка	для частной зоны	идентификатор VPC, присоединенный к частной зоне Пример: vpc-1d36c84f
vpc_region строка	для частной зоны	регион VPC, присоединенный к частной зоне Пример: eu-west-1
zone_id строка	при существовании зоны	идентификатор зоны Пример: Z6JQG9820BEFMW

Статус

Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют отсутствие обратной несовместимости в изменениях интерфейса.

Автор

Christopher Troup (@minichate)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/route53_zone_module.html