netapp_eseries.santricity.netapp_e_host модуль — Управление хостами NetApp E-Series

Примечание

Этот модуль является частью коллекции netapp_eseries.santricity (версия 1.4.1).

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

Для её установки используйте: ansible-galaxy collection install netapp_eseries.santricity.

Чтобы использовать её в playbook, укажите: netapp_eseries.santricity.netapp_e_host.

Новая функция в netapp_eseries.santricity 2.2.0

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создание, обновление и удаление хостов на хранилищах NetApp E-Series

Параметры

Параметр	Комментарии
api_password строка / обязательно	Пароль для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API.
api_url строка / обязательно	URL-адрес SANtricity Web Services Proxy или Embedded Web Services API. Пример https://prod-1.wahoo.acme.com/devmgr/v2
api_username строка / обязательно	Имя пользователя для аутентификации с SANtricity Web Services Proxy или Embedded Web Services API.
force_port логическое добавлен в netapp_eseries.santricity 2.7.0	Разрешить переназначение портов, которые уже назначены вашему текущему хосту Варианты: `false` ← (по умолчанию) `true`
group псевдонимы: cluster строка	Уникальный идентификатор группы хостов, членом которой должен быть хост; используется для кластеризации.
host_type псевдонимы: host_type_index строка	Тип хоста, который нужно сопоставить Требуется, когда `state=present` Можно указать одно из следующих имён: Linux DM-MP, VMWare, Windows, Windows Clustered или индекс типа хоста, который можно найти в netapp_eseries.santricity.netapp_e_facts
log_path строка добавлен в netapp_eseries.santricity 2.7.0	Локальный путь к файлу для отладки логирования
name псевдонимы: label строка / обязательно	Если хост ещё не существует, метка/имя для присвоения при создании. Если хост уже существует, это будет использоваться для уникальной идентификации хоста, чтобы внести необходимые изменения
ports список / элементы=словарь	Список портов хоста, которые вы хотите связать с хостом. Порты хоста уникально идентифицируются по своему WWN или IQN. Их назначение конкретному хосту уникально определяется меткой, и эти метки должны быть уникальными.
label строка / обязательно	Уникальная метка для присвоения этому назначению порта.
port строка / обязательно	WWN или IQN порта хоста, который нужно назначить этому определению порта.
type строка / обязательно	Тип интерфейса порта для определения. Допустимые варианты зависят от возможностей целевой аппаратной/программной платформы. Варианты: `"iscsi"` `"sas"` `"fc"` `"ib"` `"nvmeof"` `"ethernet"`
ssid строка	Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. По умолчанию: `"1"`
state строка добавлен в netapp_eseries.santricity 2.7.0	Установите в absent, чтобы удалить существующий хост Установите в present, чтобы изменить или создать новое определение хоста Варианты: `"absent"` `"present"` ← (по умолчанию)
validate_certs логическое	Нужно ли проверять сертификаты https? Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Модули Ansible E-Series требуют наличия экземпляра веб-сервисного прокси (WSP) для управления хранилищем или системы хранения E-Series, поддерживающей встроенный API веб-служб.
Встроенные веб-службы в настоящее время доступны на моделях E2800, E5700, EF570 и более новых моделях оборудования.
netapp_eseries.santricity.netapp_e_storage_system может использоваться для настройки систем, управляемых экземпляром WSP.

Примеры

- name: Define or update an existing host named 'Host1'
  netapp_e_host:
    ssid: "1"
    api_url: "10.113.1.101:8443"
    api_username: admin
    api_password: myPassword
    name: "Host1"
    state: present
    host_type_index: Linux DM-MP
    ports:
      - type: 'iscsi'
        label: 'PORT_1'
        port: 'iqn.1996-04.de.suse:01:56f86f9bd1fe'
      - type: 'fc'
        label: 'FC_1'
        port: '10:00:FF:7C:FF:FF:FF:01'
      - type: 'fc'
        label: 'FC_2'
        port: '10:00:FF:7C:FF:FF:FF:00'

- name: Ensure a host named 'Host2' doesn't exist
  netapp_e_host:
    ssid: "1"
    api_url: "10.113.1.101:8443"
    api_username: admin
    api_password: myPassword
    name: "Host2"
    state: absent

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

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

Ключ	Описание
api_url строка добавлен в netapp_eseries.santricity 2.6.0	адрес URL API, который обработал этот запрос Возвращаемое значение: при успехе Пример: `"https://webservices.example.com:8443"`
id строка добавлен в netapp_eseries.santricity 2.6.0	уникальный идентификатор хоста в системе хранения E-Series Возвращаемое значение: при успехе, когда state=present Пример: `"00000000600A098000AAC0C3003004700AD86A52"`
msg строка	Описание действий, выполненных в удобочитаемой форме для пользователя. Возвращаемое значение: при успехе Пример: `"The host has been created."`
ssid строка добавлен в netapp_eseries.santricity 2.6.0	уникальный идентификатор системы хранения E-Series с текущим API Возвращаемое значение: при успехе Пример: `"1"`

Авторы

Kevin Hulquest (@hulquest)
Nathan Swartz (@ndswartz)

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

© 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/netapp_eseries/santricity/netapp_e_host_module.html