W3cubDocs

/Ansible

netapp_eseries.santricity.na_santricity_auth – NetApp E-Series set or update the password for a storage array device or SANtricity Web Services Proxy.

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

Synopsis

  • Sets or updates the password for a storage array device or SANtricity Web Services Proxy.

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.
current_admin_password
string
The current admin password.
When making changes to the embedded web services's login passwords, api_password will be used and current_admin_password will be ignored.
When making changes to the proxy web services's login passwords, api_password will be used and current_admin_password will be ignored.
Only required when the password has been set and will be ignored if not set.
minimum_password_length
integer
This option defines the minimum password length.
password
string
The password you would like to set.
Cannot be more than 30 characters.
ssid
string
Default:
1
The ID of the array to manage. This value must be unique for each array.
user
string
    Choices:
  • admin
  • monitor
  • support
  • security
  • storage
The local user account password to update
For systems prior to E2800, use admin to change the rw (system password).
For systems prior to E2800, all choices except admin will be ignored.
validate_certs
boolean
    Choices:
  • no
  • yes
Should https certificates be validated?

Notes

Note

  • Set ssid==”0” or ssid==”proxy” when attempting to change the password for SANtricity Web Services Proxy.
  • SANtricity Web Services Proxy storage password will be updated when changing the password on a managed storage system from the proxy; This is only true when the storage system has been previously contacted.
  • 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: Set the initial password
  na_santricity_auth:
    ssid: 1
    api_url: https://192.168.1.100:8443/devmgr/v2
    api_username: admin
    api_password: adminpass
    validate_certs: true
    current_admin_password: currentadminpass
    password: newpassword123
    user: admin

Return Values

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

Key Returned Description
msg
string
success
Success message

Sample:
Password Updated Successfully


Authors

  • 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_auth_module.html