openstack.cloud.recordset – Управление наборами записей DNS OpenStack

Примечание

Этот плагин входит в коллекцию openstack.cloud (версия 1.2.1).

Для его установки используйте: ansible-galaxy collection install openstack.cloud.

Для использования в книге задач укажите: openstack.cloud.recordset.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управление наборами записей DNS OpenStack. Наборы записей можно создавать, удалять или обновлять. Обновляться могут только значения records, description и ttl.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

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, который может использоваться для проверки запросов 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 строка		Описание набора записей
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type
name строка / обязательно		Имя набора записей. Оно должно заканчиваться именем зоны DNS.
records список / элементы=строка		Список определений набора записей. Требуется при state=present.
recordset_type строка	Варианты: a aaaa mx cname txt ns srv ptr caa	Тип набора записей Требуется при state=present.
region_name строка		Имя региона.
state строка	Варианты: present ← absent	Ресурс должен быть присутствующим или отсутствующим.
timeout целое число	Значение по умолчанию: 180	Сколько времени Ansible должно ждать запрошенного ресурса.
ttl целое число		Значение TTL (Time To Live) в секундах
validate_certs булево	Варианты: no ← yes	Нужно ли проверять запросы API SSL. До Ansible 2.3 это значение по умолчанию было `yes`. псевдонимы: verify
wait булево	Варианты: no yes ←	Должен ли Ansible ждать завершения запрошенного ресурса.
zone строка / обязательно		Зона, управляющая набором записей

Примечания

Примечание

Можно использовать стандартные переменные окружения OpenStack, такие как OS_USERNAME, вместо явного указания значений.
Информация об авторизации управляется openstacksdk, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, а затем из явных параметров в книгах задач. Дополнительная информация доступна по адресу https://docs.openstack.org/openstacksdk/

Примеры

# Create a recordset named "www.example.net."
- openstack.cloud.recordset:
    cloud: mycloud
    state: present
    zone: example.net.
    name: www.example.net.
    recordset_type: "a"
    records: ['10.1.1.1']
    description: test recordset
    ttl: 3600

# Update the TTL on existing "www.example.net." recordset
- openstack.cloud.recordset:
    cloud: mycloud
    state: present
    zone: example.net.
    name: www.example.net.
    ttl: 7200

# Delete recordset named "www.example.net."
- openstack.cloud.recordset:
    cloud: mycloud
    state: absent
    zone: example.net.
    name: www.example.net.

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращается	Описание
recordset сложное		При успехе, когда state равен 'present'.	Словарь, описывающий набор записей.
	description строка	успех	Описание набора записей Пример: Тестовое описание
	id строка	успех	Уникальный идентификатор набора записей Пример: c1c530a3-3619-46f3-b0f6-236927b2618c
	name строка	успех	Имя набора записей Пример: www.example.net.
	records список / элементы=строка	успех	Записи набора записей Пример: ['10.0.0.1']
	ttl целое число	успех	Значение TTL (Time To Live) зоны Пример: 3600
	type строка	успех	Тип набора записей Пример: A
	zone_id строка	успех	Идентификатор зоны Пример: 9508e177-41d8-434e-962c-6fe6ca880af7

Авторы

OpenStack Ansible SIG

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/openstack/cloud/recordset_module.html