dellemc.powerflex.protection_domain_v2 module – Managing protection domain on Dell PowerFlex 5.x
Note
This module is part of the dellemc.powerflex collection (version 3.0.0).
You might already have this collection installed if you are using the ansible package.
It is not included in ansible-core.
To check whether it is installed, run ansible-galaxy collection list.
To install it, use: ansible-galaxy collection install dellemc.powerflex.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: dellemc.powerflex.protection_domain_v2.
New in dellemc.powerflex 3.0.0
Synopsis
Dell PowerFlex protection domain module includes getting the details of protection domain, creating a new protection domain, and modifying the attribute of a protection domain.
Requirements
The below requirements are needed on the host that executes this module.
A Dell PowerFlex storage system version 5.0 or later.
PyPowerFlex 2.0.0
Parameters
Parameter |
Comments |
|---|---|
IP or FQDN of the PowerFlex host. |
|
Used to indicate the state of the protection domain and to activate or deactivate it. When set to When set to Choices:
|
|
The password of the PowerFlex host. |
|
Port number through which communication happens with PowerFlex host. Default: |
|
The ID of the protection domain. Except for create operation, all other operations can be performed using protection_domain_id. Mutually exclusive with protection_domain_name. |
|
The name of the protection domain. Mandatory for create operation. It is unique across the PowerFlex array. Mutually exclusive with protection_domain_id. |
|
Used to rename the protection domain. |
|
The state of the protection domain. Can be ‘present’ or ‘absent’. Choices:
|
|
Time after which connection will get terminated. It is to be mentioned in seconds. Default: |
|
The username of the PowerFlex host. |
|
Boolean variable to specify whether or not to validate SSL certificate.
Choices:
|
Notes
Note
This module is supported on Dell PowerFlex 5.x and later versions.
The protection domain can only be deleted if all its related objects have been dissociated from the protection domain.
If the protection domain set to inactive, then no operation can be performed on protection domain.
The check_mode is supported.
The modules present in the collection named as ‘dellemc.powerflex’ are built to support the Dell PowerFlex storage platform.
Examples
- name: Create protection domain
dellemc.powerflex.protection_domain_v2:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
protection_domain_name: "domain1"
state: "present"
- name: Create protection domain with all parameters
dellemc.powerflex.protection_domain_v2:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
protection_domain_name: "domain1"
is_active: true
state: present
- name: Get protection domain details using name
dellemc.powerflex.protection_domain_v2:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
protection_domain_name: "domain1"
state: "present"
- name: Get protection domain details using ID
dellemc.powerflex.protection_domain_v2:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
protection_domain_id: "5718253c00000004"
state: "present"
- name: Modify protection domain attributes
dellemc.powerflex.protection_domain_v2:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
protection_domain_name: "domain1"
protection_domain_new_name: "domain1_new"
state: "present"
- name: Delete protection domain using name
dellemc.powerflex.protection_domain_v2:
hostname: "{{hostname}}"
username: "{{username}}"
password: "{{password}}"
validate_certs: "{{validate_certs}}"
port: "{{port}}"
protection_domain_name: "domain1_new"
state: "absent"
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
|---|---|
Whether or not the resource has changed. Returned: always Sample: |
|
Details of the protection domain. Returned: When protection domain exists Sample: |
|
FGL metadata cache size. Returned: success |
|
FGL concurrent writes. Returned: success |
|
Whether FGL cache enabled. Returned: success |
|
Protection domain ID. Returned: success |
|
Protection domain links. Returned: success |
|
Protection domain instance URL. Returned: success |
|
Protection domain’s relationship with different entities. Returned: success |
|
MDM’s SDS counter parameter. Returned: success |
|
Long window for Counter Parameters. Returned: success |
|
Medium window for Counter Parameters. Returned: success |
|
Short window for Counter Parameters. Returned: success |
|
Name of the protection domain. Returned: success |
|
Whether overall network throttling enabled. Returned: success |
|
Overall network throttling in KBps. Returned: success |
|
Whether protected maintenance mode network throttling enabled. Returned: success |
|
Protected maintenance mode network throttling in KBps. Returned: success |
|
State of protection domain. Returned: success |
|
Whether rebalance network throttling enabled. Returned: success |
|
Rebalance network throttling in KBps. Returned: success |
|
Whether rebuild network throttling enabled. Returned: success |
|
Rebuild network throttling in KBps. Returned: success |
|
Id of RF cache acceleration pool. Returned: success |
|
Whether RF cache is enabled or not. Returned: success |
|
RF cache maximum I/O size in KB. Returned: success |
|
RF cache operational mode. Returned: success |
|
RF cache page size in KB. Returned: success |
|
Connectivity info of SDR and SDS. Returned: success |
|
Connectivity status of client and server. Returned: success |
|
Disconnected client ID. Returned: success |
|
Disconnected client name. Returned: success |
|
Disconnected server ID. Returned: success |
|
Disconnected server IP. Returned: success |
|
Disconnected server name. Returned: success |
|
Counter parameter for SDS-SDS network. Returned: success |
|
Long window for Counter Parameters. Returned: success |
|
Medium window for Counter Parameters. Returned: success |
|
Short window for Counter Parameters. Returned: success |
|
ID of system. Returned: success |
|
Whether V-Tree migration network throttling enabled. Returned: success |
|
V-Tree migration network throttling in KBps. Returned: success |