purestorage.flashblade.purefb_bucket 模块 – 管理 Pure Storage FlashBlade 上的对象存储桶。

注意

此模块是 purestorage.flashblade 集合 (版本 1.19.1) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装它，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install purestorage.flashblade。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定： purestorage.flashblade.purefb_bucket。

purestorage.flashblade 1.0.0 中的新增功能

概要

  • 此模块管理 Pure Storage FlashBlade 上的对象存储 (s3) 存储桶。

要求

执行此模块的主机需要以下要求。

  • python >= 3.9

  • py-pure-client

  • purity_fb >= 1.12.2

  • netaddr

  • datetime

  • pytz

  • distro

  • pycountry

  • urllib3

参数

参数

注释

account

字符串 / 必需

存储桶的对象存储帐户。

api_token

字符串

具有管理员权限用户的 FlashBlade API 令牌。

block_new_public_policies

布尔值

在 purestorage.flashblade 1.15.0 中添加

如果设置为 true，则不允许添加授予存储桶公共访问权限的存储桶策略。

选项

  • false

  • true

block_public_access

布尔值

在 purestorage.flashblade 1.15.0 中添加

如果设置为 true，则对具有公共策略的存储桶的访问将仅限于属于该存储桶的帐户中的已认证用户。

选项

  • false

  • true

default_retention

字符串

在 purestorage.flashblade 1.12.0 中添加

保留期限（以天为单位），用于在 S3 客户端未指定任何保留期限的情况下对新对象应用锁定。

有效值为 1 到 365000 之间的整数。

使用“”清除

disable_warnings

布尔值

在 purestorage.flashblade 1.18.0 中添加

禁用不安全证书警告

选项

  • false ← (默认)

  • true

eradicate

布尔值

定义在删除时是否根除存储桶或将其保留在回收站中。

选项

  • false ← (默认)

  • true

eradication_delay

整数

在 purestorage.flashblade 1.17.0 中添加

以天为单位的最小根除延迟。除非由于其他配置值导致自动根除延迟，否则在延迟时间过去后会自动根除已销毁的存储桶。

有效值为 1 到 30 之间的整数天数。默认为 1。

eradication_mode

字符串

在 purestorage.flashblade 1.17.0 中添加

存储桶的根除模式。

选项

  • "permission-based"

  • "retention-based"

fb_url

字符串

FlashBlade 管理 IP 地址或主机名。

freeze_locked_objects

布尔值

在 purestorage.flashblade 1.12.0 中添加

如果设置为 true，则锁定对象将为只读，并且由于修改而无法创建对象的任何新版本。

启用后，只能通过联系 Pure 技术支持来禁用。

选项

  • false ← (默认)

  • true

hard_limit

布尔值

在 purestorage.flashblade 1.12.0 中添加

是否强制执行 *quota* 值。

如果未提供，则将使用对象存储帐户的默认值。

选项

  • false

  • true

manual_eradication

布尔值

在 purestorage.flashblade 1.17.0 中添加

存储桶的手动根除状态。如果为 false，则销毁存储桶后无法根除它，除非它为空。如果为 true，则可以根除存储桶。

选项

  • false

  • true

mode

字符串

在 purestorage.flashblade 1.10.0 中添加

要创建的存储桶类型。也称为 VSO 模式。

需要 Purity//FB 3.3.3 或更高版本。

只有在 Pure 技术支持启用该功能后才能使用 *multi-site-writable* 类型。

选项

  • "classic"

  • "multi-site-writable"

name

字符串 / 必需

存储桶名称。

object_lock_enabled

布尔值

在 purestorage.flashblade 1.12.0 中添加

如果设置为 true，则可以使用与对象锁定相关的 S3 API。

选项

  • false ← (默认)

  • true

quota

字符串

在 purestorage.flashblade 1.12.0 中添加

应用于存储桶大小的有效配额限制。

以 B、K、M、G、T 或 P 为单位的用户字节配额。

范围必须在 1 字节到 9.22 艾字节之间。

设置为 0 将允许存储桶大小无限制。

retention_lock

字符串

在 purestorage.flashblade 1.12.0 中添加

设置存储桶的保留锁定级别。

一旦设置为 *ratcheted*，只能由 Pure 技术支持降低。

选项

  • "ratcheted"

  • "unlocked" ← (默认)

retention_mode

字符串

在 purestorage.flashblade 1.12.0 中添加

在 S3 客户端未指定任何保留期限的情况下，用于对新对象应用锁定的保留模式。

如果启用了全局每个存储桶安全模式配置，则可以使用 *safemode*。

使用“”清除

一旦设置为 *compliance*，只能通过联系 Pure 技术支持来更改。

选项

  • "compliance"

  • "governance"

  • "safemode"

  • ""

state

字符串

创建、删除或修改存储桶。

选项

  • "present" ← (默认)

  • "absent"

versioning

字符串

S3 存储桶版本控制的状态。

选项

  • "enabled"

  • "suspended"

  • "absent" ← (默认)

注释

注意

  • 此模块需要 purity_fb Python 库。

  • 如果未直接将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

作者

  • Pure Storage Ansible团队 (@sdodsley)