Модуль purestorage.flashblade.purefb_policy — управление политиками FlashBlade

Примечание

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

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

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

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

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

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

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

Управление политиками для файловых систем, связей репликации файлов и доступа к хранилищу объектов.
Чтобы обновить существующее правило политики снимков, сначала необходимо удалить исходное правило, а затем добавить новое взамен него. Механизм Purity best-fit постарается обеспечить восстановление всех необходимых снимков, удалённых при удалении первого правила, если новое правило будет добавлено до истечения срока хранения снимков перед удалением (обычно 24 часа).

Требования

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

python >= 3.9
py-pure-client
netaddr
datetime
pytz
distro
pycountry
urllib3

Параметры

Параметр	Комментарии
access string добавлено в purestorage.flashblade 1.9.0	Задает управление доступом для правила политики экспорта Варианты: `"root-squash"` ← (по умолчанию) `"all-squash"` `"no-squash"`
account string добавлено в purestorage.flashblade 1.9.0	Имя учетной записи Object Store, к которой применяется политика. Особый случай Для системных политик S3 используется pure policy
actions list / elements=string добавлено в purestorage.flashblade 1.9.0	Список разрешений для предоставления. Правила системных политик нельзя удалять или изменять Варианты: `"s3:*"` `"s3:AbortMultipartUpload"` `"s3:BypassGovernanceRetention"` `"s3:CreateBucket"` `"s3:DeleteBucket"` `"s3:DeleteObject"` `"s3:DeleteObjectVersion"` `"s3:ExtendSafemodeRetentionPeriod"` `"s3:GetBucketAcl"` `"s3:GetBucketLocation"` `"s3:GetBucketVersioning"` `"s3:GetLifecycleConfiguration"` `"s3:GetObject"` `"s3:GetObjectAcl"` `"s3:GetObjectLegalHold"` `"s3:GetObjectLockConfiguration"` `"s3:GetObjectRetention"` `"s3:GetObjectTagging"` `"s3:GetObjectVersion"` `"s3:GetObjectVersionTagging"` `"s3:ListAllMyBuckets"` `"s3:ListBucket"` `"s3:ListBucketMultipartUploads"` `"s3:ListBucketVersions"` `"s3:ListMultipartUploadParts"` `"s3:PutBucketVersioning"` `"s3:PutLifecycleConfiguration"` `"s3:PutObject"` `"s3:PutObjectLegalHold"` `"s3:PutObjectLockConfiguration"` `"s3:PutObjectRetention"` `"s3:ResolveSafemodeConflicts"`
anongid string добавлено в purestorage.flashblade 1.9.0	Для пользователей, чей GID затрагивается параметром access со значением `root_squash` или `all_squash`, GID будет преобразован в anongid. По умолчанию значение anongid равно null, что означает 65534. Чтобы очистить значение, используйте «».
anonuid string добавлено в purestorage.flashblade 1.9.0	Для пользователей, чей UID затрагивается параметром access со значением `root_squash` или `all_squash`, UID будет преобразован в anonuid. По умолчанию значение равно null, что означает 65534. Чтобы очистить значение, используйте «».
api_token string	Токен API FlashBlade для пользователя с привилегиями администратора.
at string	Укажите время в 12-часовом формате AM/PM, например 11AM
atime boolean добавлено в purestorage.flashblade 1.9.0	После операции чтения время доступа к inode обновляется только при выполнении одного из следующих условий: предыдущее время доступа меньше времени изменения inode, предыдущее время доступа меньше времени смены состояния inode или предыдущее время доступа было более 24 часов назад. Если задано значение false, обновление времени доступа к inode после операций чтения отключается. Варианты: `false` `true` ← (по умолчанию)
before_rule integer добавлено в purestorage.flashblade 1.9.0	Индекс клиентского правила, перед которым нужно вставить или переместить клиентское правило.
change string добавлено в purestorage.flashblade 1.12.0	Состояние разрешения на изменение для субъектов общего ресурса SMB. Значение «» очистит текущую настройку Варианты: `"allow"` `"deny"` `""`
client string добавлено в purestorage.flashblade 1.9.0	Указывает клиентов, которым разрешен доступ к экспорту. Допустимые форматы: отдельный IP-адрес, подсеть в нотации CIDR, сетевая группа или анонимный доступ (*).
context string добавлено в purestorage.flashblade 1.22.0	Имя участника флота, на котором выполняется операция. Для этого массив, получающий запрос, должен быть участником флота, а имя контекста должно принадлежать участнику того же флота. По умолчанию: `""`
default_retention string добавлено в purestorage.flashblade 1.19.0	Срок хранения, используемый при фиксации файлов в состоянии WORM. Применяется, если время доступа не указано или меньше текущего времени сервера. Должен находиться в диапазоне между значениями min_retention и max_retention. Допустимые значения задаются в неделях (w), днях (d), часах (h), минутах (m) и секундах (s).
desc string добавлено в purestorage.flashblade 1.14.0	Описание политики Object Store, которое можно указать при ее создании. Для существующей политики изменить описание нельзя. По умолчанию: `""`
destroy_snapshots boolean добавлено в purestorage.flashblade 1.11.0	Чтобы изменить политику таким образом, что локальные или удаленные снимки будут уничтожены, этому параметру необходимо задать значение true. Варианты: `false` ← (по умолчанию) `true`
disable_warnings boolean добавлено в purestorage.flashblade 1.18.0	Отключить предупреждения о небезопасном сертификате Варианты: `false` ← (по умолчанию) `true`
effect string добавлено в purestorage.flashblade 1.9.0	Разрешать запросы S3, соответствующие всем выбранным элементам actions. Правила суммируются. Варианты: `"allow"` ← (по умолчанию) `"deny"`
enabled boolean	Состояние политики Варианты: `false` `true` ← (по умолчанию)
every integer	Интервал между снимками в секундах Допустимый диапазон: 300–31536000 (от 5 мин до 365 дней)
fb_url string	IP-адрес или имя хоста для управления FlashBlade.
fileid_32bit boolean добавлено в purestorage.flashblade 1.9.0	Указывает, имеет ли идентификатор файла разрядность 32 бита. Варианты: `false` ← (по умолчанию) `true`
filesystem list / elements=string	Список файловых систем, добавляемых в политику при ее создании Для изменения участников политики используйте модуль purestorage.flashblade.purefb_fs
force_delete boolean добавлено в purestorage.flashblade 1.9.0	Принудительно удалить политику доступа Object Store, если к ней прикреплены пользователи. ПРЕДУПРЕЖДЕНИЕ: это может привести к нежелательным побочным эффектам. Системные политики нельзя удалять Варианты: `false` ← (по умолчанию) `true`
full_control string добавлено в purestorage.flashblade 1.12.0	Состояние разрешения на полный контроль для субъектов общего ресурса SMB. Значение «» очистит текущую настройку Варианты: `"allow"` `"deny"` `""`
ignore_enforcement boolean добавлено в purestorage.flashblade 1.9.0	Некоторые сочетания действий и других элементов правила автоматически игнорируются, если указаны вместе в одном правиле. Если задано значение true, операции, пытающиеся установить такие сочетания, завершатся с ошибкой. Если задано значение false, такие операции будут разрешены. Варианты: `false` `true` ← (по умолчанию)
interfaces list / elements=string добавлено в purestorage.flashblade 1.17.0	Указывает, к каким интерфейсам продукта применяется правило сетевой политики доступа, разрешающее или запрещающее доступ. Варианты: `"management-ssh"` `"management-rest-api"` `"management-web-ui"` `"snmp"` `"local-network-superuser-password-access"`
keep_for integer	Срок хранения снимков Допустимый диапазон: 300–31536000 (от 5 мин до 365 дней) Значение не должно быть меньше every
max_retention string добавлено в purestorage.flashblade 1.19.0	Максимальный срок хранения файловой системы WORM. От 1 секунды до 100 лет. Не может быть меньше значения min_retention. Допустимые значения задаются в неделях (w), днях (d), часах (h), минутах (m) и секундах (s).
min_retention string добавлено в purestorage.flashblade 1.19.0	Минимальный срок хранения файловой системы WORM. От 1 секунды до 100 лет. Не может быть больше значения max_retention. Допустимые значения задаются в неделях (w), днях (d), часах (h), минутах (m) и секундах (s).
name string	Имя политики
object_resources list / elements=string добавлено в purestorage.flashblade 1.9.0	Список имен бакетов и путей к объектам; для указания объектов в бакете используется подстановочный символ (), например: bucket1, bucket1/, bucket2, bucket2/*. Правила системных политик нельзя удалять или изменять
permission string добавлено в purestorage.flashblade 1.9.0	Указывает, какие разрешения на чтение и запись для доступа клиента к экспорту разрешены. Варианты: `"rw"` `"ro"` ← (по умолчанию)
policy_type string добавлено в purestorage.flashblade 1.9.0	Тип политики Варианты: `"snapshot"` ← (по умолчанию) `"access"` `"nfs"` `"smb_share"` `"smb_client"` `"network"` `"worm"`
principal string добавлено в purestorage.flashblade 1.12.0	Пользователь или группа, являющиеся субъектом этого правила, и их домен
read string добавлено в purestorage.flashblade 1.12.0	Состояние разрешения на чтение для субъектов общего ресурса SMB. Значение «» очистит текущую настройку Варианты: `"allow"` `"deny"` `""`
rename string добавлено в purestorage.flashblade 1.10.0	Новое имя политики Применяется только к политикам NFS и SMB
replica_link list / elements=string	Список связей репликации файловых систем, добавляемых в политику при ее создании Для изменения участников политики используйте модуль purestorage.flashblade.purefb_fs_replica
retention_lock string добавлено в purestorage.flashblade 1.19.0	Состояние атрибутов политики после ее создания. Если задано значение locked, изменять значения атрибутов политики нельзя. Если задано значение locked, значения атрибутов политики можно изменять. Переход из состояния unlocked в locked разрешен, но для перехода из locked в unlocked потребуется помощь службы технической поддержки Pure Storage. Варианты: `"locked"` `"unlocked"`
rule string добавлено в purestorage.flashblade 1.9.0	Имя правила политики доступа Object Store Правила системных политик нельзя удалять или изменять
s3_delimiters list / elements=string добавлено в purestorage.flashblade 1.9.0	Список символов-разделителей, разрешенных в запросах на получение списка объектов. Предоставляет разрешение на просмотр «имен папок» (префиксов, заканчивающихся разделителем) вместо ключей объектов. Правила системных политик нельзя удалять или изменять
s3_prefixes list / elements=string добавлено в purestorage.flashblade 1.9.0	Список «папок» (префиксов ключей объектов), для которых можно запрашивать списки объектов. Правила системных политик нельзя удалять или изменять
secure boolean добавлено в purestorage.flashblade 1.9.0	Если задано значение true, доступ NFS для клиентских подключений с незарезервированных портов запрещается. Если задано значение false, доступ NFS для клиентских подключений с незарезервированных портов разрешается. Применяется к NFSv3, NFSv4.1 и вспомогательным протоколам MOUNT и NLM. Варианты: `false` ← (по умолчанию) `true`

security list / elements=string добавлено в purestorage.flashblade 1.9.0	Механизмы безопасности, используемые для доступа к файлам в этой точке монтирования. Если сервер не поддерживает запрошенный механизм, операция монтирования завершится ошибкой. sys доверяет клиенту указывать идентификаторы пользователей. krb обеспечивает криптографическое подтверждение идентификатора пользователя в каждом запросе RPC. krb5i добавляет к krb5 проверку целостности, чтобы гарантировать, что данные не были изменены. krb5p добавляет к krb5 проверку целостности и шифрование. Варианты: `"sys"` ← (по умолчанию) `"krb5"` `"krb5i"` `"krb5p"` По умолчанию: `["sys"]`
smb_encryption string добавлено в purestorage.flashblade 1.12.0	Состояние шифрования SMB в правиле клиентской политики Варианты: `"disabled"` `"optional"` ← (по умолчанию) `"required"`
source_ips list / elements=string добавлено в purestorage.flashblade 1.9.0	Список IP-адресов и подсетей, с которых это правило должно разрешать запросы; например: 10.20.30.40, 10.20.30.0/24, 2001:DB8:1234:5678::/64. Общесистемные правила политик нельзя удалять или изменять
state string	Создать или удалить политику. Копирование применимо только к правилам политик доступа к Object Store Варианты: `"absent"` `"present"` ← (по умолчанию) `"copy"`
target string добавлено в purestorage.flashblade 1.9.0	Имя политики, в которую копируется правило
target_rule string добавлено в purestorage.flashblade 1.9.0	Имя правила, в которое копируется существующее правило. Если не задано, используется имя существующего правила.
timezone string	Часовой пояс, используемый для параметра at Если он не указан, модуль попытается получить текущий местный часовой пояс с сервера
user string добавлено в purestorage.flashblade 1.9.0	Пользователь в account, которому предоставлена политика.

Примечания

Примечание

Необходимо задать переменные окружения PUREFB_URL и PUREFB_API, если аргументы fb_url и api_token не передаются непосредственно модулю

Примеры

- name: Create a simple snapshot policy with no rules
  purestorage.flashblade.purefb_policy:
    name: test_policy
    policy_type: snapshot
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create a snapshot policy and connect to existing filesystems and filesystem replica links
  purestorage.flashblade.purefb_policy:
    name: test_policy_with_members
    policy_type: snapshot
    filesystem:
    - fs1
    - fs2
    replica_link:
    - rl1
    - rl2
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create a snapshot policy with rules
  purestorage.flashblade.purefb_policy:
    name: test_policy2
    policy_type: snapshot
    at: 11AM
    keep_for: 86400
    every: 86400
    timezone: Asia/Shanghai
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete filesystem foo from snapshot policy
  purestorage.flashblade.purefb_policy:
    name: test_policy
    policy_type: snapshot
    filesystem: foo
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete a snapshot policy
  purestorage.flashblade.purefb_policy:
    name: test_policy
    policy_type: snapshot
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create an empty object store access policy
  purestorage.flashblade.purefb_policy:
    name: test_os_policy
    account: test
    policy_type: access
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create an empty object store access policy and assign user
  purestorage.flashblade.purefb_policy:
    name: test_os_policy
    account: test
    policy_type: access
    user: fred
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create a object store access policy with simple rule
  purestorage.flashblade.purefb_policy:
    name: test_os_policy_rule
    policy_type: access
    account: test
    rule: rule1
    actions: "s3:*"
    object_resources: "*"
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create an empty SMB client policy
  purestorage.flashblade.purefb_policy:
    name: test_smb_client
    policy_type: smb_client
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create an SMB client policy with a client rule
  purestorage.flashblade.purefb_policy:
    name: test_smb_client
    policy_type: smb_client
    client: "10.0.1.0/24"
    permission: rw
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create an empty NFS export policy
  purestorage.flashblade.purefb_policy:
    name: test_nfs_export
    policy_type: nfs
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create an NFS export policy with a client rule
  purestorage.flashblade.purefb_policy:
    name: test_nfs_export
    policy_type: nfs
    atime: true
    client: "10.0.1.0/24"
    secure: true
    security: [sys, krb5]
    permission: rw
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create a new rule for an existing NFS export policy
  purestorage.flashblade.purefb_policy:
    name: test_nfs_export
    policy_type: nfs
    atime: true
    client: "10.0.2.0/24"
    security: sys
    permission: ro
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete a client rule from an NFS export policy
  purestorage.flashblade.purefb_policy:
    name: test_nfs_export
    client: "10.0.1.0/24"
    policy_type: nfs
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete an NFS export policy and all associated rules
  purestorage.flashblade.purefb_policy:
    name: test_nfs_export
    state: absent
    policy_type: nfs
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete a rule from an object store access policy
  purestorage.flashblade.purefb_policy:
    name: test_os_policy_rule
    account: test
    policy_type: access
    rule: rule1
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete a user from an object store access policy
  purestorage.flashblade.purefb_policy:
    name: test_os_policy_rule
    account: test
    user: fred
    policy_type: access
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete an object store access policy with attached users (USE WITH CAUTION)
  purestorage.flashblade.purefb_policy:
    name: test_os_policy_rule
    account: test
    policy_type: access
    force_delete: true
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Delete an object store access policy with no attached users
  purestorage.flashblade.purefb_policy:
    name: test_os_policy_rule
    account: test
    policy_type: access
    state: absent
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Copy an object store access policy rule to another exisitng policy
  purestorage.flashblade.purefb_policy:
    name: test_os_policy_rule
    policy_type: access
    account: test
    target: "account2/anotherpolicy"
    target_rule: new_rule1
    state: copy
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Rename an NFS Export Policy
  purestorage.flashblade.purefb_policy:
    name: old_name
    policy_type: nfs
    rename: new_name
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6
- name: Create a WORM Data Policy
  purestorage.flashblade.purefb_policy:
    name: worm1
    policy_type: worm
    default_retention: 5d
    min_rentetion: 20h
    max_retention: 1y
    fb_url: 10.10.10.2
    api_token: T-9f276a18-50ab-446e-8a0c-666a3529a1b6

Авторы

Команда 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/flashblade/purefb_policy_module.html