purefb_fs – Manage filesystemon Pure Storage FlashBlade`
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) <[email protected]>
© 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