Модуль purestorage.flasharray.purefa_host — Управление хостами на Pure Storage FlashArrays
Примечание
Этот модуль входит в коллекцию purestorage.flasharray (версия 1.31.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install purestorage.flasharray. Для использования этого модуля потребуются дополнительные требования, см. Требования для подробностей.
Для использования в книге задач укажите: purestorage.flasharray.purefa_host.
Новый в purestorage.flasharray 1.0.0
Описание
- Создание, удаление или изменение хостов на Pure Storage FlashArrays.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 3.3
- purestorage >= 1.19
- py-pure-client >= 1.26.0
- netaddr
- requests
- pycountry
- urllib3
Параметры
Параметр | Комментарии |
|---|---|
api_token string | FlashArray API токен для пользователя с правами администратора. |
count integer | Количество хостов, которые будут созданы при создании нескольких хостов Поддерживается только начиная с Purity//FA v6.0.0 и выше |
digits integer | Количество цифр для использования при создании нескольких хостов. Это будет дополнять номер индекса нулями, где это необходимо Поддерживается только начиная с Purity//FA v6.0.0 и выше Диапазон от 1 до 10 Default: |
disable_warnings boolean added in purestorage.flasharray 1.29.0 | Отключить предупреждения о небезопасных сертификатах в журналах отладки Choices:
|
fa_url string | FlashArray IP-адрес управления IPv4 или имя хоста. |
host_password string | Устанавливает пароль хоста для CHAP-аутентификации Длина пароля от 12 до 255 символов Чтобы очистить пару имя пользователя/пароль, используйте clear в качестве пароля УСТАНОВКА ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНОЙ |
host_user string | Устанавливает имя пользователя хоста для CHAP-аутентификации Требуется с host_password Чтобы очистить пару имя пользователя/пароль, используйте clear в качестве пароля |
iqn list / elements=string | Список IQN хоста. |
lun integer | Идентификатор LUN, который будет назначен тому для хоста. Должен быть уникальным. Если не указано, идентификатор будет назначен автоматически. Диапазон для идентификатора LUN - от 1 до 4095. |
name aliases: host string / required | Имя хоста. Обратите внимание, что имена хостов учитывают регистр, однако имена хостов FlashArray уникальны и игнорируют регистр - вы не можете иметь hosta и hostA Поддержка множества хостов доступна с Purity//FA 6.0.0 ***ПРИМЕЧАНИЕ*** Ручное удаление отдельных хостов, созданных с помощью множества хостов, приведет к сбою идемпотентности Поддержка множества хостов существует только для создания хостов |
nqn list / elements=string | Список NQN хоста. |
personality string | Определяет операционную систему хоста. Рекомендуется для интеграции ActiveCluster. Choices:
|
preferred_array list / elements=string | Список предпочтительных массивов в среде ActiveCluster. Чтобы удалить существующие предпочтительные массивы из хоста, укажите delete. |
protocol string | Определяет протокол подключения хоста для томов. УСТАРЕЛ. Больше не является необходимым параметром Choices:
|
rename string | Имя для переименования. Обратите внимание, что имена хостов учитывают регистр, однако имена хостов FlashArray уникальны и игнорируют регистр - вы не можете иметь hosta и hostA |
start integer | Номер, с которого следует начать индекс создания нескольких хостов Поддерживается только начиная с Purity//FA v6.0.0 и выше Default: |
state string | Определяет, должен ли существовать хост или нет. При удалении хоста все подключенные тома будут отключены. Choices:
|
suffix string | Суффиксная строка, если требуется, для создания нескольких хостов Имена хостов будут формироваться как <name>#<suffix>, где # - это заполнитель для индекса хоста. См. соответствующие описания Суффиксная строка является необязательной Поддерживается только начиная с Purity//FA v6.0.0 и выше |
target_password string | Устанавливает целевой пароль для CHAP-аутентификации Длина пароля от 12 до 255 символов Чтобы очистить пару имя пользователя/пароль, используйте clear в качестве пароля УСТАНОВКА ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНОЙ |
target_user string | Устанавливает имя целевого пользователя для аутентификации CHAP Требуется вместе с target_password Чтобы очистить пару имя пользователя/пароль, используйте clear в качестве пароля |
vlan string добавлен в purestorage.flasharray 1.16.0 | Идентификатор VLAN, к которому подключен хост. Если не задано или задано как any, хост может получить доступ к любой VLAN. Если задано как untagged, хост может получить доступ только к немаркированным VLAN. Если задано значение от 1 до 4094, хост может получить доступ только к указанной VLAN с этим номером. |
volume string | Имя тома для сопоставления с хостом. |
wwns list / elements=string | Список wwns хоста. |
Примечания
Примечание
- При указании опции
lunубедитесь, что хост поддерживает запрошенное значение - Для этого модуля необходимы Python-библиотеки
purestorageиpy-pure-client - Для определенных модулей могут потребоваться дополнительные Python-библиотеки.
- Вы должны установить переменные среды
PUREFA_URLиPUREFA_API, если аргументы fa_url и api_token не переданы в модуль напрямую
Примеры
- name: Create new AIX host
purestorage.flasharray.purefa_host:
name: foo
personality: aix
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create 10 hosts with index starting at 10 but padded with 3 digits
purestorage.flasharray.purefa_host:
name: foo
personality: vms
suffix: bar
count: 10
start: 10
digits: 3
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: present
- name: Rename host foo to bar
purestorage.flasharray.purefa_host:
name: foo
rename: bar
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete host
purestorage.flasharray.purefa_host:
name: foo
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
state: absent
- name: Make host bar with wwn ports
purestorage.flasharray.purefa_host:
name: bar
wwns:
- 00:00:00:00:00:00:00
- 11:11:11:11:11:11:11
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Make host bar with iSCSI ports
purestorage.flasharray.purefa_host:
name: bar
iqn:
- iqn.1994-05.com.redhat:7d366003913
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Make host bar with NVMe ports
purestorage.flasharray.purefa_host:
name: bar
nqn:
- nqn.2014-08.com.vendor:nvme:nvm-subsystem-sn-d78432
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Make mixed protocol host
purestorage.flasharray.purefa_host:
name: bar
nqn:
- nqn.2014-08.com.vendor:nvme:nvm-subsystem-sn-d78432
iqn:
- iqn.1994-05.com.redhat:7d366003914
wwns:
- 00:00:00:00:00:00:01
- 11:11:11:11:11:11:12
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Map host foo to volume bar as LUN ID 12
purestorage.flasharray.purefa_host:
name: foo
volume: bar
lun: 12
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Disconnect volume bar from host foo
purestorage.flasharray.purefa_host:
name: foo
volume: bar
state: absent
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Add preferred arrays to host foo
purestorage.flasharray.purefa_host:
name: foo
preferred_array:
- array1
- array2
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete preferred arrays from host foo
purestorage.flasharray.purefa_host:
name: foo
preferred_array: delete
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete exisitng WWNs from host foo (does not delete host object)
purestorage.flasharray.purefa_host:
name: foo
wwns: ""
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Set CHAP target and host username/password pairs
purestorage.flasharray.purefa_host:
name: foo
target_user: user1
target_password: passwrodpassword
host_user: user2
host_password: passwrodpassword
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete CHAP target and host username/password pairs
purestorage.flasharray.purefa_host:
name: foo
target_user: user
target_password: clear
host_user: user
host_password: clear
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
Ссылки на коллекцию
© 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/purestorage/flasharray/purefa_host_module.html