Модуль purestorage.flashblade.purefb_bucket — управление бакетами хранилища объектов в Pure Storage FlashBlade.

Примечание

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

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

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

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

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

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Этот модуль управляет бакетами хранилища объектов (S3) в Pure Storage FlashBlade.

Требования

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

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

Параметры

Параметр	Описание
account string / обязательный	Учетная запись хранилища объектов для бакета.
api_token string	Токен API FlashBlade для пользователя с правами администратора.
block_new_public_policies boolean добавлено в purestorage.flashblade 1.15.0	Если установлено значение true, добавление политик бакета, предоставляющих общедоступный доступ к бакету, запрещено. Варианты: `false` `true`
block_public_access boolean добавлено в purestorage.flashblade 1.15.0	Если установлено значение true, доступ к бакету с общедоступной политикой ограничивается аутентифицированными пользователями учетной записи, которой принадлежит этот бакет. Варианты: `false` `true`
context string добавлено в purestorage.flashblade 1.22.0	Имя участника флота, для которого выполняется операция. Для этого массив, получающий запрос, должен входить во флот, а участник, указанный в контексте, должен входить в тот же флот. По умолчанию: `""`
default_retention string добавлено в purestorage.flashblade 1.12.0	Срок хранения в днях, используемый для установки блокировок на новые объекты, если клиент S3 не указал его самостоятельно. Допустимые значения: от 1 до 365000. Чтобы очистить значение, укажите пустую строку («»).
disable_warnings boolean добавлено в purestorage.flashblade 1.18.0	Отключить предупреждения о небезопасных сертификатах. Варианты: `false` ← (по умолчанию) `true`
eradicate boolean	Определяет, следует ли безвозвратно удалить бакет или оставить его в корзине после удаления. Варианты: `false` ← (по умолчанию) `true`
eradication_delay integer добавлено в purestorage.flashblade 1.17.0	Минимальная задержка безвозвратного удаления в днях. Уничтоженные бакеты автоматически удаляются безвозвратно по истечении этого срока, если автоматическое удаление не отложено другими параметрами конфигурации. Допустимые значения — целое число дней от 1 до 30. Значение по умолчанию — 1.
eradication_mode string добавлено в purestorage.flashblade 1.17.0	Режим безвозвратного удаления бакета. Варианты: `"permission-based"` `"retention-based"`
fb_url string	IP-адрес или имя хоста для управления FlashBlade.
freeze_locked_objects boolean добавлено в purestorage.flashblade 1.12.0	Если установлено значение true, заблокированный объект будет доступен только для чтения, а в результате изменений нельзя будет создавать новые версии объекта. После включения эту функцию можно отключить только обратившись в службу технической поддержки Pure. Варианты: `false` ← (по умолчанию) `true`
hard_limit boolean добавлено в purestorage.flashblade 1.12.0	Определяет, применяется ли значение quota. Если значение не указано, будет использоваться значение по умолчанию для учетной записи хранилища объектов. Варианты: `false` `true`
manual_eradication boolean добавлено в purestorage.flashblade 1.17.0	Состояние ручного безвозвратного удаления бакета. Если значение false, безвозвратно удалить бакет после уничтожения нельзя, если только он не пуст. Если значение true, бакет можно безвозвратно удалить. Варианты: `false` `true`
mode string добавлено в purestorage.flashblade 1.10.0	Тип создаваемого бакета. Также называется режимом VSO. Тип multi-site-writable можно использовать только после включения этой функции службой технической поддержки Pure. Варианты: `"classic"` `"multi-site-writable"`
name string / обязательный	Имя бакета.
object_lock_enabled boolean добавлено в purestorage.flashblade 1.12.0	Если установлено значение true, можно использовать API S3, связанные с блокировкой объектов. Варианты: `false` ← (по умолчанию) `true`
quota string добавлено в purestorage.flashblade 1.12.0	Действующее ограничение размера, применяемое к бакету. Квота пользователя в байтах (B), килобайтах (K), мегабайтах (M), гигабайтах (G), терабайтах (T) или петабайтах (P). Значение должно находиться в диапазоне от 1 байта до 9,22 эксабайта. Значение 0 снимает ограничение на размер бакета.
retention_lock string добавлено в purestorage.flashblade 1.12.0	Установить уровень блокировки хранения для бакета. После установки значения ratcheted понизить его можно только обратившись в службу технической поддержки Pure. Варианты: `"ratcheted"` `"unlocked"` ← (по умолчанию)
retention_mode string добавлено в purestorage.flashblade 1.12.0	Режим хранения, используемый для установки блокировок на новые объекты, если клиент S3 не указал его самостоятельно. Режим safemode доступен, если включена глобальная конфигурация Per-Bucket Safemode. Чтобы очистить значение, укажите пустую строку («»). После установки значения compliance изменить его можно только обратившись в службу технической поддержки Pure. Варианты: `"compliance"` `"governance"` `"safemode"` `""`
state string	Создать, удалить или изменить бакет. Варианты: `"present"` ← (по умолчанию) `"absent"`
versioning string	Состояние версионирования бакета S3. Варианты: `"enabled"` `"suspended"` `"absent"` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Create new bucket named foo in account bar
  purestorage.flashblade.purefb_bucket:
    name: foo
    quota: 10G
    hard_limit: false
    account: bar
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

- name: Update bucket foo in account bar with new quota
  purestorage.flashblade.purefb_bucket:
    name: foo
    quota: 500B
    hard_limit: true
    account: bar
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

- name: Remove quota limits from bucket named foo in account bar
  purestorage.flashblade.purefb_bucket:
    name: foo
    quota: 0
    account: bar
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

- name: Delete bucket named foo in account bar
  purestorage.flashblade.purefb_bucket:
    name: foo
    account: bar
    state: absent
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

- name: Change bucket versioning state
  purestorage.flashblade.purefb_bucket:
    name: foo
    account: bar
    versioning: enabled
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

- name: Recover deleted bucket named foo in account bar
  purestorage.flashblade.purefb_bucket:
    name: foo
    account: bar
    state: present
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

- name: Eradicate bucket named foo in account bar
  purestorage.flashblade.purefb_bucket:
    name: foo
    account: bar
    state: absent
    eradicate: true
    fb_url: 10.10.10.2
    api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641

Авторы

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