W3cubDocs

/Ansible 2.7

netapp_e_lun_mapping - NetApp E-Series create, delete, or modify lun mappings

New in version 2.2.

Synopsis

  • Create, delete, or modify mappings between a volume and a targeted host/host+ group.

Parameters

Parameter Choices/Defaults Comments
api_password
required
The password to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
api_url
required
The url to the SANtricity Web Services Proxy or Embedded Web Services API.
api_username
required
The username to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
lun
(added in 2.7)
The LUN value you wish to give the mapping.
If the supplied volume_name is associated with a different LUN, it will be updated to what is supplied here.
LUN value will be determine by the storage-system when not specified.
ssid
required
The ID of the array to manage. This value must be unique for each array.
state
required
    Choices:
  • present
  • absent
Present will ensure the mapping exists, absent will remove the mapping.
target
The name of host or hostgroup you wish to assign to the mapping
If omitted, the default hostgroup is used.
If the supplied volume_name is associated with a different target, it will be updated to what is supplied here.
target_type
(added in 2.7)
    Choices:
  • host
  • group
This option specifies the whether the target should be a host or a group of hosts
Only necessary when the target name is used for both a host and a group of hosts
validate_certs
bool
    Choices:
  • no
  • yes ←
Should https certificates be validated?
volume_name
required
The name of the volume you wish to include in the mapping.

aliases: volume

Notes

Note

  • The E-Series Ansible modules require either an instance of the Web Services Proxy (WSP), to be available to manage the storage-system, or an E-Series storage-system that supports the Embedded Web Services API.
  • Embedded Web Services is currently available on the E2800, E5700, EF570, and newer hardware models.
  • netapp_e_storage_system may be utilized for configuring the systems managed by a WSP instance.

Examples

---
    - name: Map volume1 to the host target host1
      netapp_e_lun_mapping:
        ssid: 1
        api_url: "{{ netapp_api_url }}"
        api_username: "{{ netapp_api_username }}"
        api_password: "{{ netapp_api_password }}"
        validate_certs: no
        state: present
        target: host1
        volume: volume1
    - name: Delete the lun mapping between volume1 and host1
      netapp_e_lun_mapping:
        ssid: 1
        api_url: "{{ netapp_api_url }}"
        api_username: "{{ netapp_api_username }}"
        api_password: "{{ netapp_api_password }}"
        validate_certs: yes
        state: absent
        target: host1
        volume: volume1

Return Values

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

Key Returned Description
msg
string
 always
success of the module

Sample:
Lun mapping is complete


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Kevin Hulquest (@hulquest)
  • Nathan Swartz (@ndswartz)

Hint

If you notice any issues in this documentation you can edit this document to improve it.

© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/netapp_e_lun_mapping_module.html