netapp_eseries.santricity.na_santricity_lun_mapping – NetApp E-Series manage lun mappings
Note
This plugin is part of the netapp_eseries.santricity collection (version 1.2.13).
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 netapp_eseries.santricity
.
To use it in a playbook, specify: netapp_eseries.santricity.na_santricity_lun_mapping
.
Parameters
Parameter |
Comments |
---|---|
The password to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API. |
|
The url to the SANtricity Web Services Proxy or Embedded Web Services API. |
|
The username to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API. |
|
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. |
|
The ID of the array to manage. This value must be unique for each array. Default: 1 |
|
Present will ensure the mapping exists, absent will remove the mapping. Choices:
|
|
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. |
|
Should https certificates be validated? Choices:
|
|
The name of the volume you wish to include in the mapping. Use ACCESS_VOLUME to reference the in-band access management 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.
M(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
na_santricity_lun_mapping:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: present
target: host1
volume: volume1
- name: Delete the lun mapping between volume1 and host1
na_santricity_lun_mapping:
ssid: "1"
api_url: "https://192.168.1.100:8443/devmgr/v2"
api_username: "admin"
api_password: "adminpass"
validate_certs: true
state: absent
target: host1
volume: volume1
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
success of the module Returned: always Sample: “Lun mapping is complete” |
Authors
Kevin Hulquest (@hulquest)
Nathan Swartz (@ndswartz)