ovirt_host_storage_facts - Получение фактов об одном или нескольких хранилищах oVirt/RHV HostStorage (применимо только для блочных хранилищ)
Новое в версии 2.4.
Обзор
- Получение фактов об одном или нескольких хранилищах oVirt/RHV HostStorage (применимо только для блочных хранилищ).
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.2.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| auth обязательно | Словарь со значениями, необходимыми для создания HTTP/HTTPS-соединения с oVirt: username[обязательно] - Имя пользователя, например admin@internal. Значение по умолчанию устанавливается переменной среды OVIRT_USERNAME.password[обязательно] - Пароль пользователя. Значение по умолчанию устанавливается переменной среды OVIRT_PASSWORD.url- Строка, содержащая URL API сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию устанавливается переменной среды OVIRT_URL. Требуется либо url либо hostname. hostname - Строка, содержащая имя хоста сервера, обычно что-то вроде `server.example.com`. Значение по умолчанию устанавливается переменной среды OVIRT_HOSTNAME. Требуется либо url либо hostname. token - Токен, используемый вместо входа с именем пользователя/паролем. Значение по умолчанию устанавливается переменной среды OVIRT_TOKEN.insecure - Флажок, указывающий, следует ли проверять сертификат TLS сервера и имя хоста.ca_file - Файл PEM, содержащий доверенные сертификаты CA. Представленный сервером сертификат будет проверен с помощью этих сертификатов CA. Если параметр `ca_file` не задан, используется системный хранилище сертификатов CA. Значение по умолчанию устанавливается переменной среды OVIRT_CAFILE.kerberos - Флажок, указывающий, следует ли использовать аутентификацию Kerberos вместо стандартной аутентификации по протоколу basic.headers - Словарь HTTP-заголовков, которые необходимо добавить к каждому API-запросу. | |
| fcp | Словарь со значениями для типа хранилища Fibre Channel: address - Адрес сервера Fibre Channel хранилища.port - Порт сервера Fibre Channel хранилища.lun_id - Идентификатор LUN. | |
| fetch_nested (добавлено в 2.3) | Если True, модуль получит дополнительные данные из API. Будут получены идентификаторы дисков ВМ, снимков и т.д. Пользователь может настроить получение других атрибутов вложенных сущностей, указав nested_attributes. | |
| host обязательно | Хост, с которого получить список устройств. | |
| iscsi | Словарь со значениями для типа хранилища iSCSI: address - Адрес сервера iSCSI хранилища.target - Целевой IQN для устройства хранилища.username - Имя пользователя CHAP для входа на целевой ресурс.password - Пароль CHAP для входа на целевой ресурс. | |
| nested_attributes (добавлено в 2.3) | Указывает список атрибутов, которые должны быть получены из API. Этот параметр применяется только когда fetch_nested имеет значение true. |
Примечания
Примечание
- Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, можно создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.2.4
Примеры
# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:
# Gather facts about HostStorages with specified target and address:
- ovirt_host_storage_facts:
host: myhost
iscsi:
target: iqn.2016-08-09.domain-01:nickname
address: 10.34.63.204
- debug:
var: ovirt_host_storages
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| ovirt_host_storages список | При успешном выполнении. | Список словарей, описывающих HostStorage. Атрибуты HostStorage сопоставлены с ключами словаря, все атрибуты HostStorage можно найти по следующему URL: http://ovirt.github.io/ovirt-engine-api-model/master/#types/host_storage. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется быть обратной совместимым.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в Руководстве по поддержке модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Daniel Erez (@derez)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 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/ovirt_host_storage_facts_module.html
