Модуль dellemc.powerflex.nvme_host — управление хостами NVMe в Dell PowerFlex

Примечание

Этот модуль входит в коллекцию dellemc.powerflex (версия 3.0.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: dellemc.powerflex.nvme_host.

Добавлено в dellemc.powerflex 2.6.0

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

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

Управление хостами NVMe в системе хранения PowerFlex включает создание хостов NVMe, получение сведений о них, изменение и удаление.

Требования

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

Система хранения Dell PowerFlex версии 3.6 или более поздней.
PyPowerFlex 2.0.0.

Параметры

Параметр	Комментарии
hostname псевдонимы: gateway_host строка / обязательный	IP-адрес или полное доменное имя узла PowerFlex.
max_num_paths строка	Максимальное количество путей на том. Используется при создании или изменении хоста NVMe.
max_num_sys_ports строка	Максимальное количество портов на домен защиты. Используется при создании или изменении хоста NVMe.
nqn строка	NQN хоста NVMe. Используется для создания, получения сведений или изменения хоста NVMe. Чтобы получить NQN хоста NVMe, выполните команду :command:`cat /etc/nvme/hostnqn`
nvme_host_name строка	Имя хоста NVMe. Для создания, получения сведений или переименования укажите либо nvme_host_name, либо nqn.
nvme_host_new_name строка	Новое имя хоста NVMe. Используется для переименования хоста NVMe. Используется только при обновлении. При создании игнорируется.
password строка / обязательный	Пароль узла PowerFlex.
port целое число	Номер порта, через который осуществляется связь с узлом PowerFlex. По умолчанию: `443`
state строка	Состояние хоста NVMe. Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout целое число	Время, по истечении которого соединение будет разорвано. Значение указывается в секундах. По умолчанию: `120`
username строка / обязательный	Имя пользователя узла PowerFlex.
validate_certs псевдонимы: verifycert логический	Логическая переменная, указывающая, следует ли проверять сертификат SSL. `true` — указывает, что сертификат SSL необходимо проверить. `false` — указывает, что сертификат SSL проверять не нужно. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Запускает задачу для проверки без выполнения действий на целевой машине.
diff_mode	Поддержка: полная	Запускает задачу для отображения внесённых или планируемых изменений.

Примечания

Примечание

Модули коллекции «dellemc.powerflex» предназначены для поддержки платформы хранения Dell PowerFlex.

Примеры

- name: Create NVMe host
  dellemc.powerflex.nvme_host:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    nqn: "{{ nqn }}"
    nvme_host_name: "{{ nvme_host_name }}"
    state: "present"

- name: Rename nvme_host using NVMe host id
  dellemc.powerflex.nvme_host:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    nvme_host_name: "{{ nvme_host_name }}"
    nvme_host_new_name: "{{ nvme_host_new_name }}"
    state: "present"

- name: Set maximum number of paths per volume and maximum Number of Ports Per Protection Domain of nvme_host
  dellemc.powerflex.nvme_host:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    nvme_host_name: "{{ nvme_host_name }}"
    max_num_paths: "{{ max_num_paths }}"
    max_num_sys_ports: "{{ max_num_sys_ports }}"
    state: "present"

- name: Remove nvme_host
  dellemc.powerflex.nvme_host:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"
    validate_certs: "{{ validate_certs }}"
    nvme_host_name: "{{ nvme_host_name }}"
    state: "absent"

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

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

Ключ	Описание
changed логический	Изменился ли ресурс. Возвращается: всегда Пример: `false`
nvme_host_details словарь	Сведения о хосте NVMe. Возвращается: если хост NVMe существует Пример: {"hostOsFullType": "Generic", "hostType": "NVMeHost", "id": "1040d67200010000", "installedSoftwareVersionInfo": null, "kernelBuildNumber": null, "kernelVersion": null, "links": [{"href": "/api/instances/Host::1040d67200010000", "rel": "self"}, {"href": "/api/instances/Host::1040d67200010000/relationships/Volume", "rel": "/api/Host/relationship/Volume"}, {"href": "/api/instances/Host::1040d67200010000/relationships/NvmeController", "rel": "/api/Host/relationship/NvmeController"}, {"href": "/api/instances/System::264ec85b3855280f", "rel": "/api/parent/relationship/systemId"}], "maxNumPaths": 6, "maxNumSysPorts": 10, "mdmConnectionState": null, "mdmIpAddressesCurrent": null, "memoryAllocationFailure": null, "name": "name", "nqn": "nqn.org.nvmexpress:uuid", "osType": null, "peerMdmId": null, "perfProfile": null, "sdcAgentActive": null, "sdcApproved": null, "sdcApprovedIps": null, "sdcGuid": null, "sdcIp": null, "sdcIps": null, "sdcType": null, "sdrId": null, "sdtId": null, "socketAllocationFailure": null, "softwareVersionInfo": null, "systemId": "264ec85b3855280f", "versionInfo": null}
hostOsFullType строка	Полный тип ОС узла. Возвращается: при успешном выполнении
hostType строка	Тип узла. Возвращается: при успешном выполнении
id строка	ID хоста NVMe. Возвращается: при успешном выполнении
installedSoftwareVersionInfo строка	Сведения об установленной версии программного обеспечения. Возвращается: при успешном выполнении
kernelBuildNumber строка	Номер сборки ядра. Возвращается: при успешном выполнении
kernelVersion строка	Версия ядра. Возвращается: при успешном выполнении
links список / элементы=строка	Ссылки, связанные с хостом NVMe. Возвращается: при успешном выполнении
href строка	Ссылка на ресурс. Возвращается: при успешном выполнении
rel строка	Тип отношения. Возвращается: при успешном выполнении
max_num_paths целое число	Максимальное количество путей на том. Используется при создании или изменении хоста NVMe. Возвращается: при успешном выполнении
max_num_sys_ports целое число	Максимальное количество портов на домен защиты. Используется при создании или изменении хоста NVMe. Возвращается: при успешном выполнении
mdmConnectionState строка	Состояние подключения MDM. Возвращается: при успешном выполнении
mdmIpAddressesCurrent список / элементы=строка	Текущие IP-адреса MDM. Возвращается: при успешном выполнении
name строка	Имя хоста NVMe. Возвращается: при успешном выполнении
nqn строка	NQN хоста NVMe. Используется для создания, получения сведений или изменения хоста NVMe. Возвращается: при успешном выполнении
osType строка	Тип ОС. Возвращается: при успешном выполнении
peerMdmId строка	ID однорангового MDM. Возвращается: при успешном выполнении
perfProfile строка	Профиль производительности. Возвращается: при успешном выполнении
sdcAgentActive логический	Активен ли агент SDC. Возвращается: при успешном выполнении
sdcApproved логический	Предоставлен ли SDC одобренный доступ к системе. Возвращается: при успешном выполнении
sdcApprovedIps список / элементы=строка	IP-адреса, одобренные для SDC. Возвращается: при успешном выполнении
sdcGuid строка	GUID SDC. Возвращается: при успешном выполнении
sdcIp строка	IP-адрес SDC. Возвращается: при успешном выполнении
sdcIps список / элементы=строка	IP-адреса SDC. Возвращается: при успешном выполнении
sdcType строка	Тип SDC. Возвращается: при успешном выполнении
sdrId строка	ID SDR. Возвращается: при успешном выполнении
sdtId строка	ID SDT. Возвращается: при успешном выполнении
softwareVersionInfo строка	Сведения о версии программного обеспечения. Возвращается: при успешном выполнении
systemId строка	ID системы. Возвращается: при успешном выполнении
versionInfo строка	Сведения о версии. Возвращается: при успешном выполнении

Авторы

Peter Cao (@P-Cao)

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

© 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/dellemc/powerflex/nvme_host_module.html