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

Примечание

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

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

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

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

УСТЕРЕГШИЙСЯ

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

Описание

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

Требования

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

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 строка		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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/ovirt_host_storage_facts_module.html