ovirt.ovirt.ovirt_host_storage_info – Получение информации об одном или нескольких хранилищах oVirt/RHV HostStorage (применимо только для блочных хранилищ)

Примечание

Этот плагин входит в состав коллекции ovirt.ovirt (версия 1.3.0).

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

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

Новое в версии 1.0.0: модуля ovirt.ovirt

Обзор
Требования
Параметры
Примечания
Примеры
Значения возврата

Обзор

Получение информации об одном или нескольких хранилищах oVirt/RHV HostStorage (применимо только для блочных хранилищ).
Этот модуль назывался ovirt_host_storage_facts до Ansible 2.9, возвращая ansible_facts. Обратите внимание, что модуль ovirt.ovirt.ovirt_host_storage_info больше не возвращает ansible_facts!

Требования

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

python >= 2.7
ovirt-engine-sdk-python >= 4.4.0

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auth словарь / обязательный			Словарь со значениями, необходимыми для создания HTTP/HTTPS-соединения с oVirt:
	ca_file строка		Файл PEM, содержащий доверенные сертификаты CA. Сертификат, представленный сервером, будет проверен с использованием этих сертификатов CA. Если параметр `ca_file` не задан, используется системный хранилище сертификатов CA. Значение по умолчанию задано переменной среды `OVIRT_CAFILE`.
	headers словарь		Словарь HTTP-заголовков, которые необходимо добавить к каждому API-запросу.
	hostname строка		Строка, содержащая имя хоста сервера, обычно что-то вроде `server.example.com`. Значение по умолчанию задано переменной среды `OVIRT_HOSTNAME`. Требуется либо `url`, либо `hostname`.
	insecure булево	Варианты: нет да	Флаг булевого типа, указывающий, следует ли проверять сертификат TLS сервера и имя хоста.
	kerberos булево	Варианты: нет да	Флаг булевого типа, указывающий, следует ли использовать аутентификацию Kerberos вместо стандартной аутентификации.
	password строка / обязательный		Пароль пользователя. Значение по умолчанию задано переменной среды `OVIRT_PASSWORD`.
	token строка		Токен для использования вместо входа с именем пользователя/паролем. Значение по умолчанию задано переменной среды `OVIRT_TOKEN`.
	url строка		Строка, содержащая URL API сервера, обычно что-то вроде `https://server.example.com/ovirt-engine/api`. Значение по умолчанию задано переменной среды `OVIRT_URL`. Требуется либо `url`, либо `hostname`.
	username строка / обязательный		Имя пользователя, например admin@internal. Значение по умолчанию задано переменной среды `OVIRT_USERNAME`.
fcp словарь			Словарь со значениями для типа хранилища Fibre Channel:
	address строка		Адрес сервера Fibre Channel хранилища.
	lun_id строка		Идентификатор LUN.
	port строка		Порт сервера Fibre Channel хранилища.
fetch_nested булево		Варианты: нет да	Если да, модуль получит дополнительные данные из API. Будет получен только идентификатор вложенной сущности. Он не получает несколько уровней вложенных атрибутов. Только атрибуты текущей сущности. Пользователь может настроить запрос других атрибутов вложенных сущностей, указав `nested_attributes`.
host строка / обязательный			Хост, для получения списка устройств.
iscsi словарь			Словарь со значениями для типа хранилища iSCSI:
	address строка		Адрес сервера iSCSI хранилища.
	password строка		Пароль CHAP для входа на целевой сервер.
	portal строка		Портал, используемый для подключения к iSCSI.
	target строка		Целевой IQN для устройства хранения.
	username строка		Имя пользователя CHAP для входа на целевой сервер.
nested_attributes список / элементы=строка			Указывает список атрибутов, которые должны быть получены из API. Этот параметр применяется только когда `fetch_nested` равен true.

Примечания

Примечание

Для использования этого модуля необходимо установить oVirt Python SDK. Чтобы убедиться, что он установлен с правильной версией, вы можете создать следующую задачу: pip: name=ovirt-engine-sdk-python version=4.4.0

Примеры

# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:

# Gather information about HostStorages with specified target and address:
- ovirt.ovirt.ovirt_host_storage_info:
    host: myhost
    iscsi:
      target: iqn.2016-08-09.domain-01:nickname
      address: 10.34.63.204
  register: result
- ansible.builtin.debug:
    msg: "{{ result.ovirt_host_storages }}"

Значения возврата

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

Ключ	Возвращаемое значение	Описание
ovirt_host_storages список / элементы=строка	При успешном выполнении.	Список словарей, описывающих HostStorage. Атрибуты HostStorage сопоставляются с ключами словаря, все атрибуты HostStorage можно найти по следующему URL-адресу: http://ovirt.github.io/ovirt-engine-api-model/master/#types/host_storage.

Авторы

Daniel Erez (@derez)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ovirt/ovirt/ovirt_host_storage_info_module.html