netapp_eseries.santricity.na_santricity_hostgroup – NetApp E-Series manage array host groups

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_hostgroup.

Synopsis

Create, update or destroy host groups on a NetApp E-Series storage array.

Parameters

Parameter	Choices/Defaults	Comments
api_password string / required		The password to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
api_url string / required		The url to the SANtricity Web Services Proxy or Embedded Web Services API. Example https://prod-1.wahoo.acme.com:8443/devmgr/v2
api_username string / required		The username to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
hosts list / elements=string		List of host names/labels to add to the group
name string		Name of the host group to manage
ssid string	Default: 1	The ID of the array to manage. This value must be unique for each array.
state string	Choices: present ← absent	Whether the specified host group should exist or not.
validate_certs boolean	Choices: no yes ←	Should https certificates be validated?

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: Configure Hostgroup
  na_santricity_hostgroup:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    state: present
    name: example_hostgroup
    hosts:
      - host01
      - host02

Return Values

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

Key	Returned	Description
clusterRef string	always except when state is absent	The unique identification value for this object. Other objects may use this reference value to refer to the cluster. Sample: 3233343536373839303132333100000000000000
confirmLUNMappingCreation boolean	always	If true, indicates that creation of LUN-to-volume mappings should require careful confirmation from the end-user, since such a mapping will alter the volume access rights of other clusters, in addition to this one.
hosts list / elements=string	always except when state is absent	A list of the hosts that are part of the host group after all operations. Sample: ['HostA', 'HostB']
id string	always except when state is absent	The id number of the hostgroup Sample: 3233343536373839303132333100000000000000
isSAControlled boolean	always except when state is absent	If true, indicates that I/O accesses from this cluster are subject to the storage array's default LUN-to-volume mappings. If false, indicates that I/O accesses from the cluster are subject to cluster-specific LUN-to-volume mappings.
label string	always	The user-assigned, descriptive label string for the cluster. Sample: MyHostGroup
name string	always except when state is absent	same as label Sample: MyHostGroup
protectionInformationCapableAccessMethod boolean	always except when state is absent	This field is true if the host has a PI capable access method. Sample: True

Authors

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

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp_eseries/santricity/na_santricity_hostgroup_module.html

Docs

Docs4dev

Title here