os_keystone_domain_facts - Получение фактов о доменах OpenStack
Новая версия 2.1.
Обзор
- Получение фактов о одном или нескольких доменах OpenStack
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- openstacksdk
- python >= 2.7
- sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Сколько времени (в секундах) должна ждать система сокетов, прежде чем произойдёт таймаут при API-вызовах. Если этот параметр опущен, к библиотеке запросов ничего не будет передано. | |
| auth | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password, он будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других подключаемых модулей, этот параметр должен содержать необходимые параметры подключаемого модуля авторизации. Этот параметр не нужен, если предоставлен именованное облако или присутствуют переменные окружения OpenStack OS_*. | |
| auth_type | Имя подключаемого модуля авторизации для использования. Если облако использует что-то отличное от парольной аутентификации, то имя подключаемого модуля следует указать здесь, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | Игнорируется. Присутствует для обратной совместимости. | |
| cacert | Путь к пакету сертификатов CA, который может быть использован для проверки SSL API-запросов. | |
| cert | Путь к клиенту сертификат для использования в SSL-транзакции. | |
| cloud | Именованное облако или конфигурация облака для работы с ним. Если cloud является строкой, то она ссылается на именованную конфигурацию облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен параметр auth или присутствуют переменные окружения OpenStack OS_*. Если cloud является словарем, то он содержит полную конфигурацию облака, как в секции clouds.yaml. | |
| filters | Словарь метаданных для дальнейшего фильтрации. Элементы этого словаря могут быть дополнительными словарями. | |
| interface (добавлено в 2.3) |
| Тип URL конечной точки, который нужно извлечь из каталога служб. псевдонимы: endpoint_type |
| key | Путь к клиенту ключ для использования в SSL-транзакции. | |
| name | Имя или идентификатор домена | |
| region_name | Имя региона. | |
| timeout | По умолчанию: 180 | Сколько времени ожидает Ansible для запрашиваемого ресурса. |
| verify bool |
| Требуется ли проверка SSL API-запросов. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait bool |
| Должен ли Ansible ждать завершения запрашиваемого ресурса? |
Примечания
Примечание
- Можно использовать стандартные переменные окружения 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
Примеры
# Gather facts about previously created domain
- os_keystone_domain_facts:
cloud: awesomecloud
- debug:
var: openstack_domains
# Gather facts about a previously created domain by name
- os_keystone_domain_facts:
cloud: awesomecloud
name: demodomain
- debug:
var: openstack_domains
# Gather facts about a previously created domain with filter
- os_keystone_domain_facts:
cloud: awesomecloud
name: demodomain
filters:
enabled: False
- debug:
var: openstack_domains
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание | |
|---|---|---|---|
| openstack_domains сложное | всегда, но может быть null | Содержит все факты OpenStack о доменах | |
| id строка | успех | Уникальный UUID. | |
| name строка | успех | Имя, присвоенное домену. | |
| description строка | успех | Описание домена. | |
| enabled bool | успех | Флаг, указывающий, включён ли домен. | |
Статус
Этот модуль помечен как preview, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/os_keystone_domain_facts_module.html