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

Примечание

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

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

Для использования в playbook укажите: community.general.ovirt_host_storage_facts.

УСТЕРЕГШЕЕ
Синопсис
Требования
Параметры
Примечания
Примеры
Значения возврата
Статус

УСТЕРЕГШЕЕ

Удалено в: версии 3.0.0
Почему: При миграции в коллекцию мы решили использовать только модули _info.
Альтернатива: Используйте ovirt.ovirt.ovirt_host_storage_info вместо этого.

Синопсис

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

Требования

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

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
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 вместо стандартной аутентификации. `headers` - Словарь HTTP-заголовков, которые следует добавить к каждому вызову API.
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. Чтобы убедиться, что он установлен с правильной версией, можно выполнить следующую задачу: ansible.builtin.pip: name=ovirt-engine-sdk-python version=4.3.0

Примеры

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

- name: Gather information about HostStorages with specified target and address
  ovirt_host_storage_info:
    host: myhost
    iscsi:
      target: iqn.2016-08-09.domain-01:nickname
      address: 10.34.63.204
  register: result

- name: Print gathered information
  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.

Статус

Этот модуль будет удалён в версии 3.0.0. [устаревший]
Дополнительная информация см. в УСТЕРЕГШЕЕ.

Авторы

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.10/collections/community/general/ovirt_host_storage_facts_module.html