Share via

az network dns record-set soa

Manage a DNS SOA record.

Commands

Name Description Type Status
az network dns record-set soa show

Get a SOA record set.

 Core GA
az network dns record-set soa update

Update properties of an SOA record.

 Core GA

az network dns record-set soa show

Edit

Get a SOA record set.

az network dns record-set soa show [--ids]
                                   [--resource-group]
                                   [--subscription]
                                   [--zone-name]

Examples

Get a SOA record set.

az network dns record-set soa show -g MyResourceGroup -z www.mysite.com -n MyRecordSet

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property Value
Parameter group: Resource Id Arguments
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property Value
Parameter group: Resource Id Arguments
--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property Value
Parameter group: Resource Id Arguments
--zone-name -z

Name of the DNS zone.

Property Value
Parameter group: Resource Id Arguments
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az network dns record-set soa update

Edit

Update properties of an SOA record.

az network dns record-set soa update --resource-group
                                     --zone-name
                                     [--email]
                                     [--expire-time]
                                     [--host]
                                     [--if-none-match]
                                     [--minimum-ttl]
                                     [--refresh-time]
                                     [--retry-time]
                                     [--serial-number]

Examples

Update properties of an SOA record.

az network dns record-set soa update -g MyResourceGroup -z www.mysite.com \
    -e myhostmaster.mysite.com

Update properties of an SOA record. (autogenerated)

az network dns record-set soa update --email myhostmaster.mysite.com --only-show-errors --resource-group MyResourceGroup --subscription MySubscription --zone-name www.mysite.com

Required Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--zone-name -z

The name of the zone.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--email -e

Email address.

--expire-time -x

Expire time (seconds).

--host -t

Host name.

--if-none-match

Create the record set only if it does not already exist.

--minimum-ttl -m

Minimum TTL (time-to-live, seconds).

Property Value
Default value: 3600
--refresh-time -f

Refresh value (seconds).

--retry-time -r

Retry time (seconds).

--serial-number -s

Serial number.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False