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

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

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

Обзор

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

Требования

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

boto
boto3
python >= 2.6

Параметры

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

- name: create a public zone associated with a specific reusable delegation set
  route53_zone:
    zone: example.com
    comment: reusable delegation set example
    delegation_set_id: A1BCDEF2GHIJKL

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

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

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

Статус

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

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

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.6/modules/route53_zone_module.html