Skip to main content
Pure1 Support Portal



puredns — manages the DNS attributes of an array


puredns list [ --cli | --csv | --nvp ] [--notitle] [--page] [--raw]

puredns setattr [--domain DOMAIN] [--nameservers NAMESERVERS]


-h | --help

Can be used with any command or subcommand to display a brief syntax description.


Domain suffix to be appended by the array when performing DNS lookups. To remove the domain suffix from Purity DNS queries, set to an empty string ("").


Comma-separated list of up to three DNS server IP addresses.

For IPv4, specify the IP address in the form ddd.ddd.ddd.ddd, where ddd is a number ranging from 0 to 255 representing a group of 8 bits. For IPv6, specify the IP address in the form xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx, where xxxx is a hexadecimal number representing a group of 16 bits. When specifying an IPv6 address, consecutive fields of zeros can be shortened by replacing the zeros with a double colon (::).

To unassign the DNS server IP addresses, set to an empty string (""). Once the DNS server IP addresses have been unassigned, the array no longer makes DNS queries.

Options that control display format:


Displays output in the form of CLI commands that can be issued to reproduce the current configuration. The --cli output is not meaningful when combined with immutable attributes.


Lists information in comma-separated value (CSV) format. The --csv output can be used for scripting purposes and imported into spreadsheet programs.


Lists information without column titles.


Lists information in name-value pair (NVP) format, in the form ITEMNAME=VALUE. Argument names and information items are displayed flush left. The --nvp output is designed both for convenient viewing of what might otherwise be wide listings, and for parsing individual items for scripting purposes.


Turns on interactive paging.


Displays the unformatted version of column titles and data. For example, in the purearray monitor output, the unformatted version of column title us/op (read) is usec_per_read_op. The --raw output is used to sort and filter list results.


The puredns command manages the DNS attributes for an array's administrative network.

The puredns setattr command sets the DNS parameters of the array. Include the --domain option to set the domain suffix to be appended to DNS queries. The list of DNS name server IP addresses specified in the --nameservers option replaces the list of name servers in effect prior to command execution.

The puredns list command displays the current DNS parameters, including domain suffix and name servers, of the array. Include the --cli option to display the CLI command line that would reproduce the array's current DNS configuration. This can, for example, be copied and pasted to create an identical DNS configuration in another array, or saved as a backup.


Example 1

puredns setattr --domain --nameservers,

Specifies the IPv4 addresses of two DNS servers for Purity to use to resolve hostnames to IP addresses, and the domain suffix for DNS searches.

Example 2

puredns setattr --nameservers,2001:0db8:85a3::ae26:8a2e:0370:7334

Specifies the IP addresses of two DNS server for Purity to use to resolve hostnames to IP addresses.

Example 3

puredns setattr --domain ""

Removes the domain suffix from Purity DNS queries.

Example 4

puredns setattr --nameservers ""

Unassigns DNS server IP addresses (Purity ceases to make DNS queries).


Pure Storage Inc.