community.general.emc_vnx_sg_member module – Manage storage group member on EMC VNX

Note

This module is part of the community.general collection (version 7.5.2).

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 community.general. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: community.general.emc_vnx_sg_member.

Synopsis

  • This module manages the members of an existing storage group.

Aliases: storage.emc.emc_vnx_sg_member

Requirements

The below requirements are needed on the host that executes this module.

  • An EMC VNX Storage device.

  • Ansible 2.7.

  • storops (0.5.10 or greater). Install using ‘pip install storops’.

Parameters

Parameter

Comments

lunid

integer / required

Lun id to be added.

name

string / required

Name of the Storage group to manage.

sp_address

string / required

Address of the SP of target/secondary storage.

sp_password

string

password for accessing SP.

Default: "sysadmin"

sp_user

string

Username for accessing SP.

Default: "sysadmin"

state

string

Indicates the desired lunid state.

present ensures specified lunid is present in the Storage Group.

absent ensures specified lunid is absent from Storage Group.

Choices:

  • "present" ← (default)

  • "absent"

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • The modules prefixed with emc_vnx are built to support the EMC VNX storage platform.

Examples

- name: Add lun to storage group
  community.general.emc_vnx_sg_member:
    name: sg01
    sp_address: sp1a.fqdn
    sp_user: sysadmin
    sp_password: sysadmin
    lunid: 100
    state: present

- name: Remove lun from storage group
  community.general.emc_vnx_sg_member:
    name: sg01
    sp_address: sp1a.fqdn
    sp_user: sysadmin
    sp_password: sysadmin
    lunid: 100
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

hluid

integer

LUNID that hosts attached to the storage group will see.

Returned: success

Authors

  • Luca ‘remix_tj’ Lorenzetto (@remixtj)