[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Get Edge Gateway DNS

Description

Retrieves DNS configuration of the edge gateway.

Request

Request

URL

URL


get
https://{api_host}/cloudapi/1.0.0/edgeGateways/{gatewayId}/dns
Copy

Path Parameters

Path Parameters

string
gatewayId Required

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns EdgeDnsConfig of type(s) application/json;version=36.3
{
	"conditionalForwarderZones": [
		{
			"displayName": "string",
			"dnsDomainNames": [
				"string"
			],
			"id": "string",
			"upstreamServers": [
				"string"
			]
		}
	],
	"defaultForwarderZone": {
		"displayName": "string",
		"dnsDomainNames": [
			"string"
		],
		"id": "string",
		"upstreamServers": [
			"string"
		]
	},
	"enabled": false,
	"listenerIp": "string",
	"snatRuleEnabled": false,
	"version": {
		"version": 0
	}
}
conditionalForwarderZones Optional

The list of forwarder zones with its matching DNS domains.


defaultForwarderZone Optional

The default forwarder zone to use if there’s no matching domain in the conditional forwarder zone.


boolean
enabled Optional

True means that the forwarder is enabled. False means it’s disabled.


string
listenerIp Optional

The IP on which the DNS forwarder listens. If the Edge Gateway has a dedicated external network, this can be changed.


boolean
snatRuleEnabled Optional

Whether there is an SNAT rule exists for the DNS forwarder or not. In NAT routed environments, an SNAT rule is required for the Edge DNS forwarder to send traffic to an upstream server. In fully routed environments, this is not needed if the listener IP is on an advertised subnet. If the Edge Gateway has a dedicated external network and the listener IP has been changed, there will not be an SNAT rule for the DNS forwarder. In all other cases the SNAT rule will exist.


version Optional

This property describes the current version of the entity. To prevent clients from overwriting each other’s changes, update operations must include the version which can be obtained by issuing a GET operation. If the version number on an update call is missing, the operation will be rejected. This is only needed on update calls.

Errors

Errors

Error
404

The specified resource was not found

Code Samples

Code Samples

cURL Command

curl https://{api_host}/cloudapi/1.0.0/edgeGateways/{gatewayId}/dns


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Feedback

Was this page helpful?