os_recordset - Управление наборами записей OpenStack DNS
Новая версия 2.2.
Обзор
- Управление наборами записей DNS OpenStack. Наборы записей можно создавать, удалять или обновлять. Можно обновлять только значения records, description и ttl.
Требования
Ниже перечислены требования к хосту, на котором выполняется данный модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Сколько времени должен ждать уровень сокета перед таймаутом для вызовов API. Если этот параметр опущен, он не будет передан в библиотеку requests. | |
| auth | Словарь, содержащий информацию об аутентификации, необходимую для стратегии подключаемого модуля аутентификации облака. Для стандартного подключаемого модуля password он содержит auth_url, username, password, project_name и любую информацию о доменных именах, если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры. Этот параметр не требуется, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | |
| auth_type | Имя используемого подключаемого модуля аутентификации. Если облако использует что-то кроме аутентификации по паролю, здесь должно быть указано имя подключаемого модуля, и содержимое параметра auth должно быть соответственно обновлено. | |
| availability_zone | Игнорируется. Присутствует для обратной совместимости | |
| cacert | Путь к пакету сертификатов CA, который может использоваться для проверки запросов SSL к API. | |
| cert | Путь к клиенту сертификата для использования в ходе SSL-транзакции. | |
| cloud | Имя облака или конфигурация облака для работы. Если cloud является строкой, она ссылается на конфигурацию облака с именем, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан параметр auth или присутствуют переменные среды OpenStack OS_*. Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| description | Описание набора записей | |
| interface (добавлено в 2.3) |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| key | Путь к ключу клиента для использования в ходе SSL-транзакции. | |
| name обязательно | Имя набора записей | |
| records обязательно | Список определений набора записей | |
| recordset_type обязательно | Тип набора записей | |
| region_name | Имя региона. | |
| state |
| Должен ли ресурс присутствовать или отсутствовать. |
| timeout | По умолчанию: 180 | Сколько времени Ansible должен ждать запрошенного ресурса. |
| ttl | Значение TTL (Time To Live) в секундах | |
| verify bool |
| Нужно ли проверять запросы SSL API. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait bool |
| Должен ли Ansible ждать завершения запрошенного ресурса. |
| zone обязательно | Зона, управляющая набором записей |
Примечания
Примечание
- Могут использоваться стандартные переменные среды OpenStack, такие как
OS_USERNAME, вместо явного указания значений. - Информация об аутентификации управляется os-client-config, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и наконец, явными параметрами в задачах. Более подробная информация доступна по адресу http://docs.openstack.org/developer/os-client-config
Примеры
# Create a recordset named "www.example.net."
- os_recordset:
cloud: mycloud
state: present
zone: example.net.
name: www
recordset_type: primary
records: ['10.1.1.1']
description: test recordset
ttl: 3600
# Update the TTL on existing "www.example.net." recordset
- os_recordset:
cloud: mycloud
state: present
zone: example.net.
name: www
ttl: 7200
# Delete recorset named "www.example.net."
- os_recordset:
cloud: mycloud
state: absent
zone: example.net.
name: www
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| recordset сложный | При успехе, когда state равен 'present'. | Словарь, описывающий набор записей. | |
| id строка | Уникальный идентификатор набора записей Пример: c1c530a3-3619-46f3-b0f6-236927b2618c | ||
| name строка | Имя набора записей Пример: www.example.net. | ||
| zone_id строка | Идентификатор зоны Пример: 9508e177-41d8-434e-962c-6fe6ca880af7 | ||
| type строка | Тип набора записей Пример: A | ||
| description строка | Описание набора записей Пример: Тестовое описание | ||
| ttl целое число | Значение TTL зоны Пример: 3600 | ||
| records список | Записи набора записей Пример: ['10.0.0.1'] | ||
Статус
Этот модуль помечен как предварительная версия, что означает, что его интерфейс не гарантированно будет обратной совместимым.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/os_recordset_module.html
