Модуль purestorage.flasharray.purefa_policy – управление политиками файловых систем FlashArray
Примечание
Этот модуль входит в коллекцию purestorage.flasharray (версия 1.42.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install purestorage.flasharray. Для работы с этим модулем могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: purestorage.flasharray.purefa_policy.
Добавлено в purestorage.flasharray 1.5.0
Краткое описание
- Управление политиками файловых систем FlashArray для NFS, SMB и снимков
Требования
Перечисленные ниже компоненты необходимы на узле, на котором выполняется этот модуль.
- python >= 3.3
- purestorage >= 1.19
- py-pure-client >= 1.26.0
- netaddr
- requests
- pycountry
- urllib3
Параметры
Параметр | Комментарии |
|---|---|
access_based_enumeration boolean добавлено в purestorage.flasharray 1.26.0 | Определяет, включено ли перечисление на основе прав доступа для SMB Варианты:
|
anongid string добавлено в purestorage.flasharray 1.14.0 | Идентификатор, которому будут сопоставлены пользователи, чей GID затрагивается параметром access в режимах root-squash или all-squash. Игнорируется, если включен параметр user_mapping. Для очистки укажите “”. По умолчанию: |
anonuid string добавлено в purestorage.flasharray 1.14.0 | Идентификатор, которому будут сопоставлены пользователи, чей UID затрагивается параметром access в режимах root-squash или all-squash. Для очистки укажите “”. По умолчанию: |
api_token string | Токен API FlashArray для пользователя с правами администратора. |
client string | Указывает, каким клиентам SMB или NFS предоставляется доступ Допустимые форматы: IP-адрес, маска IP-адреса или имя узла |
context string добавлено в purestorage.flasharray 1.39.0 | Имя участника флота, на котором выполняется операция. Массив, получающий запрос, должен быть участником флота, а указанное имя контекста должно принадлежать участнику того же флота. По умолчанию: |
continuous_availability boolean добавлено в purestorage.flasharray 1.40.0 | Определяет, включена ли непрерывная доступность для политики. Если для политики включена непрерывная доступность, файловые ресурсы остаются доступными даже при сбоях, которые обычно приводят к перебоям, например при временных отключениях сети, обновлении контроллеров или переключении на резервный контроллер. Варианты:
|
directory list / элементы=string добавлено в purestorage.flasharray 1.9.0 | Каталоги, к которым применяется правило квоты. |
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0 | Отключает предупреждения о небезопасных сертификатах в журналах отладки Варианты:
|
enabled boolean | Определяет, включена ли политика Варианты:
|
enforce_dictionary_check boolean добавлено в purestorage.flasharray 1.33.0 | Если значение равно true, пароль проверяется по словарю известных скомпрометированных паролей. Применяется только к паролям длиной более 6 символов. Варианты:
|
enforce_username_check boolean добавлено в purestorage.flasharray 1.33.0 | Если значение равно true, имя пользователя не может быть подстрокой пароля. Применяется только к именам пользователей длиной от 3 символов Варианты:
|
fa_url string | IPv4-адрес или имя узла для управления FlashArray. |
ignore_usage boolean добавлено в purestorage.flasharray 1.9.0 | Флаг для переопределения проверок при операциях управления квотами. Если задано значение true, использование каталога не проверяется на соответствие установленным ограничениям quota_limits. Если задано значение false, фактический объем используемых логических данных не может превышать ограничения, установленные для каталога. Это может повлиять на операции клиента. Если объем превышает квоту, операция клиента не выполняется. Варианты:
|
lockout_duration integer добавлено в purestorage.flasharray 1.33.0 | Длительность блокировки учетной записи в секундах после превышения значения max_login_attempts От 1 секунды до 90 дней (7776000 секунд) |
max_login_attempts integer добавлено в purestorage.flasharray 1.33.0 | Максимальное число неудачных попыток входа до блокировки учетной записи |
min_character_groups integer добавлено в purestorage.flasharray 1.33.0 | Минимальное число групп символов, которые должны присутствовать в пароле. |
min_characters_per_group integer добавлено в purestorage.flasharray 1.33.0 | Минимальное число символов в группе, необходимое для учета этой группы как присутствующей. Максимальное значение ограничено минимальной длиной пароля, деленной на число групп символов |
min_password_length integer добавлено в purestorage.flasharray 1.33.0 | Минимальная длина пароля пользователя |
name string / обязательный | Имя политики |
nfs_access string | Указывает управление доступом для экспорта Варианты:
|
nfs_permission string | Указывает, какие права доступа клиентов на чтение и запись разрешены для экспорта Варианты:
|
nfs_version list / элементы=string добавлено в purestorage.flasharray 1.22.0 | Версия протокола NFS, разрешенная для экспорта Варианты:
|
password_history integer добавлено в purestorage.flasharray 1.33.0 | Число паролей, которые отслеживаются для запрета повторного использования. При значении 0 история паролей не проверяется |
policy string / обязательный | Тип используемой политики Варианты:
|
quota_enforced boolean | Определяет, применяется ли квота каталога. Варианты:
|
quota_limit string добавлено в purestorage.flasharray 1.9.0 | Ограничение логического пространства общего ресурса в единицах M, G, T или P. См. примеры. Если размер не задан при создании файловой системы, ее размер будет неограниченным. Для этого параметра нельзя указать значение 0. |
quota_notifications list / элементы=string добавлено в purestorage.flasharray 1.9.0 | Получатели уведомлений при приближении использования к пределу квоты. Список получателей уведомлений задается строкой со значениями, разделенными запятыми Если получатели не указаны, они не назначаются. Варианты:
|
rename string | Новое имя политики |
rule_name string добавлено в purestorage.flasharray 1.34.0 | Имя правила квотной политики, которое требуется обновить |
security list / элементы=string добавлено в purestorage.flasharray 1.25.0 | Типы безопасности, используемые для доступа к файлам в точке монтирования. Если сервер не поддерживает запрошенный тип, операция монтирования завершится с ошибкой. Эта операция обновляет все правила указанной политики. Варианты:
|
smb_anon_allowed boolean | Указывает, разрешен ли анонимным пользователям доступ к информации Варианты:
|
smb_encrypt boolean | Указывает, должен ли удаленный клиент использовать шифрование SMB Варианты:
|
snap_at string | Указывает число часов с полуночи, по истечении которого следует создать снимок, или час с указанием AM/PM Можно задать только для правила с наименьшим значением snap_every. Нельзя задать, если значение snap_every измеряется не в днях. Можно задать не более чем для одного правила в рамках одной политики. |
snap_client_name string | Настраиваемая часть имени снимка, видимая клиенту. |
snap_every integer | Указывает интервал между снимками в минутах. Значения для всех правил должны быть кратны друг другу. Значение должно быть уникальным для каждого правила в рамках одной политики. Значение должно находиться в диапазоне от 5 до 525600. |
snap_keep_for integer | Указывает срок хранения снимков до их удаления в минутах. Не может быть меньше значения snap_every для этого правила. Значение должно быть уникальным для каждого правила в рамках одной политики. Значение должно находиться в диапазоне от 5 до 525600. |
snap_suffix string добавлено в purestorage.flasharray 1.10.0 | Суффикс имени снимка Значение суффикса можно задать только для одного правила в рамках одной политики Значение суффикса можно задать только для правила с такими же значениями ``keep_for`` и ``every`` Значение суффикса можно задать только для правила с наибольшим значением ``keep_for`` Если значение не указано, система по умолчанию создает монотонно возрастающее число. |
state string | Определяет, должна ли политика существовать. Варианты:
|
user_mapping boolean добавлено в purestorage.flasharray 1.14.0 | Определяет, включено ли сопоставление пользователей Варианты:
|
Примечания
Примечание
- Для этого модуля требуются библиотеки Python
purestorageиpy-pure-client. - Для отдельных модулей могут потребоваться дополнительные библиотеки Python.
- Если аргументы fa_url и api_token не передаются модулю напрямую, необходимо задать переменные окружения
PUREFA_URLиPUREFA_API.
Примеры
- name: Create an NFS policy with initial rule
purestorage.flasharray.purefa_policy:
name: export1
policy: nfs
nfs_access: root-squash
nfs_permission: ro
client: client1
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create an empty NFS policy with no rules
purestorage.flasharray.purefa_policy:
name: export1
policy: nfs
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create an empty snapshot policy with no rules
purestorage.flasharray.purefa_policy:
name: snap1
policy: snapshot
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create an empty snapshot policy with single directory member
purestorage.flasharray.purefa_policy:
name: snap1
policy: snapshot
directory: "foo:bar"
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Disable a policy
purestorage.flasharray.purefa_policy:
name: export1
policy: nfs
enabled: false
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Add rule to existing NFS export policy
purestorage.flasharray.purefa_policy:
name: export1
policy: nfs
nfs_access: root-squash
nfs_permission: ro
client: client2
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Add rule to existing SMB export policy
purestorage.flasharray.purefa_policy:
name: export1
policy: smb
smb_encrypt: true
smb_anon_allowed: false
client: client1
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Add non-suffix rule to existing snapshot export policy
purestorage.flasharray.purefa_policy:
name: snap1
policy: snapshot
snap_client_name: foo
snap_every: 15
snap_keep_for: 1440
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Add suffix rule to existing snapshot export policy
purestorage.flasharray.purefa_policy:
name: snap1
policy: snapshot
snap_client_name: foo
snap_suffix: bar
snap_every: 1440
snap_keep_for: 1440
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete policy rule for a client
purestorage.flasharray.purefa_policy:
name: export1
policy: nfs
client: client2
state: absent
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete policy
purestorage.flasharray.purefa_policy:
name: export1
policy: nfs
state: absent
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create directory quota policy for directory bar
purestorage.flasharray.purefa_policy:
name: foo
directory:
- "foo:root"
- "bar:bin"
policy: quota
quota_limit: 10G
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete directory quota policy foo
purestorage.flasharray.purefa_policy:
name: foo
policy: quota
state: absent
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create empty directory quota policy foo
purestorage.flasharray.purefa_policy:
name: foo
policy: quota
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Detach directory "foo:bar" from quota policy quota1
purestorage.flasharray.purefa_policy:
name: quota1
directory:
- "foo:bar"
state: absent
policy: quota
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Remove quota rule from quota policy foo
purestorage.flasharray.purefa_policy:
name: foo
policy: quota
quota_limit: 10G
state: absent
fa_url: 10.10.10.2
api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Update password police management
purestorage.flasharray.purefa_policy:
name: management
policy: password
max_login_attempts: 5
enforce_username_check: true
enforce_dictionary_check: true
min_password_length: 5
password_history: 2
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_policy_module.html