Spec-Zone.ru › Ansible

Модуль 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

Варианты:

  • false ← (по умолчанию)
  • true

anongid

string

добавлено в purestorage.flasharray 1.14.0

Идентификатор, которому будут сопоставлены пользователи, чей GID затрагивается параметром access в режимах root-squash или all-squash.

Игнорируется, если включен параметр user_mapping.

Для очистки укажите “”.

По умолчанию: "65534"

anonuid

string

добавлено в purestorage.flasharray 1.14.0

Идентификатор, которому будут сопоставлены пользователи, чей UID затрагивается параметром access в режимах root-squash или all-squash.

Для очистки укажите “”.

По умолчанию: "65534"

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

Определяет, включена ли непрерывная доступность для политики.

Если для политики включена непрерывная доступность, файловые ресурсы остаются доступными даже при сбоях, которые обычно приводят к перебоям, например при временных отключениях сети, обновлении контроллеров или переключении на резервный контроллер.

Варианты:

  • false ← (по умолчанию)
  • true

directory

list / элементы=string

добавлено в purestorage.flasharray 1.9.0

Каталоги, к которым применяется правило квоты.

disable_warnings

boolean

добавлено в purestorage.flasharray 1.29.0

Отключает предупреждения о небезопасных сертификатах в журналах отладки

Варианты:

  • false ← (по умолчанию)
  • true

enabled

boolean

Определяет, включена ли политика

Варианты:

  • false
  • true ← (по умолчанию)

enforce_dictionary_check

boolean

добавлено в purestorage.flasharray 1.33.0

Если значение равно true, пароль проверяется по словарю известных скомпрометированных паролей.

Применяется только к паролям длиной более 6 символов.

Варианты:

  • false
  • true

enforce_username_check

boolean

добавлено в purestorage.flasharray 1.33.0

Если значение равно true, имя пользователя не может быть подстрокой пароля.

Применяется только к именам пользователей длиной от 3 символов

Варианты:

  • false
  • true

fa_url

string

IPv4-адрес или имя узла для управления FlashArray.

ignore_usage

boolean

добавлено в purestorage.flasharray 1.9.0

Флаг для переопределения проверок при операциях управления квотами.

Если задано значение true, использование каталога не проверяется на соответствие установленным ограничениям quota_limits.

Если задано значение false, фактический объем используемых логических данных не может превышать ограничения, установленные для каталога.

Это может повлиять на операции клиента.

Если объем превышает квоту, операция клиента не выполняется.

Варианты:

  • false ← (по умолчанию)
  • true

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

Указывает управление доступом для экспорта

Варианты:

  • "root-squash"
  • "no-root-squash" ← (по умолчанию)
  • "all-squash"

nfs_permission

string

Указывает, какие права доступа клиентов на чтение и запись разрешены для экспорта

Варианты:

  • "ro"
  • "rw" ← (по умолчанию)

nfs_version

list / элементы=string

добавлено в purestorage.flasharray 1.22.0

Версия протокола NFS, разрешенная для экспорта

Варианты:

  • "nfsv3"
  • "nfsv4"

password_history

integer

добавлено в purestorage.flasharray 1.33.0

Число паролей, которые отслеживаются для запрета повторного использования.

При значении 0 история паролей не проверяется

policy

string / обязательный

Тип используемой политики

Варианты:

  • "nfs"
  • "smb"
  • "snapshot"
  • "quota"
  • "autodir"
  • "password"

quota_enforced

boolean

Определяет, применяется ли квота каталога.

Варианты:

  • false
  • true ← (по умолчанию)

quota_limit

string

добавлено в purestorage.flasharray 1.9.0

Ограничение логического пространства общего ресурса в единицах M, G, T или P. См. примеры.

Если размер не задан при создании файловой системы, ее размер будет неограниченным.

Для этого параметра нельзя указать значение 0.

quota_notifications

list / элементы=string

добавлено в purestorage.flasharray 1.9.0

Получатели уведомлений при приближении использования к пределу квоты.

Список получателей уведомлений задается строкой со значениями, разделенными запятыми

Если получатели не указаны, они не назначаются.

Варианты:

  • "user"
  • "group"
  • "none"

rename

string

Новое имя политики

rule_name

string

добавлено в purestorage.flasharray 1.34.0

Имя правила квотной политики, которое требуется обновить

security

list / элементы=string

добавлено в purestorage.flasharray 1.25.0

Типы безопасности, используемые для доступа к файлам в точке монтирования.

Если сервер не поддерживает запрошенный тип, операция монтирования завершится с ошибкой.

Эта операция обновляет все правила указанной политики.

Варианты:

  • "auth_sys"
  • "krb5"
  • "krb5i"
  • "krb5p"

smb_anon_allowed

boolean

Указывает, разрешен ли анонимным пользователям доступ к информации

Варианты:

  • false ← (по умолчанию)
  • true

smb_encrypt

boolean

Указывает, должен ли удаленный клиент использовать шифрование SMB

Варианты:

  • false ← (по умолчанию)
  • true

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

Определяет, должна ли политика существовать.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

user_mapping

boolean

добавлено в purestorage.flasharray 1.14.0

Определяет, включено ли сопоставление пользователей

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Для этого модуля требуются библиотеки 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

Авторы

  • Команда 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_policy_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API