purestorage.flasharray.purefa_vg 模块 – 管理 Pure Storage FlashArrays 上的卷组

注意

此模块是 purestorage.flasharray 集合（版本 1.32.0）的一部分。

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

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

要在 playbook 中使用它，请指定： purestorage.flasharray.purefa_vg。

purestorage.flasharray 1.0.0 中的新增功能

概要 

在 Pure Storage FlashArrays 上创建、删除或修改卷组。

要求 

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

python >= 3.3
purestorage >= 1.19
py-pure-client >= 1.26.0
netaddr
requests
pycountry
urllib3

参数 

参数	注释
api_token 字符串	具有管理员权限用户的 FlashArray API 令牌。
bw_qos 字符串	卷组的带宽限制，单位为 M 或 G。M 将设置 MB/s，G 将设置 GB/s。要清除现有的 QoS 设置，请使用 0（零）
count 整数	在多个卷组创建中要创建的卷组数量仅在 Purity//FA v6.0.0 及更高版本中支持
digits 整数	用于多个卷组计数的位数。这将在必要时用零填充索引号仅在 Purity//FA v6.0.0 及更高版本中支持范围在 1 到 10 之间默认值： `1`
disable_warnings 布尔值在 purestorage.flasharray 1.29.0 中添加	在调试日志中禁用不安全证书警告选择 `false` ←（默认） `true`
eradicate 布尔值	定义是否在删除时彻底删除卷组并将其留在垃圾箱中。选择 `false` ←（默认） `true`
fa_url 字符串	FlashArray 管理 IPv4 地址或主机名。
iops_qos 字符串	卷组的 IOPs 限制 - 使用值或 K 或 M，K 将表示 1000，M 将表示 1000000。要清除现有的 IOPs 设置，请使用 0（零）
name 字符串 / 必需	卷组的名称。 Purity//FA 6.0.0 开始提供多卷组支持 *注意* 手动删除或彻底删除使用多卷组创建的单个卷组将导致幂等性失败多卷组支持仅适用于卷组创建
priority_operator 字符串在 purestorage.flasharray 1.13.0 中添加	DMM 优先级调整运算符选择 `"+"` ←（默认） `"-"`
priority_value 整数在 purestorage.flasharray 1.13.0 中添加	DMM 优先级调整值选择 `0` ←（默认） `10`
rename 字符串在 purestorage.flasharray 1.22.0 中添加	将指定的卷组重命名为的值
start 整数	启动多个卷组创建索引的数字仅在 Purity//FA v6.0.0 及更高版本中支持默认值： `0`
state 字符串	定义卷组是否应该存在。选择 `"absent"` `"present"` ←（默认）
suffix 字符串	如果需要，用于多个卷组创建的后缀字符串卷组名称将形如 <name>#I<suffix>，其中 # 是卷索引的占位符。请参阅相关说明仅在 Purity//FA v6.0.0 及更高版本中支持

注意 

注意

此模块需要 purestorage 和 py-pure-client Python 库
特定模块可能需要额外的 Python 库。
如果未将 fa_url 和 api_token 参数直接传递给模块，则必须设置 PUREFA_URL 和 PUREFA_API 环境变量

示例 

- name: Create new volune group
  purestorage.flasharray.purefa_vg:
    name: foo
    bw_qos: 50M
    iops_qos: 100
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Create 10 volune groups of pattern foo#bar with QoS
  purestorage.flasharray.purefa_vg:
    name: foo
    suffix: bar
    count: 10
    start: 10
    digits: 3
    bw_qos: 50M
    iops_qos: 100
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update volune group QoS limits
  purestorage.flasharray.purefa_vg:
    name: foo
    bw_qos: 0
    iops_qos: 5555
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Update volune group DMM Priority Adjustment (Purity//FA 6.1.2+)
  purestorage.flasharray.purefa_vg:
    name: foo
    priority_operator: '-'
    priority_value: 10
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Destroy volume group
  purestorage.flasharray.purefa_vg:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Recover deleted volune group - no changes are made to the volume group on recovery
  purestorage.flasharray.purefa_vg:
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Destroy and Eradicate volume group
  purestorage.flasharray.purefa_vg:
    name: foo
    eradicate: true
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592
    state: absent

- name: Rename volume group foo to bar
  purestorage.flasharray.purefa_vg:
    name: foo
    rename: bar
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

作者

Pure Storage Ansible 团队 (@sdodsley)