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

Note

This module is part of the netapp.um_info collection (version 21.8.1).

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. You need further requirements to be able to use this module, see Requirements for details.

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

Note

The netapp.um_info collection is considered unmaintained and will be removed from Ansible 10. See the discussion thread for more information.

New in netapp.um_info 20.5.0

Synopsis

  • List SVMs on AIQUM.

Aliases: na_um_list_svms

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

Comments

feature_flags

dictionary

added in netapp.um_info 21.7.0

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

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

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.

Choices:

  • false

  • true ← (default)

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

Description

records

list / elements=string

Returns list of SVMs information

Returned: always

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

  • NetApp Ansible Team (@carchi8py)