os_zone – Управление зонами DNS OpenStack
Краткое описание
- Управление зонами DNS OpenStack. Зоны могут быть созданы, удалены или обновлены. Только значения email, description, ttl и masters могут быть обновлены.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- openstacksdk
- openstacksdk >= 0.12.0
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout целое число | Сколько времени должно ждать уровень сокета перед истечением времени ожидания для API-вызовов. Если этот параметр опущен, он не будет передан библиотеке requests. | |
| auth словарь | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password он должен содержать auth_url, username, password, project_name и любую информацию о доменах (например, os_user_domain_name или os_project_domain_name), если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать все необходимые параметры подключаемого модуля авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | |
| auth_type строка | Имя подключаемого модуля авторизации, который следует использовать. Если облако использует что-то другое, кроме парольной аутентификации, имя подключаемого модуля следует указать здесь, и содержимое параметра auth следует соответствующим образом обновить. | |
| availability_zone - | Игнорируется. Присутствует для обратной совместимости | |
| ca_cert строка | Путь к пакету сертификатов CA, который можно использовать для проверки SSL-API-запросов. псевдонимы: 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 булево |
| Требовать или нет проверку SSL-API-запросов. До 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"
- os_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
- os_zone:
cloud: mycloud
state: present
name: example.net.
ttl: 7200
# Delete zone named "example.net."
- os_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 | ||
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Ricardo Carrillo Cruz (@rcarrillocruz)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/os_zone_module.html
