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_fb
Python library - You must set
PUREFB_URL
andPUREFB_API
environment 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