Spec-Zone.ru › Ansible

Модуль openstack.cloud.dns_zone_info — получение информации о DNS-зонах

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install openstack.cloud. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: openstack.cloud.dns_zone_info.

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

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

  • Получение информации о DNS-зонах. Вывод можно фильтровать.

Требования

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

  • python >= 3.6
  • openstacksdk >= 1.0.0

Параметры

Параметр

Комментарии

api_timeout

целое число

Как долго уровень сокетов должен ожидать перед истечением времени ожидания вызовов API. Если параметр не указан, библиотеке requests ничего не будет передано.

auth

словарь

Словарь с данными аутентификации, необходимыми стратегии плагина аутентификации облака. Для используемого по умолчанию плагина password здесь должны быть указаны auth_url, username, password, project_name и любые сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все данные, необходимые соответствующему плагину аутентификации. Этот параметр не требуется, если указано именованное облако или заданы переменные среды OpenStack OS_*.

auth_type

строка

Имя используемого плагина аутентификации. Если облако использует не парольную аутентификацию, здесь следует указать имя плагина и соответствующим образом обновить содержимое параметра auth.

ca_cert

псевдонимы: cacert

строка

Путь к пакету сертификатов CA, который можно использовать для проверки запросов SSL API.

client_cert

псевдонимы: cert

строка

Путь к сертификату клиента, используемому при обмене данными SSL.

client_key

псевдонимы: key

строка

Путь к ключу клиента, используемому при обмене данными SSL.

cloud

любой

Именованное облако или конфигурация облака, с которыми нужно работать. Если cloud — строка, она указывает на конфигурацию именованного облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или заданы переменные среды OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, аналогичную разделу в clouds.yaml.

description

строка

Описание зоны.

email

строка

Адрес электронной почты владельца зоны.

Применяется только к первичным зонам.

interface

псевдонимы: endpoint_type

строка

Тип URL конечной точки, получаемой из каталога служб.

Варианты:

  • "admin"
  • "internal"
  • "public" ← (по умолчанию)

name

строка

Имя зоны.

region_name

строка

Имя региона.

sdk_log_level

строка

Уровень журналирования OpenStackSDK.

Варианты:

  • "INFO" ← (по умолчанию)
  • "DEBUG"

sdk_log_path

строка

Путь к файлу журнала OpenStackSDK. Если значение пустое, журнал не записывается.

timeout

целое число

Как долго Ansible должен ожидать запрошенный ресурс.

По умолчанию: 180

ttl

целое число

Значение TTL (время жизни) в секундах.

type

строка

Тип зоны.

Варианты:

  • "primary"
  • "secondary"

validate_certs

псевдонимы: verify

логическое значение

Следует ли проверять запросы SSL API.

До Ansible 2.3 значение по умолчанию было true.

Варианты:

  • false
  • true

wait

логическое значение

Должен ли Ansible ждать завершения подготовки запрошенного ресурса.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Fetch all DNS zones
  openstack.cloud.dns_zone_info:
    cloud: devstack

- name: Fetch DNS zones by name
  openstack.cloud.dns_zone_info:
    cloud: devstack
    name: ansible.test.zone.

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

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

Ключ

Описание

zones

список / элементы=словарь

Словарь с описанием DNS-зон.

Возвращается: при успешном выполнении, если state имеет значение present.

action

строка

Текущее действие, выполняемое над ресурсом.

Возвращается: при успешном выполнении

Пример: "CREATE"

attributes

словарь

Пары ключ-значение с информацией об этой зоне и пуле, в который пользователь хочет поместить зону. Планировщик может использовать эту информацию для размещения зон в соответствующем пуле.

Возвращается: при успешном выполнении

Пример: {"ha": "true", "tier": "gold"}

created_at

строка

Дата и время создания ресурса.

Возвращается: при успешном выполнении

Пример: "2014-07-07T18:25:31.275934"

description

строка

Описание этой зоны.

Возвращается: при успешном выполнении

Пример: "This is an example zone."

email

строка

Адрес электронной почты зоны. Используется в записях SOA зоны.

Возвращается: при успешном выполнении

Пример: "test@example.org"

id

целое число

Идентификатор ресурса.

Возвращается: при успешном выполнении

Пример: "a86dba58-0043-4cc6-a1bb-69d5e86f3ca3"

links

словарь

Ссылки на ресурс и другие связанные ресурсы. Если ответ разбит на страницы, будет включена ссылка next, по которой следует перейти для получения всех результатов.

Возвращается: при успешном выполнении

Пример: {"self": "https://127.0.0.1:9001/v2/zones/a86dba...d5e86f3ca3"}

masters

список / элементы=строка

Серверы, с которых получают DNS-информацию в режиме ведомого сервера. Обязательный параметр для вторичных зон.

Возвращается: при успешном выполнении

Пример: ["[]"]

name

строка

DNS-имя зоны.

Возвращается: при успешном выполнении

Пример: "test.test."

pool_id

строка

Идентификатор пула, в котором размещена эта зона.

Возвращается: при успешном выполнении

Пример: "a86dba58-0043-4cc6-a1bb-69d5e86f3ca3"

project_id

строка

Идентификатор проекта, которому принадлежит ресурс.

Возвращается: при успешном выполнении

Пример: "4335d1f0-f793-11e2-b778-0800200c9a66"

serial

целое число

Текущий серийный номер зоны.

Возвращается: при успешном выполнении

Пример: 1404757531

status

строка

Состояние ресурса.

Возвращается: при успешном выполнении

Пример: "ACTIVE"

ttl

целое число

TTL (время жизни) зоны.

Возвращается: при успешном выполнении

Пример: 7200

type

строка

Тип зоны. Зона PRIMARY управляется Designate, а зоны SECONDARY получают данные с другого DNS-сервера. По умолчанию используется PRIMARY.

Возвращается: при успешном выполнении

Пример: "PRIMARY"

updated_at

строка

Дата и время последнего обновления ресурса.

Возвращается: при успешном выполнении

Пример: "2014-07-07T18:25:31.275934"

Авторы

  • OpenStack Ansible SIG

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API