ansible.builtin.netapp_e_lun_mapping (v2.4.6.0-1) — module

Create or Remove LUN Mappings

| "added in version" 2.2 of ansible.builtin"

Authors: Kevin Hulquest (@hulquest)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.4.6.0.post1

Description

Allows for the creation and removal of volume to host mappings for NetApp E-series storage arrays.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
---
    - name: Lun Mapping Example
      netapp_e_lun_mapping:
        state: present
        ssid: 1
        lun: 12
        target: Wilson
        volume_name: Colby1
        target_type: group
        api_url: "{{ netapp_api_url }}"
        api_username: "{{ netapp_api_username }}"
        api_password: "{{ netapp_api_password }}"

Inputs

    
lun:
    default: 0
    description:
    - The LUN number you wish to give the mapping
    - If the supplied I(volume_name) is associated with a different LUN, it will be updated
      to what is supplied here.
    required: false

ssid:
    description:
    - The storage system array identifier.
    required: false

state:
    choices:
    - present
    - absent
    description:
    - Present will ensure the mapping exists, absent will remove the mapping.
    - All parameters I(lun), I(target), I(target_type) and I(volume_name) must still be
      supplied.
    required: true

target:
    description:
    - The name of host or hostgroup you wish to assign to the mapping
    - If omitted, the default hostgroup is used.
    - If the supplied I(volume_name) is associated with a different target, it will be
      updated to what is supplied here.
    required: false

api_url:
    description:
    - 'The full API url. Example: http://ENDPOINT:8080/devmgr/v2'
    - This can optionally be set via an environment variable, API_URL
    required: false

target_type:
    choices:
    - host
    - group
    description:
    - Whether the target is a host or group.
    - Required if supplying an explicit target.
    required: false

volume_name:
    description:
    - The name of the volume you wish to include in the mapping.
    required: true

api_password:
    description:
    - The password used to authenticate against the API. This can optionally be set via
      an environment variable, API_PASSWORD
    required: false

api_username:
    description:
    - The username used to authenticate against the API. This can optionally be set via
      an environment variable, API_USERNAME
    required: false

validate_certs:
    default: true
    description:
    - Should https certificates be validated?
    required: false

Outputs

msg:
  description: Status of mapping
  returned: always
  sample: Mapping existing
  type: string