netapp_e_host – Управление хостами NetApp E-Series
Описание
- Создание, обновление и удаление хостов на массивах хранения NetApp E-Series
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| api_password строка / обязательно | Пароль для аутентификации с SANtricity Web Services Proxy или встроенным API веб-служб. | ||
| api_url строка / обязательно | URL SANtricity Web Services Proxy или встроенного API веб-служб. Пример https://prod-1.wahoo.acme.com/devmgr/v2 | ||
| api_username строка / обязательно | Имя пользователя для аутентификации с SANtricity Web Services Proxy или встроенным API веб-служб. | ||
| force_port булево добавлен в 2.7 |
| Разрешить повторное назначение портов, которые уже назначены текущему хосту. | |
| group - | Уникальный идентификатор группы хостов, членом которой должен быть данный хост; используется для кластеризации. псевдонимы: кластер | ||
| host_type строка | Тип хоста, который нужно сопоставить. Требуется при state=present. Можно указать одно из следующих имён: Linux DM-MP, VMWare, Windows, Windows Clustered или индекс типа хоста, который можно найти в netapp_e_facts. псевдонимы: host_type_index | ||
| log_path - добавлен в 2.7 | Локальный путь к файлу для отладки логирования | ||
| name - / обязательно | Если хост ещё не существует, метка/имя для назначения при создании. Если хост уже существует, это используется для уникальной идентификации хоста, чтобы внести необходимые изменения. псевдонимы: метка | ||
| ports - | Список портов хоста, которые нужно ассоциировать с хостом. Порты хоста уникально идентифицируются по их WWN или IQN. Их назначение конкретному хосту уникально идентифицируется меткой, и эти метки должны быть уникальными. | ||
| label - / обязательно | Уникальная метка для назначения этому назначению порта. | ||
| port - / обязательно | WWN или IQN порта хоста, который нужно назначить этому определению порта. | ||
| type - / обязательно |
| Тип интерфейса порта для определения. Допустимые варианты зависят от возможностей целевой аппаратной/программной платформы. | |
| ssid строка | По умолчанию: 1 | Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. | |
| state - добавлен в 2.7 |
| Установите в absent, чтобы удалить существующий хост Установите в present, чтобы изменить или создать новое определение хоста | |
| validate_certs булево |
| Нужно ли проверять сертификаты https? | |
Примечания
Примечание
- Модули Ansible E-Series требуют наличия экземпляра Web Services Proxy (WSP) для управления системой хранения или системы хранения E-Series, поддерживающей встроенный API веб-служб.
- Встроенные веб-службы в настоящее время доступны на моделях E2800, E5700, EF570 и более новых аппаратных моделях.
- 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 строка добавлен в 2.6 | при успехе | URL API, на котором был обработан этот запрос. Пример: https://webservices.example.com:8443 |
| id строка добавлен в 2.6 | при успехе, когда state=present | Уникальный идентификатор хоста на системе хранения E-Series. Пример: 00000000600A098000AAC0C3003004700AD86A52 |
| msg строка | при успехе | Описание действий, выполненных в удобочитаемой для пользователя форме. Пример: Хост был создан. |
| ssid строка добавлен в 2.6 | при успехе | Уникальный идентификатор системы хранения E-Series с текущим API. Пример: 1 |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Kevin Hulquest (@hulquest)
- Nathan Swartz (@ndswartz)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/netapp_e_host_module.html