netapp.storagegrid.na_sg_grid_dns – NetApp StorageGRID manage external DNS servers for the grid.

Note

This plugin is part of the netapp.storagegrid collection (version 21.9.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.storagegrid.

To use it in a playbook, specify: netapp.storagegrid.na_sg_grid_dns.

New in version 20.6.0: of netapp.storagegrid

Synopsis

  • Update NetApp StorageGRID DNS addresses.

Parameters

Parameter Choices/Defaults Comments
api_url
string / required
The url to the StorageGRID Admin Node REST API.
auth_token
string / required
The authorization token for the API request
dns_servers
list / elements=string / required
List of comma separated DNS Addresses to be updated or delete.
state
string
    Choices:
  • present ←
Whether the specified DNS address should exist or not.
Required for all operations.
validate_certs
boolean
    Choices:
  • no
  • yes ←
Should https certificates be validated?

Notes

Note

  • The modules prefixed with na_sg are built to manage NetApp StorageGRID.

Examples

- name: update DNS servers on StorageGRID
  netapp.storagegrid.na_sg_grid_dns:
    api_url: "https://<storagegrid-endpoint-url>"
    auth_token: "storagegrid-auth-token"
    validate_certs: false
    state: present
    dns_servers: "x.x.x.x,xxx.xxx.xxx.xxx"

Return Values

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

Key Returned Description
resp
list / elements=string
success
Returns information about the configured DNS servers.

Sample:
['8.8.8.8', '8.8.4.4']


Authors