os_recordset – Управление наборами записей OpenStack DNS

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

Краткое описание

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

Требования

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

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 -		Описание набора записей
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type
name - / обязательно		Имя набора записей
records - / обязательно		Список определений набора записей
recordset_type - / обязательно		Тип набора записей
region_name строка		Имя региона.
state -	Варианты: present ← absent	Должен ли ресурс быть присутствующим или отсутствующим.
timeout целое число	По умолчанию: 180	Сколько времени Ansible должен ждать запрошенного ресурса.
ttl -		Значение TTL (Время жизни) в секундах
validate_certs булево	Варианты: no ← yes	Проверяться ли SSL API-запросы. Перед 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, затем из стандартных переменных среды, и, наконец, из явных параметров в playbook. Более подробную информацию можно найти по адресу https://docs.openstack.org/openstacksdk/

Примеры

# 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 recordset named "www.example.net."
- os_recordset:
    cloud: mycloud
    state: absent
    zone: example.net.
    name: www

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

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

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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [предварительный просмотр]
Этот модуль поддерживается сообществом 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_recordset_module.html