Модуль hitachivantara.vspone_block.vsp.hv_external_volume — управление внешними томами в блочных системах хранения данных VSP.

Примечание

Этот модуль входит в коллекцию hitachivantara.vspone_block (версия 4.8.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте команду: ansible-galaxy collection install hitachivantara.vspone_block. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hitachivantara.vspone_block.vsp.hv_external_volume.

Добавлено в hitachivantara.vspone_block 3.3.0

Краткое описание
Требования
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль создает и удаляет внешние тома в блочных системах хранения данных VSP.
Примеры см. по адресу https://github.com/hitachi-vantara/vspone-block-ansible/blob/main/playbooks/vsp_direct/external_volume.yml

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info словарь / обязательный	Информация, необходимая для подключения к системе хранения данных.
address строка / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token строка	Токен для работы с заблокированными ресурсами.
connection_type строка	Тип подключения к системе хранения данных. Варианты: `"direct"` ← (по умолчанию)
password строка	Пароль для аутентификации. Это обязательное поле.
username строка	Имя пользователя для аутентификации. Это обязательное поле.
spec словарь	Параметры управления внешним томом.
external_ldev_id строка	Идентификатор внешнего LDEV. Обязателен для задач создания и удаления.
external_parity_group строка	Идентификатор внешней группы RAID. Обязателен для задач отключения тома.
external_storage_serial строка	Серийный номер внешней системы хранения данных. Обязателен для задач создания и удаления.
ldev_id строка	Идентификатор LDEV. Если не указан, он будет выбран автоматически. Обязателен для задач создания и удаления. Может быть десятичным или шестнадцатеричным числом.
state строка	Уровень задачи «Дисковые накопители». Варианты: `"present"` ← (по умолчанию) `"absent"` `"disconnect"`
storage_system_info словарь	Информация о системе хранения данных. Это необязательное поле.
serial строка	Серийный номер системы хранения данных.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: нет	Определяет, должен ли модуль выполняться в режиме проверки.

Примечания

Примечание

Тип подключения gateway удален, начиная с версии 3.4.0. Если вам требуется этот тип подключения, используйте более раннюю версию.

Примеры

- name: Create a External Volume
  hitachivantara.vspone_block.vsp.hv_external_volume_facts:
    connection_info:
      address: storage1.company.com
      username: 'username'
      password: 'password'
    spec:
      external_storage_serial: '410109'
      external_ldev_id: 1354
      ldev_id: 151

- name: Delete External Volume
  hitachivantara.vspone_block.vsp.hv_external_volume:
    connection_info:
      address: storage1.company.com
      username: 'username'
      password: 'password'
    state: "absent"
    spec:
      ldev_id: 151

- name: Disconnect from a volume on the external storage system
  hitachivantara.vspone_block.vsp.hv_external_volume:
    connection_info:
      address: storage1.company.com
      username: 'username'
      password: 'password'
    state: "disconnect"
    spec:
      external_parity_group: "1-2"

Возвращаемые значения

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

Ключ	Описание
external_parity_group словарь	Информация о внешней группе RAID. Возвращается: если state имеет значение disconnect
external_volume словарь	Подробная информация о внешнем томе в системе хранения данных. Возвращается: если state имеет значение present
canonical_name строка	Каноническое имя внешнего тома. Возвращается: при успешном выполнении Пример: `""`
emulation_type строка	Тип эмуляции внешнего тома. Возвращается: при успешном выполнении Пример: `"OPEN-V"`
externalPorts список / элементы=словарь	Список внешних портов, связанных с томом. Возвращается: при успешном выполнении
host_group_number целое число	Номер группы хостов для внешнего порта. Возвращается: при успешном выполнении Пример: `0`
lun целое число	Номер логического устройства. Возвращается: при успешном выполнении Пример: `17`
port_id строка	Идентификатор порта. Возвращается: при успешном выполнении Пример: `"CL6-A"`
wwn строка	Глобальное имя порта (WWN). Возвращается: при успешном выполнении Пример: `"50060e8012277d61"`
externalVolumeId строка	Идентификатор внешнего тома. Возвращается: при успешном выполнении Пример: `"484954414348492035303430323737443035353400000000000000000000000000000000"`
ldev_id целое число	Идентификатор логического устройства. Возвращается: при успешном выполнении Пример: `1579`
logical_unit_id_hex_format строка	Идентификатор логического устройства в шестнадцатеричном формате. Возвращается: при успешном выполнении Пример: `"00:06:2B"`
name строка	Имя внешнего тома. Возвращается: при успешном выполнении Пример: `"quorum-1364"`
provision_type строка	Тип выделения ресурсов для тома. Возвращается: при успешном выполнении Пример: `"ELUN,QRD"`
resource_group_id целое число	Идентификатор группы ресурсов. Возвращается: при успешном выполнении Пример: `0`
status строка	Состояние внешнего тома. Возвращается: при успешном выполнении Пример: `"BLK"`
total_capacity строка	Общая емкость в удобочитаемом формате. Возвращается: при успешном выполнении Пример: `"20.00GB"`
total_capacity_in_mb число с плавающей точкой	Общая емкость в мегабайтах. Возвращается: при успешном выполнении Пример: `20480.0`
virtual_ldev_id целое число	Идентификатор виртуального логического устройства. Возвращается: при успешном выполнении Пример: `-1`

Авторы

Hitachi Vantara LTD (@hitachi-vantara)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/hitachivantara/vspone_block/vsp.hv_external_volume_module.html