Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Для использования в playbook укажите: dellemc.unity.host.

Новое в dellemc.unity 1.1.0

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

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

  • Модуль Host содержит операции Создание хоста, Добавление инициаторов к хосту, Удаление инициаторов из хоста, Изменение атрибутов хоста, Получение подробной информации о хосте, Удаление хоста, Добавление сетевого адреса к хосту, Удаление сетевого адреса из хоста.

Требования

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

  • Устройство хранения Dell Unity версии 5.1 или выше.
  • Ansible-core 2.14 или выше.
  • Python 3.9, 3.10 или 3.11.
  • Storops Python SDK 1.2.11.

Параметры

Параметр

Комментарии

description

string

Описание хоста.

host_id

string

Уникальный идентификатор хоста.

Идентификатор хоста генерируется автоматически при создании.

За исключением создания, все остальные операции требуют либо host_id, либо host_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 / required

Пароль сервера управления Unity.

port

integer

Номер порта, через который происходит связь с сервером управления Unity.

По умолчанию: 443

state

string / required

Состояние хоста.

Варианты:

  • "present"
  • "absent"

unispherehost

string / required

IP-адрес или FQDN сервера управления Unity.

username

string / required

Имя пользователя сервера управления Unity.

validate_certs

aliases: verifycert

boolean

Булева переменная, указывающая, следует ли проверять SSL-сертификат.

true - Указывает, что SSL-сертификат должен быть проверен.

false - Указывает, что SSL-сертификат не должен быть проверен.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Create empty Host
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.host:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    host_id: "Host_253"
    state: "present"

- name: Delete Host
  dellemc.unity.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
  dellemc.unity.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
  dellemc.unity.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"

Значения возврата

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

Ключ

Описание

изменён

логический

Указывает, изменился ли ресурс.

Возвращается: всегда

Пример: true

сведения_о_хосте

словарь

Подробности о хосте.

Возвращается: когда хост существует.

Пример: {"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}

описание

строка

Описание хоста.

Возвращается: успех

fc_host_инициаторы

список / элементы=строка

Подробности инициаторов FC, связанных с хостом.

Возвращается: успех

id

строка

Уникальный идентификатор пути инициатора FC.

Возвращается: успех

имя

строка

Полное имя (WWN) инициатора FC.

Возвращается: успех

пути

список / элементы=строка

Подробности путей, связанных с инициатором FC.

Возвращается: успех

id

строка

Уникальный идентификатор пути.

Возвращается: успех

подключён

логический

Указывает, подключен ли инициатор хоста к системе хранения.

Возвращается: успех

host_luns

список / элементы=строка

Подробности LUN, подключенных к хосту.

Возвращается: успех

id

строка

Системный идентификатор хоста.

Возвращается: успех

iscsi_host_инициаторы

список / элементы=строка

Подробности инициаторов ISCSI, связанных с хостом.

Возвращается: успех

id

строка

Уникальный идентификатор пути инициатора ISCSI.

Возвращается: успех

имя

строка

Полное имя (IQN) инициатора ISCSI.

Возвращается: успех

пути

список / элементы=строка

Подробности путей, связанных с инициатором ISCSI.

Возвращается: успех

id

строка

Уникальный идентификатор пути.

Возвращается: успех

подключён

логический

Указывает, подключен ли инициатор хоста к системе хранения.

Возвращается: успех

имя

строка

Имя хоста.

Возвращается: успех

сетевые_адреса

список / элементы=строка

Список сетевых адресов, сопоставленных с хостом.

Возвращается: успех

тип_ОС

строка

Операционная система, работающая на хосте.

Возвращается: успех

тип

строка

Тип хоста HostTypeEnum.

Возвращается: успех

Авторы

  • Rajshree Khare (@kharer5)

Ссылки на сборник

  • Отслеживание ошибок
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/unity/host_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API