os_recordset - Управление наборами записей DNS OpenStack
Новая версия 2.2.
Обзор
- Управление наборами записей DNS OpenStack. Наборы записей можно создавать, удалять или обновлять. Можно обновлять только значения записей, описания и ttl.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- python >= 2.7
- shade
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Сколько времени должна ожидать сокетная часть перед истечением времени ожидания для вызовов API. Если это опущено, ничего не будет передано в библиотеку запросов. | |
| auth | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password в нём будут содержаться auth_url, username, password, project_name и любая информация о домене, если облако её поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры подключаемого модуля авторизации. Этот параметр не требуется, если предоставлен указанный облачный сервер или присутствуют переменные среды OpenStack OS_*. | |
| auth_type | Название подключаемого модуля авторизации для использования. Если облако использует что-либо кроме парольной аутентификации, здесь следует указать имя подключаемого модуля, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | Игнорируется. Присутствует для обратной совместимости | |
| cacert | Путь к пакету сертификатов CA, который может использоваться в рамках проверки запросов API SSL. | |
| cert | Путь к клиенту сертификат для использования в рамках транзакции SSL. | |
| cloud | Указанный облачный сервер или конфигурация облака для работы с ним. Если cloud — строка, она ссылается на конфигурацию указанного облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен auth или присутствуют переменные среды OpenStack OS_* . Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| description | По умолчанию: None | Описание набора записей |
| interface (добавлен в 2.3) |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type |
| key | Путь к клиенту ключ для использования в рамках транзакции SSL. | |
| name требуется | Название набора записей | |
| records требуется | Список определений наборов записей | |
| recordset_type требуется | Тип набора записей | |
| region_name | Имя региона. | |
| state |
| Ресурс должен быть присутствующим или отсутствующим. |
| timeout | По умолчанию: 180 | Сколько времени Ansible должен ждать запрошенного ресурса. |
| ttl | По умолчанию: None | Значение TTL (Time To Live) в секундах |
| verify |
| Должны ли проверяться запросы API SSL. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait |
| Должен ли 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'. | Словарь, описывающий набор записей. | |
| records список | Записи набора записей Пример: ['10.0.0.1'] | ||
| zone_id строка | Идентификатор зоны Пример: 9508e177-41d8-434e-962c-6fe6ca880af7 | ||
| description строка | Описание набора записей Пример: Тестовое описание | ||
| ttl целое число | Значение TTL зоны Пример: 3600 | ||
| type строка | Тип набора записей Пример: A | ||
| id строка | Уникальный идентификатор набора записей Пример: c1c530a3-3619-46f3-b0f6-236927b2618c | ||
| name строка | Имя набора записей Пример: www.example.net. | ||
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- 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.5/modules/os_recordset_module.html
