Модуль dellemc.unity.host — управление операциями с хостами в Unity

Примечание

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

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

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

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

Добавлено в dellemc.unity 1.1.0

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

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

Модуль Host содержит операции создания хоста, добавления инициаторов к хосту, удаления инициаторов с хоста, изменения атрибутов хоста, получения сведений о хосте, удаления хоста, добавления сетевого адреса к хосту и удаления сетевого адреса с хоста.

Требования

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

Устройство хранения данных Dell Unity версии 5.3 или новее.
Ansible-core версии 2.17 или новее.
Python 3.11, 3.12 или 3.13.
Storops Python SDK 1.2.12.

Параметры

Параметр	Комментарии
description string	Описание хоста.
host_id string	Уникальный идентификатор хоста. Идентификатор хоста генерируется автоматически при создании. Для всех операций, кроме создания, требуется указать host_id или Ihost_name).
host_name string	Имя хоста. Обязательный параметр при создании хоста.
host_os string	Операционная система, работающая на хосте. Возможные значения: `"AIX"` `"Citrix XenServer"` `"HP-UX"` `"IBM VIOS"` `"Linux"` `"Mac OS"` `"Solaris"` `"VMware ESXi"` `"Windows Client"` `"Windows Server"`
initiator_state string	Состояние инициатора. Возможные значения: `"present-in-host"` `"absent-in-host"`
initiators list / elements=string	Список инициаторов, добавляемых к хосту или удаляемых с него.
network_address string	Сетевой адрес, добавляемый к хосту или удаляемый с него. Укажите допустимый адрес IPv4 или имя хоста.
network_address_state string	Состояние сетевого адреса. Возможные значения: `"present-in-host"` `"absent-in-host"`
new_host_name string	Новое имя хоста. Требуется только для операции переименования хоста.
password string / обязательный	Пароль сервера управления Unity.
port integer	Номер порта, используемого для связи с сервером управления Unity. По умолчанию: `443`
state string / обязательный	Состояние хоста. Возможные значения: `"present"` `"absent"`
unispherehost string / обязательный	IP-адрес или FQDN сервера управления Unity.
username string / обязательный	Имя пользователя сервера управления Unity.
validate_certs псевдонимы: verifycert boolean	Логическая переменная, определяющая, нужно ли проверять сертификат SSL. `true` — указывает, что сертификат SSL необходимо проверить. `false` — указывает, что сертификат SSL проверять не следует. Возможные значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Режим check_mode не поддерживается.
Модули этой коллекции под названием «dellemc.unity» предназначены для поддержки платформы хранения данных Dell Unity.

Примеры

- name: Create empty Host
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "ansible-test-host"
    host_os: "Linux"
    description: "ansible-test-host"
    state: "present"

- name: Create Host with Initiators
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "ansible-test-host-1"
    host_os: "Linux"
    description: "ansible-test-host-1"
    initiators:
      - "iqn.1994-05.com.redhat:c38e6e8cfd81"
      - "20:00:00:90:FA:13:81:8D:10:00:00:90:FA:13:81:8D"
    initiator_state: "present-in-host"
    state: "present"

- name: Modify Host using host_id
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_id: "Host_253"
    new_host_name: "ansible-test-host-2"
    host_os: "Mac OS"
    description: "Ansible tesing purpose"
    state: "present"

- name: Add Initiators to Host
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "ansible-test-host-2"
    initiators:
      - "20:00:00:90:FA:13:81:8C:10:00:00:90:FA:13:81:8C"
    initiator_state: "present-in-host"
    state: "present"

- name: Get Host details using host_name
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "ansible-test-host-2"
    state: "present"

- name: Get Host details using host_id
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_id: "Host_253"
    state: "present"

- name: Delete Host
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "ansible-test-host-2"
    state: "absent"

- name: Add network address to Host
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "{{host_name}}"
    network_address: "192.168.1.2"
    network_address_state: "present-in-host"
    state: "present"

- name: Delete network address from Host
  host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_name: "{{host_name}}"
    network_address: "192.168.1.2"
    network_address_state: "absent-in-host"
    state: "present"

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

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

Ключ	Описание
changed boolean	Изменился ли ресурс. Возвращается: всегда Пример: `true`
host_details dictionary	Сведения о хосте. Возвращается: если хост существует. Пример: {"auto_manage_type": "HostManageEnum.UNKNOWN", "datastores": null, "description": "ansible-test-host-1", "existed": true, "fc_host_initiators": [{"id": "HostInitiator_1", "name": "HostName_1", "paths": [{"id": "HostInitiator_1_Id1", "is_logged_in": true}, {"id": "HostInitiator_1_Id2", "is_logged_in": true}]}], "hash": "VALUE_SPECIFIED_IN_NO_LOG_PARAMETER", "health": {"UnityHealth": {"hash": 8764429420954}}, "host_container": null, "host_luns": [], "host_polled_uuid": null, "host_pushed_uuid": null, "host_uuid": null, "host_v_vol_datastore": null, "id": "Host_2198", "iscsi_host_initiators": [{"id": "HostInitiator_2", "name": "HostName_2", "paths": [{"id": "HostInitiator_2_Id1", "is_logged_in": true}, {"id": "HostInitiator_2_Id2", "is_logged_in": true}]}], "last_poll_time": null, "name": "ansible-test-host-1", "network_addresses": [], "os_type": "Linux", "registration_type": null, "storage_resources": null, "tenant": null, "type": "HostTypeEnum.HOST_MANUAL", "vms": null}
description string	Описание хоста. Возвращается: при успешном выполнении
fc_host_initiators list / elements=string	Сведения об инициаторах FC, связанных с хостом. Возвращается: при успешном выполнении
id string	Уникальный идентификатор пути инициатора FC. Возвращается: при успешном выполнении
name string	Квалифицированное имя FC (WWN) инициатора. Возвращается: при успешном выполнении
paths list / elements=string	Сведения о путях, связанных с инициатором FC. Возвращается: при успешном выполнении
id string	Уникальный идентификатор пути. Возвращается: при успешном выполнении
is_logged_in boolean	Показывает, выполнил ли инициатор хоста вход в систему хранения данных. Возвращается: при успешном выполнении
host_luns list / elements=string	Сведения о LUN, подключенных к хосту. Возвращается: при успешном выполнении
id string	Идентификатор системы, назначенный хосту. Возвращается: при успешном выполнении
iscsi_host_initiators list / elements=string	Сведения об инициаторах iSCSI, связанных с хостом. Возвращается: при успешном выполнении
id string	Уникальный идентификатор пути инициатора iSCSI. Возвращается: при успешном выполнении
name string	Квалифицированное имя iSCSI (IQN) инициатора. Возвращается: при успешном выполнении
paths list / elements=string	Сведения о путях, связанных с инициатором iSCSI. Возвращается: при успешном выполнении
id string	Уникальный идентификатор пути. Возвращается: при успешном выполнении
is_logged_in boolean	Показывает, выполнил ли инициатор хоста вход в систему хранения данных. Возвращается: при успешном выполнении
name string	Имя хоста. Возвращается: при успешном выполнении
network_addresses list / elements=string	Список сетевых адресов, сопоставленных с хостом. Возвращается: при успешном выполнении
os_type string	Операционная система, работающая на хосте. Возвращается: при успешном выполнении
type string	Значение HostTypeEnum для хоста. Возвращается: при успешном выполнении

Авторы

Rajshree Khare (@kharer5)

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

© 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/unity/host_module.html