модуль purestorage.flasharray.purefa_user — создание, изменение или удаление локальной учётной записи пользователя FlashArray

Примечание

Этот модуль входит в коллекцию purestorage.flasharray (версия 1.42.0).

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

Для установки используйте: ansible-galaxy collection install purestorage.flasharray. Для использования этого модуля необходимы дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: purestorage.flasharray.purefa_user.

Добавлено в purestorage.flasharray 1.0.0

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

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

Создание, изменение или удаление локальных пользователей в Pure Storage FlashArray.

Требования

Следующие компоненты необходимы на узле, на котором выполняется этот модуль.

python >= 3.3
purestorage >= 1.19
py-pure-client >= 1.26.0
netaddr
requests
pycountry
urllib3

Параметры

Параметр	Комментарии
ad_user логический добавлено в purestorage.flasharray 1.37.0	Указывает, находится ли пользователь в системе AD Для локальных пользователей указывать не требуется Варианты: `false` ← (по умолчанию) `true`
api логический	Указывает, нужно ли создать для этого пользователя токен API Токен можно вывести с помощью модуля debug Варианты: `false` ← (по умолчанию) `true`
api_token строка	Токен API FlashArray для пользователя с привилегиями администратора.
disable_warnings логический добавлено в purestorage.flasharray 1.29.0	Отключает предупреждения о небезопасных сертификатах в журналах отладки Варианты: `false` ← (по умолчанию) `true`
fa_url строка	IPv4-адрес или имя узла для управления FlashArray.
name строка / обязательный	Имя локальной учётной записи пользователя
old_password строка	При смене существующего пароля в целях безопасности необходимо указать старый пароль
password строка	Пароль локального пользователя.
public_key строка добавлено в purestorage.flasharray 1.34.0	Открытый ключ для доступа по SSH. Чтобы удалить существующий ключ, укажите пустую строку
role строка	Задаёт уровень доступа локального пользователя к массиву Варианты: `"readonly"` ← (по умолчанию) `"ops_admin"` `"storage_admin"` `"array_admin"`
state строка	Создание, удаление или обновление локальной учётной записи пользователя Варианты: `"absent"` `"present"` ← (по умолчанию)
timeout строка добавлено в purestorage.flasharray 1.34.0	Срок действия токена API. Допустимые значения: недели (w), дни (d), часы (h), минуты (m) и секунды (s). По умолчанию: `"0"`

Примечания

Примечание

Для этого модуля требуются библиотеки Python purestorage и py-pure-client.
Для отдельных модулей могут потребоваться дополнительные библиотеки Python.
Если аргументы fa_url и api_token не передаются модулю напрямую, необходимо задать переменные окружения PUREFA_URL и PUREFA_API.

Примеры

- name: Create new user ansible with API token
  purestorage.flasharray.purefa_user:
    name: ansible
    password: apassword
    role: storage_admin
    api: true
    timeout: 2d
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
  register: result

  debug:
    msg: "API Token: {{ result['user_info']['user_api'] }}"

- name: Overwrite/add SSH public key for existing user
  purestorage.flasharray.purefa_user:
    name: ansible
    role: array_admin
    public_key: "{{lookup('file', 'id_rsa.pub') }}"
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Remove existing SSH public key from user
  purestorage.flasharray.purefa_user:
    name: ansible
    role: array_admin
    public_key: ""
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Change role type for existing user
  purestorage.flasharray.purefa_user:
    name: ansible
    role: array_admin
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Change password type for existing user (NOT IDEMPOTENT)
  purestorage.flasharray.purefa_user:
    name: ansible
    password: anewpassword
    old_password: apassword
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create an API token (TTL of 2 days) and assign a public key to an AD user
  purestorage.flasharray.purefa_user:
    name: ansible-ad
    ad_user: true
    public_key: "{{lookup('file', 'id_rsa.pub') }}"
    api: true
    timeout: 2d
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Change API token and token timeout for existing user
  purestorage.flasharray.purefa_user:
    name: ansible
    api: true
    role: array_admin
    timeout: 1d
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
  register: result

  debug:
    msg: "API Token: {{ result['user_info']['user_api'] }}"

Авторы

Команда Ansible Pure Storage (@sdodsley)

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

© 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_user_module.html