os_recordset - Управление наборами записей DNS OpenStack
Введено в версии 2.2.
- Описание
- Требования (для хоста, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Управление наборами записей DNS OpenStack. Наборы записей можно создавать, удалять или обновлять. Только значения records, description и ttl могут быть обновлены.
Требования (для хоста, на котором выполняется модуль)
- python >= 2.6
- python >= 2.7
- shade
Параметры
| параметр | обязательный | значение по умолчанию | допустимые значения | комментарии |
|---|---|---|---|---|
| api_timeout | нет | None | Сколько времени должно ждать сокетное соединение, прежде чем произойдёт таймаут для вызовов API. Если этот параметр опущен, в библиотеку запросов ничего не будет передано. | |
| auth | нет | Словарь, содержащий информацию об авторизации, необходимую для стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password это будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать параметры, необходимые для данного подключаемого модуля. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | ||
| auth_type | нет | password | Имя подключаемого модуля авторизации для использования. Если облако использует что-то отличное от парольной аутентификации, имя подключаемого модуля должно быть указано здесь, а содержимое параметра auth должно быть обновлено соответственно. | |
| availability_zone | нет | Игнорируется. Присутствует для обратной совместимости. | ||
| cacert | нет | None | Путь к пакету сертификатов CA, который может быть использован при проверке запросов API SSL. | |
| cert | нет | None | Путь к клиенту сертификату, который будет использоваться в рамках SSL транзакции. | |
| cloud | нет | Имя облака для работы. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или если присутствуют переменные окружения OpenStack OS_*. | ||
| description | нет | None | Описание набора записей | |
| endpoint_type | нет | public |
| Тип URL конечной точки для получения из каталога служб. |
| key | нет | None | Путь к клиенту ключу, который будет использован в рамках SSL транзакции. | |
| name | да | Имя набора записей | ||
| records | да | Список определений набора записей | ||
| recordset_type | да | Тип набора записей | ||
| region_name | нет | Имя региона. | ||
| state | нет | present |
| Должен ли ресурс присутствовать или отсутствовать. |
| timeout | нет | 180 | Сколько времени Ansible должно ждать запрашиваемого ресурса. | |
| ttl | нет | None | Значение TTL (Time To Live) в секундах | |
| validate_certs | нет | Нужно ли проверять запросы API SSL. До версии 2.3 по умолчанию было True. псевдонимы: verify | ||
| wait | нет | yes |
| Должен ли Ansible ждать, пока запрашиваемый ресурс не будет завершён. |
| zone | да | Зона, управляющая набором записей |
Примеры
# 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 | Словарь, описывающий набор записей. | При успехе, когда I(state) — 'present'. | сложный | |||||||||||||||||||||||||||||||||||||||||
| содержит: |
| |||||||||||||||||||||||||||||||||||||||||||
Примечания
Примечание
- Стандартные переменные окружения 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
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы захотите, пожалуйста, прочитайте Информацию о сообществе и вклад, Тестирование 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/os_recordset_module.html
