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

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

Описание
Требования (к хосту, выполняющему модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Описание

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

Требования (к хосту, выполняющему модуль)

python >= 2.6
boto

Параметры

параметр	обязательный	по умолчанию	значения	комментарии
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	нет			Комментарий, связанный с зоной
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	нет	True	present absent	Указывает, должна ли зона существовать или нет
validate_certs (добавлено в 1.5)	нет	да	да нет	Если установлено значение «нет», сертификаты SSL для boto версий >= 2.6.0 не будут валидироваться.
vpc_id	нет			ID VPC, к которому должна принадлежать зона (если это будет частная зона)
vpc_region	нет			Регион VPC, к которому должна принадлежать зона (если это будет частная зона)
zone	да			Запись DNS-зоны (например: foo.com.)

Примеры

# create a public zone
- route53_zone:
    zone: example.com
    state: present
    comment: this is an example

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

- name: private zone for devel
  route53_zone:
    zone: devel.example.com
    state: present
    vpc_id: '{{ myvpc_id }}'
    comment: developer domain

# more complex example
- name: register output after creating zone in parameterized region
  route53_zone:
    vpc_id: '{{ vpc.vpc_id }}'
    vpc_region: '{{ ec2_region }}'
    zone: '{{ vpc_dns_zone }}'
    state: present
  register: zone_out

- debug:
    var: zone_out

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

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

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

Примечания

Примечание

Если параметры не установлены внутри модуля, следующие переменные окружения могут использоваться в порядке убывания приоритета 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

Статус

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

Для получения помощи в разработке модулей ознакомьтесь со статьей Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

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