W3cubDocs

/Ansible

netapp.um_info.na_um_svms_info – NetApp Unified Manager list svms.

Note

This plugin is part of the netapp.um_info collection (version 21.7.0).

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

To use it in a playbook, specify: netapp.um_info.na_um_svms_info.

New in version 20.5.0: of netapp.um_info

Synopsis

  • List SVMs on AIQUM.

Requirements

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

  • A AIQUM 9.7 system.
  • Ansible 2.9 or later.

Parameters

Parameter Choices/Defaults Comments
feature_flags
dictionary
added in 21.7.0 of netapp.um_info
Enable or disable a new feature.
This can be used to enable an experimental feature or disable a new feature that breaks backward compatibility.
Supported keys and values are subject to change without notice. Unknown keys are ignored.
trace_apis can be set to true to enable tracing, data is written to /tmp/um_apis.log.
hostname
string / required
The hostname or IP address of the Unified Manager instance.
http_port
integer
Override the default port (443) with this port
max_records
integer
added in 21.7.0 of netapp.um_info
Maximum number of records retrieved in a single GET request.
This module loops on GET requests until all available records are fetched.
If absent, AIQUM uses 1000.
password
string / required
Password for the specified user.
username
string / required
username of the Unified Manager instance.
validate_certs
boolean
    Choices:
  • no
  • yes ←
If set to False, the SSL certificates will not be validated.
This should only set to False used on personally controlled sites using self-signed certificates.

Notes

Note

  • With the 21.6.0 release, all modules have been renamed to na_um_<module>_info. The old ones will continue to work but will be depecrated in the future.
  • The modules prefixed with na_um are built to support the AIQUM 9.7 platform.
  • Supports check_mode.

Examples

- name: List SVMs
  netapp.um_info.na_um_svms_info:
    hostname: "{{ hostname }}"
    username: "{{ username }}"
    password: "{{ password }}"

Return Values

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

Key Returned Description
records
list / elements=string
always
Returns list of SVMs information

Sample:
[{'_links': {'self': {'href': '...'}}, 'aggregates': [{'_links': {'self': {'href': '...'}}, 'key': '...', 'name': '...', 'uuid': '...'}], 'cifs': {'ad_domain': {'fqdn': '...'}, 'enabled': '...', 'name': '...'}, 'cluster': {'_links': {'self': {'href': '...'}}, 'key': '...', 'name': '...', 'uuid': '...'}, 'dns': '...', 'fcp': {'enabled': '...'}, 'ipspace': {'_links': {}, 'key': '...', 'name': '...', 'uuid': '...'}, 'iscsi': {'enabled': '...'}, 'key': '...', 'language': '...', 'ldap': {'enabled': '...'}, 'name': '...', 'nfs': {'enabled': '...'}, 'nis': {'domain': '...', 'enabled': '...', 'servers': '...'}, 'nvme': {'enabled': '...'}, 'snapshot_policy': {'_links': {}, 'key': '...', 'name': '...', 'uuid': '...'}, 'state': '...', 'subtype': 'default', 'uuid': '...'}]


Authors

© 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/um_info/na_um_svms_info_module.html