Модуль hitachivantara.vspone_block.vsp.hv_nvm_subsystems — управление подсистемами NVM в блочных системах хранения данных 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_nvm_subsystems.

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

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

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

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

Требования

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

python >= 3.9

Параметры

Параметр	Комментарии
connection_info dictionary / обязательный	Сведения, необходимые для установления соединения с системой хранения данных.
address string / обязательный	IP-адрес или имя хоста системы хранения данных.
api_token string	Токен для выполнения операций с заблокированными ресурсами.
password string	Пароль для аутентификации. Это обязательное поле.
username string	Имя пользователя для аутентификации. Это обязательное поле.
spec dictionary / обязательный	Спецификация используемых подсистем NVM.
enable_namespace_security boolean	Настройки безопасности пространства имён. Обязательный параметр для задачи создания подсистемы NVM с определённым идентификатором. Необязательный параметр для задачи создания подсистемы NVM со свободным идентификатором. Варианты: `false` `true` ← (по умолчанию)
force boolean	Этот флаг используется для принудительного выполнения операции. Обязательный параметр для задач принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / принудительного удаления подсистемы NVM с определённым идентификатором / принудительного удаления подсистемы NVM с определённым именем. Варианты: `false` ← (по умолчанию) `true`
host_mode string	Режим узла подсистемы NVM. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / создания подсистемы NVM со свободным идентификатором.
host_nqns list / elements=dictionary	NQN узлов подсистемы NVM. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / добавления NQN узлов в подсистему NVM с определённым идентификатором / добавления NQN узлов в подсистему NVM с определённым именем / удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / принудительного удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов NQN узлов подсистемы NVM с определённым идентификатором или именем. Необязательный параметр для задачи создания подсистемы NVM со свободным идентификатором.
id integer	Идентификатор подсистемы NVM. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / добавления NQN узлов в подсистему NVM с определённым идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым идентификатором / добавления портов в подсистему NVM с определённым идентификатором / удаления портов из подсистемы NVM с определённым именем или идентификатором / удаления путей пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / принудительного удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов NQN узлов подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов пространств имён подсистемы NVM с определённым идентификатором или именем / удаления подсистемы NVM с определённым идентификатором / принудительного удаления подсистемы NVM с определённым идентификатором.
name string	Имя подсистемы NVM. Если оно не указано, подсистеме NVM присваивается имя «smrha-<10 digit random number>». Необязательный параметр для задач создания подсистемы NVM с определённым идентификатором / создания подсистемы NVM со свободным идентификатором. Обязательный параметр для задач добавления NQN узлов в подсистему NVM с определённым именем / добавления пространств имён и путей пространств имён в подсистему NVM с определённым именем / добавления портов в подсистему NVM с определённым именем / удаления портов из подсистемы NVM с определённым именем или идентификатором / удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / принудительного удаления NQN узлов из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов NQN узлов подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов пространств имён подсистемы NVM с определённым идентификатором или именем / удаления подсистемы NVM с определённым именем / принудительного удаления подсистемы NVM с определённым именем.
namespaces list / elements=dictionary	Пространства имён подсистемы NVM. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым именем / удаления путей пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов пространств имён подсистемы NVM с определённым идентификатором или именем. Необязательный параметр для задачи создания подсистемы NVM со свободным идентификатором.
ldev_id string / обязательный	Идентификатор LDEV пространства имён. Может быть десятичным или шестнадцатеричным. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / создания подсистемы NVM со свободным идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым именем / удаления путей пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов пространств имён подсистемы NVM с определённым идентификатором или именем.
nickname string	Псевдоним пространства имён. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / создания подсистемы NVM со свободным идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым именем / удаления путей пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов пространств имён подсистемы NVM с определённым идентификатором или именем.
paths list / elements=string	Пути пространства имён. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / создания подсистемы NVM со свободным идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым идентификатором / добавления пространств имён и путей пространств имён в подсистему NVM с определённым именем / удаления путей пространства имён из подсистемы NVM с определённым идентификатором или именем / удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / принудительного удаления пространства имён из подсистемы NVM с определённым идентификатором или именем / обновления псевдонимов пространств имён подсистемы NVM с определённым идентификатором или именем.
port_ids псевдонимы: ports list / elements=string	Порты подсистемы NVM. Обязательный параметр для задач создания подсистемы NVM с определённым идентификатором / создания подсистемы NVM со свободным идентификатором / добавления портов в подсистему NVM с определённым идентификатором / добавления портов в подсистему NVM с определённым именем / удаления портов из подсистемы NVM с определённым именем или идентификатором.
state string	Операция, которую необходимо выполнить с подсистемой NVM. `add_port` — добавить порты в подсистему NVM. `remove_port` — удалить порты из подсистемы NVM. `add_host_nqn` — добавить NQN узлов в подсистему NVM. `remove_host_nqn` — удалить NQN узлов из подсистемы NVM. `add_namespace` — добавить пространства имён в подсистему NVM. `remove_namespace` — удалить пространства имён из подсистемы NVM. `add_namespace_path` — добавить пути к пространству имён. `remove_namespace_path` — удалить пути из пространства имён. Варианты: `"add_port"` `"remove_port"` `"add_host_nqn"` `"remove_host_nqn"` `"add_namespace"` `"remove_namespace"` `"add_namespace_path"` `"remove_namespace_path"`
state string	Требуемое состояние подсистемы NVM. Варианты: `"present"` ← (по умолчанию) `"absent"`
storage_system_info dictionary	Сведения о системе хранения данных. Это необязательное поле.
serial string	Серийный номер системы хранения данных.

Атрибуты

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

Примечания

Примечание

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

Примеры

- name: Create an NVM Subsystem
  hitachivantara.vspone_block.vsp.hv_nvm_subsystems:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    state: "present"
    spec:
      name: "nvm_tcp_01"
      id: 1000
      host_mode: "VMWARE_EX"
      enable_namespace_security: true
      port_ids: ["CL1-D"]
      host_nqns:
        - nqn: "nqn.2014-08.org.example:uuid:4b73e622-ddc1-449a-99f7-412c0d3baa40"
          nickname: "my_host_nqn_40"
      namespaces:
        - ldev_id: 11101
          nickname: "nickname"
          paths: ["nqn.2014-08.org.example:uuid:4b73e622-ddc1-449a-99f7-412c0d3baa40"]

- name: Add host NQNs to an NVM Subsystem with a specific ID
  hitachivantara.vspone_block.vsp.hv_nvm_subsystems:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      id: 1000
      state: "add_host_nqn"
      host_nqns:
        - nqn: "nqn.2014-08.org.example:uuid:4b73e622-ddc1-449a-99f7-412c0d3baa41"
          nickname: "my_host_nqn_41"

- name: Remove host NQNs from an NVM Subsystem with a specific ID
  hitachivantara.vspone_block.vsp.hv_nvm_subsystems:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    spec:
      id: 1000
      state: "remove_host_nqn"
      host_nqns:
        - nqn: "nqn.2014-08.org.example:uuid:4b73e622-ddc1-449a-99f7-412c0d3baa41"
          nickname: "my_host_nqn_41"

- name: Delete an NVM Subsystem with a specific Id forcefully
  hitachivantara.vspone_block.vsp.hv_nvm_subsystems:
    connection_info:
      address: storage1.company.com
      username: "admin"
      password: "secret"
    state: "absent"
    spec:
      id: "nvm_subsystems_id_18"
      force: true

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

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

Ключ	Описание
nvm_subsystems list / elements=dictionary	Сведения о подсистеме NVM. Возвращается: при успешном выполнении
host_nqn_info list / elements=dictionary	Список сведений о NQN хоста. Возвращается: при успешном выполнении
host_nqn string	NQN хоста. Возвращается: при успешном выполнении Пример: `"nqn.2014-08.com.ucpa-sc-hv:nvme:scpodl-esxi235"`
host_nqn_nickname string	Псевдоним NQN хоста. Возвращается: при успешном выполнении Пример: `""`
namespace_paths_info list / elements=dictionary	Список сведений о путях к пространствам имён. Возвращается: при успешном выполнении
host_nqn string	NQN хоста. Возвращается: при успешном выполнении Пример: `"nqn.2014-08.com.ucpa-sc-hv:nvme:scpodl-esxi235"`
ldev_id integer	Идентификатор логического устройства. Возвращается: при успешном выполнении Пример: `5555`
ldev_id_hex string	Шестнадцатеричный идентификатор логического устройства. Возвращается: при успешном выполнении Пример: `"00:15:B3"`
namespace_id integer	Идентификатор пространства имён. Возвращается: при успешном выполнении Пример: `3`
namespaces_info list / elements=dictionary	Список сведений о пространствах имён. Возвращается: при успешном выполнении
block_capacity integer	Ёмкость пространства имён в блоках. Возвращается: при успешном выполнении Пример: `20971520`
capacity_in_mb float	Ёмкость в МБ. Возвращается: при успешном выполнении Пример: `10240.0`
capacity_in_unit string	Ёмкость в удобочитаемых единицах измерения. Возвращается: при успешном выполнении Пример: `"10.00GB"`
ldev_id integer	Идентификатор логического устройства. Возвращается: при успешном выполнении Пример: `2000`
ldev_id_hex string	Шестнадцатеричный идентификатор логического устройства. Возвращается: при успешном выполнении Пример: `"00:07:D0"`
namespace_id integer	Идентификатор пространства имён. Возвращается: при успешном выполнении Пример: `2`
namespace_nickname string	Псевдоним пространства имён. Возвращается: при успешном выполнении Пример: `""`
nvm_subsystem_info dictionary	Сведения о подсистеме NVM. Возвращается: при успешном выполнении
host_mode string	Режим хоста. Возвращается: при успешном выполнении Пример: `"VMWARE_EX"`
namespace_security_setting string	Настройка безопасности пространства имён. Возвращается: при успешном выполнении Пример: `"Enable"`
nvm_subsystem_id integer	Идентификатор подсистемы NVM. Возвращается: при успешном выполнении Пример: `1`
nvm_subsystem_name string	Имя подсистемы NVM. Возвращается: при успешном выполнении Пример: `"NVME-TCP-CL1-D-01"`
resource_group_id integer	Идентификатор группы ресурсов. Возвращается: при успешном выполнении Пример: `8`
t10pi_mode string	Режим T10PI. Возвращается: при успешном выполнении Пример: `"Disable"`
port_info list / elements=dictionary	Список сведений о портах. Возвращается: при успешном выполнении
port_id string	Идентификатор порта. Возвращается: при успешном выполнении Пример: `"CL1-D"`
port_type string	Тип порта. Возвращается: при успешном выполнении Пример: `"NVME_TCP"`
storage_serial_number string	Серийный номер системы хранения данных. Возвращается: при успешном выполнении Пример: `"810045"`

Авторы

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_nvm_subsystems_module.html