ansible / ansible.builtin / v2.9.23 / module / purefa_pg Manage protection groups on Pure Storage FlashArrays | "added in version" 2.4 of ansible.builtin" Authors: Pure Storage Ansible Team (@sdodsley) <pure-ansible-team@purestorage.com> preview | supported by communityansible.builtin.purefa_pg (v2.9.23) — module
pip
Install with pip install ansible==2.9.23
Create, delete or modify protection groups on Pure Storage FlashArrays.
If a protection group exists and you try to add non-valid types, eg. a host to a volume protection group the module will ignore the invalid types.
Protection Groups on Offload targets are supported.
- name: Create new local protection group purefa_pg: pgroup: foo fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create new replicated protection group purefa_pg: pgroup: foo target: - arrayb - arrayc fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create new replicated protection group to offload target and remote array purefa_pg: pgroup: foo target: - offload - arrayc fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create new protection group with snapshots disabled purefa_pg: pgroup: foo enabled: false fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Delete protection group purefa_pg: pgroup: foo eradicate: true fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592 state: absent
- name: Eradicate protection group foo on offload target where source array is arrayA purefa_pg: pgroup: "arrayA:foo" target: offload eradicate: true fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592 state: absent
- name: Create protection group for hostgroups purefa_pg: pgroup: bar hostgroup: - hg1 - hg2 fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create protection group for hosts purefa_pg: pgroup: bar host: - host1 - host2 fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
- name: Create replicated protection group for volumes purefa_pg: pgroup: bar volume: - vol1 - vol2 target: arrayb fa_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592
host: description: - List of existing hosts to add to protection group. type: list state: choices: - absent - present default: present description: - Define whether the protection group should exist or not. type: str fa_url: description: - FlashArray management IPv4 address or Hostname. required: true type: str pgroup: description: - The name of the protection group. required: true type: str target: description: - List of remote arrays or offload target for replication protection group to connect to. - Note that all replicated protection groups are asynchronous. - Target arrays or offload targets must already be connected to the source array. - Maximum number of targets per Protection Group is 4, assuming your configuration supports this. type: list version_added: '2.8' version_added_collection: ansible.builtin volume: description: - List of existing volumes to add to protection group. type: list enabled: default: 'yes' description: - Define whether to enabled snapshots for the protection group. type: bool api_token: description: - FlashArray API token for admin privileged user. required: true type: str eradicate: default: 'no' description: - Define whether to eradicate the protection group on delete and leave in trash. type: bool hostgroup: description: - List of existing hostgroups to add to protection group. type: list