Модуль purestorage.flasharray.purefa_host — управление хостами в Pure Storage FlashArrays
Примечание
Этот модуль входит в коллекцию purestorage.flasharray (версия 1.42.0).
Возможно, эта коллекция уже установлена, если вы используете пакет 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 | Токен API FlashArray для пользователя с правами администратора. |
context string добавлено в purestorage.flasharray 1.33.0 | Имя участника флота, на котором нужно выполнить операцию. Для этого массив, получающий запрос, должен быть участником флота, а указанное имя контекста должно относиться к участнику того же флота. По умолчанию: |
count integer | Количество хостов, создаваемых при массовом создании. Поддерживается только в Purity//FA версии 6.0.0 и выше. |
digits integer | Количество цифр для счётчика массового создания хостов. При необходимости индекс дополняется нулями. Поддерживается только в Purity//FA версии 6.0.0 и выше. Допустимый диапазон: от 1 до 10. По умолчанию: |
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0 | Отключить предупреждения о небезопасных сертификатах в журналах отладки. Варианты:
|
fa_url string | IPv4-адрес или имя узла для управления FlashArray. |
host_password string | Задаёт пароль хоста для аутентификации CHAP. Длина пароля должна составлять от 12 до 255 символов. Чтобы очистить пару «имя пользователя/пароль», укажите в качестве пароля clear. УСТАНОВКА ПАРОЛЯ НЕ ЯВЛЯЕТСЯ ИДЕМПОТЕНТНОЙ ОПЕРАЦИЕЙ. |
host_user string | Задаёт имя пользователя хоста для аутентификации CHAP. Требуется вместе с host_password. Чтобы очистить пару «имя пользователя/пароль», укажите в качестве пароля clear. |
iqn list / элементы=string | Список IQN хоста. |
lun integer | Идентификатор LUN, назначаемый тому для хоста. Должен быть уникальным. Если значение не указано, идентификатор будет назначен автоматически. Допустимый диапазон идентификаторов LUN: от 1 до 4095. |
modify_resource_access string добавлено в purestorage.flasharray 1.35.0 | Определяет, как изменять доступ к ресурсу при его перемещении. Значение none указывает, что доступ к ресурсу изменять не нужно. Значение create используется, когда ресурс перемещается из области в массив и для него необходимо создать доступ из области, из которой он перемещается. Значение delete используется, когда ресурс перемещается из массива в область, к которой для этого ресурса уже предоставлен доступ. Варианты:
|
move list / элементы=string добавлено в purestorage.flasharray 1.35.0 | Перемещение хоста в локальные области участника или из них либо в локальный массив или из него. Укажите имена областей, в которые нужно переместить хост. Чтобы переместить хост в локальный массив, укажите Для выполнения операции перемещения хост не должен быть подключён ни к одному тому. |
name псевдонимы: host string / обязательный | Имя хоста. Обратите внимание: имена хостов чувствительны к регистру, однако имена хостов FlashArray уникальны без учёта регистра — нельзя создать хосты hosta и hostA. Массовое создание хостов поддерживается начиная с Purity//FA 6.0.0. ***ПРИМЕЧАНИЕ*** Удаление отдельных хостов, созданных при массовом создании, вручную приведёт к нарушению идемпотентности. Массовое создание поддерживается только при создании хостов. |
nqn list / элементы=string | Список NQN хоста. Обратите внимание: хосты NVMe могут иметь только NQN. Для этих хостов не допускается использование нескольких протоколов. |
personality string | Определяет операционную систему хоста. Рекомендуется для интеграции с ActiveCluster. Варианты:
|
preferred_array list / элементы=string | Список предпочтительных массивов в среде ActiveCluster. Чтобы удалить из хоста существующие предпочтительные массивы, укажите delete. |
protocol string | Определяет протокол подключения хоста для томов. УСТАРЕЛО. Этот параметр больше не требуется. Варианты:
|
rename string | Имя, которое нужно присвоить хосту. Обратите внимание: имена хостов чувствительны к регистру, однако имена хостов FlashArray уникальны без учёта регистра — нельзя создать хосты hosta и hostA. |
start integer | Начальное значение индекса для массового создания хостов. Поддерживается только в Purity//FA версии 6.0.0 и выше. По умолчанию: |
state string | Определяет, должен ли хост существовать. При удалении хоста все подключённые тома будут отключены. Варианты:
|
suffix string | Строка суффикса для массового создания хостов (если требуется). Имена хостов формируются по шаблону <name>#<suffix>, где # — обозначение индекса хоста. См. соответствующие описания. Строка суффикса необязательна. Поддерживается только в Purity//FA версии 6.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 / элементы=string | Список WWN хоста. |
Примечания
Примечание
- Если указан параметр
lun, убедитесь, что хост поддерживает запрошенное значение. - Для работы этого модуля требуются библиотеки Python
purestorageиpy-pure-client. - Для работы отдельных модулей могут потребоваться дополнительные библиотеки Python.
- Если аргументы fa_url и api_token не передаются модулю напрямую, необходимо задать переменные окружения
PUREFA_URLиPUREFA_API.
Примеры
- 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 host bar in existing realm foo
purestorage.flasharray.purefa_host:
name: foo::bar
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:00
- 11: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
iqn:
- iqn.1994-05.com.redhat:7d366003914
wwns:
- 00:00:00:00:00:00:00:01
- 11: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 existing 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
- name: Move host foo from the array to realm bar
purestorage.flasharray.purefa_host:
name: foo
move: bar
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Move host foo from realm bar back to array
purestorage.flasharray.purefa_host:
name: bar::foo
move: local
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Rename host foo in realm test to bar
purestorage.flasharray.purefa_host:
name: test::foo
rename: test::bar
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
Ссылки на коллекцию
© 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/purestorage/flasharray/purefa_host_module.html