purefb_fs – Manage filesystemon Pure Storage FlashBlade`
New in version 2.6.
Synopsis
- This module manages filesystems on Pure Storage FlashBlade.
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.7
- purity_fb >= 1.1
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| api_token string | FlashBlade API token for admin privileged user. | |
| eradicate boolean |
| Define whether to eradicate the filesystem on delete or leave in trash. |
| fastremove boolean |
| Define whether the fast remove directory is enabled for the filesystem. |
| fb_url string | FlashBlade management IP address or Hostname. | |
| hard_limit boolean added in 2.8 |
| Define whether the capacity for a filesystem is a hard limit. CAUTION This will cause the filesystem to go Read-Only if the capacity has already exceeded the logical size of the filesystem. |
| http boolean |
| Define whether to HTTP/HTTPS protocol is enabled for the filesystem. |
| name string / required | Filesystem Name. | |
| nfs boolean |
| Define whether to NFS protocol is enabled for the filesystem. |
| nfs_rules string | Default: "*(rw,no_root_squash)" | Define the NFS rules in operation. |
| size string | Default: "32G" | Volume size in M, G, T or P units. See examples. |
| smb boolean |
| Define whether to SMB protocol is enabled for the filesystem. |
| snapshot boolean |
| Define whether a snapshot directory is enabled for the filesystem. |
| state string |
| Create, delete or modifies a filesystem. |
Notes
Note
- This module requires the
purity_fbPython library - You must set
PUREFB_URLandPUREFB_APIenvironment variables if fb_url and api_token arguments are not passed to the module directly
Examples
- name: Create new filesystem named foo
purefb_fs:
name: foo
size: 1T
state: present
fb_url: 10.10.10.2
api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
- name: Delete filesystem named foo
purefb_fs:
name: foo
state: absent
fb_url: 10.10.10.2
api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
- name: Recover filesystem named foo
purefb_fs:
name: foo
state: present
fb_url: 10.10.10.2
api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
- name: Eradicate filesystem named foo
purefb_fs:
name: foo
state: absent
eradicate: true
fb_url: 10.10.10.2
api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
- name: Modify attributes of an existing filesystem named foo
purefb_fs:
name: foo
size: 2T
nfs : true
nfs_rules: '*(ro)'
snapshot: true
fastremove: true
hard_limit: true
smb: true
state: present
fb_url: 10.10.10.2
api_token: T-55a68eb5-c785-4720-a2ca-8b03903bf641
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Pure Storage Ansible Team (@sdodsley) <pure-ansible-team@purestorage.com>
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/purefb_fs_module.html