openstack.cloud.dns_zone – Управление зонами DNS OpenStack
Примечание
Этот плагин входит в состав коллекции openstack.cloud (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install openstack.cloud
Для использования в книге задач укажите: openstack.cloud.dns_zone
Описание
- Управление зонами DNS OpenStack. Зоны могут быть созданы, удалены или обновлены. Только значения email, description, ttl и masters могут быть обновлены.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется данный модуль.
- openstacksdk
- openstacksdk >= 0.12.0
- python >= 3.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout целое число | Сколько времени следует ожидать слою сокетов перед истечением времени ожидания для вызовов API. Если этот параметр опущен, он не будет передан в библиотеку запросов. | |
| auth словарь | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина по умолчанию password он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать любые параметры, которые требуются плагину авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | |
| auth_type строка | Имя плагина авторизации для использования. Если облако использует что-то кроме аутентификации по паролю, имя плагина должно быть указано здесь, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone строка | Игнорируется. Присутствует для обратной совместимости | |
| ca_cert строка | Путь к пакету сертификатов CA, который может использоваться для проверки запросов API SSL. псевдонимы: cacert | |
| client_cert строка | Путь к клиенту сертификат для использования в рамках транзакции SSL. псевдонимы: cert | |
| client_key строка | Путь к ключу клиента для использования в рамках транзакции SSL. псевдонимы: key | |
| cloud сырой | Именованное облако или конфигурация облака для работы с ним. Если cloud является строкой, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные среды OpenStack OS_*. Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| description строка | Описание зоны | |
| email строка | Электронная почта владельца зоны (применимо только если zone_type — primary) | |
| interface строка |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type |
| masters список / элементы=строка | Серверы имен-мастера (применимо только если zone_type — secondary) | |
| name строка / обязательный | Имя зоны | |
| region_name строка | Имя региона. | |
| state строка |
| Должна ли ресурс быть present или absent. |
| timeout целое число | По умолчанию: 180 | Сколько времени Ansible должно ждать запрашиваемого ресурса. |
| ttl целое число | Значение TTL (Time To Live) в секундах | |
| validate_certs булево |
| Необходимо ли проверять запросы API SSL. Перед Ansible 2.3 значение по умолчанию было yes.псевдонимы: verify |
| wait булево |
| Должен ли Ansible ждать, пока запрашиваемый ресурс будет завершен. |
| zone_type строка |
| Тип зоны |
Примечания
Примечание
- Можно использовать стандартные переменные среды OpenStack, такие как
OS_USERNAME, вместо указания явных значений. - Информация об авторизации управляется openstacksdk, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в задачах. Более подробную информацию можно найти по адресу https://docs.openstack.org/openstacksdk/
Примеры
# Create a zone named "example.net"
- openstack.cloud.dns_zone:
cloud: mycloud
state: present
name: example.net.
zone_type: primary
email: test@example.net
description: Test zone
ttl: 3600
# Update the TTL on existing "example.net." zone
- openstack.cloud.dns_zone:
cloud: mycloud
state: present
name: example.net.
ttl: 7200
# Delete zone named "example.net."
- openstack.cloud.dns_zone:
cloud: mycloud
state: absent
name: example.net.
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| zone сложный | При успехе, когда state равен 'present'. | Словарь, описывающий зону. | |
| description строка | успех | Описание зоны Пример: Тестовое описание | |
| email строка | успех | Электронная почта владельца зоны Пример: test@example.net | |
| id строка | успех | Уникальный идентификатор зоны Пример: c1c530a3-3619-46f3-b0f6-236927b2618c | |
| masters список / элементы=строка | успех | Серверы имен-мастера зоны | |
| name строка | успех | Имя зоны Пример: example.net. | |
| ttl целое число | успех | Значение TTL зоны Пример: 3600 | |
| type строка | успех | Тип зоны Пример: PRIMARY | |
Авторы
- OpenStack Ansible SIG
© 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/openstack/cloud/dns_zone_module.html
