dellemc / dellemc.powermax / 1.6.1 / module / dellemc_powermax_maskingview Managing masking views on PowerMax/VMAX Storage System | "added in version" 1.0.0 of dellemc.powermax" Authors: Vasudevu Lakhinana (@unknown) <ansible.team@dell.com>, Prashant Rakheja (@prashant-dell) <ansible.team@dell.com> preview | supported by communitydellemc.powermax.dellemc_powermax_maskingview (1.6.1) — module
Install with ansible-galaxy collection install dellemc.powermax:==1.6.1
collections: - name: dellemc.powermax version: 1.6.1
Managing masking views on PowerMax storage system includes, creating masking view with port group, storage group and host or host group, renaming masking view and deleting masking view.
For creating a masking view -
(i) portgroup_name,
(ii) sg_name and
(iii) any one of host_name or hostgroup_name is required.
All three entities must be present on the array.
For renaming a masking view, the 'new_mv_name' is required. After a masking view is created, only its name can be changed. No underlying entity (portgroup, storagegroup, host or hostgroup) can be changed on the masking view.
- name: Create MV with hostgroup dellemc_powermax_maskingview: unispherehost: "{{unispherehost}}" universion: "{{universion}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" serial_no: "{{serial_no}}" mv_name: "{{mv_name}}" portgroup_name: "Ansible_Testing_portgroup" hostgroup_name: "Ansible_Testing_hostgroup" sg_name: "Ansible_Testing_SG" state: "present"
- name: Create MV with host dellemc_powermax_maskingview: unispherehost: "{{unispherehost}}" universion: "{{universion}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" serial_no: "{{serial_no}}" mv_name: "{{mv_name}}" portgroup_name: "Ansible_Testing_portgroup" host_name: "Ansible_Testing_host" sg_name: "Ansible_Testing_SG" state: "present"
- name: Rename host masking view dellemc_powermax_maskingview: unispherehost: "{{unispherehost}}" universion: "{{universion}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" serial_no: "{{serial_no}}" mv_name: "{{mv_name}}" new_mv_name: "Ansible_Testing_mv_renamed" state: "present"
- name: Delete host masking view dellemc_powermax_maskingview: unispherehost: "{{unispherehost}}" universion: "{{universion}}" verifycert: "{{verifycert}}" user: "{{user}}" password: "{{password}}" serial_no: "{{serial_no}}" mv_name: "Ansible_Testing_mv_renamed" state: "absent"
user: description: - The username of the Unisphere host. required: true type: str state: choices: - absent - present description: - Defines whether the masking view should exist or not. required: true type: str mv_name: description: - The name of the masking view. No Special Character support except for _. Case sensitive for REST Calls. required: true type: str sg_name: description: - The name of the existing storage group. type: str password: description: - The password of the Unisphere host. required: true type: str host_name: description: - The name of the existing host. This parameter is to create an exclusive or host export type: str serial_no: description: - The serial number of the PowerMax/VMAX array. It is a required parameter for all array-specific operations except for getting a list of arrays in the Gatherfacts module. required: true type: str universion: choices: - 91 - 92 description: - Unisphere version, currently '91' and '92' versions are supported. required: false type: int verifycert: choices: - true - false description: - Boolean variable to specify whether to validate SSL certificate or not. - True - indicates that the SSL certificate should be verified. - False - indicates that the SSL certificate should not be verified. required: true type: bool new_mv_name: description: - The new name for the renaming function. No Special Character support except for _. Case sensitive for REST Calls. type: str unispherehost: description: - IP or FQDN of the Unisphere host required: true type: str hostgroup_name: description: - The name of the existing host group. This parameter is used to create cluster export type: str portgroup_name: description: - The name of the existing port group. type: str
changed: description: Whether or not the resource has changed. returned: always type: bool create_mv: description: Flag sets to true when a new masking view is created. returned: When masking view is created. type: bool delete_mv: description: Flag sets to true when a masking view is deleted. returned: When masking view is deleted. type: bool modify_mv: description: Flag sets to true when a masking view is modified. returned: When masking view is modified. type: bool mv_details: contains: hostId: description: Host group present in the masking view. type: str maskingViewId: description: Masking view ID. type: str portGroupId: description: Port group present in the masking view. type: str storageGroupId: description: Storage group present in the masking view. type: str description: Details of masking view. returned: When masking view exist. type: list