Resolve a given address via the DNS forwarder

Query the nameserver for an ip-address or a FQDN of the given an address optionally using
an specified DNS server. If the address is a fqdn, nslookup will resolve ip-address with it.
If the address is an ip-address, do a reverse lookup and answer fqdn(s).

Request:

Method:

GET

URI Path(s):

/api/v1/dns/forwarders/<forwarder-id>/nslookup

Request Headers:

n/a

Query Parameters:

NsLookupParameters+

Name	Description	Type
address	IP address or FQDN for nslookup IP address or FQDN for this lookup	string
server_ip	Target server used for this lookup If absent, the underlying DNS forwarder will be used as the target server. And the answer could be cached by the forwarder if it was not cached yet. If provided, the query will go directly to the given server. You will need to ensure this address represents a workable and reachale DNS server. The answer will not be cached by the forwarder unless this server_ip is exactly the same listener ip of the forwarder.	IPv4Address
source_ip	Source ip used for this lookup Source ip used for this lookup. If absent, the listener ip of the underlying DNS forwarder will be used as the source ip. If provided, you will need to ensure this source ip is valid and can be routed back to the transport node via data plane	IPv4Address

Request Body:

n/a

Example Request:

GET https://<nsx-mgr>/api/v1/dns/forwarders/1b6cb97f-ffa3-407c-b2ed-a9616feb95dd/nslookup?address=vmware.com

Successful Response:

Response Code:

200 OK

Response Headers:

Content-type: application/json

Response Body:

DnsAnswer+

Name	Description	Type	Notes
answers	The answers of the query. The answers of the query.	array of DnsQueryAnswer	Minimum items: 1 Maximum items: 256
authoritative_answers	Authoritative answers Authotitative answers of the query. This is a deprecated property, please use 'answers' instead.	array of DnsQueryAnswer	Deprecated Minimum items: 1 Maximum items: 256
dns_server	DNS server information Dns server ip address and port, format is "ip address#port".	string	Required
edge_node_id	Edge node id ID of the edge node that performed the query.	string	Required
non_authoritative_answers	Non authoritative answers Non-authotitative answers of the query. This is a deprecated property, please use 'answers' instead.	array of DnsQueryAnswer	Deprecated Minimum items: 1 Maximum items: 256
raw_answer	Raw message returned from the DNS forwarder It can be NXDOMAIN or error message which is not consisted of authoritative_answer or non_authoritative_answer.	string
source_ip	The source ip used in this lookup The source ip used in this lookup.	IPv4Address	Required

Example Response:

{ "dns_server" : "10.117.0.1#53", "edge_node_id" : "e2fa39aa-f4ca-4781-ac48-60a6c47d34e0", "authoritative_answer" : [ { "name": "vmware.com" "address": "10.113.63.149" } ] }

Required Permissions:

read

Feature:

dns_forwarder

Additional Errors:

301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
500 Internal Server Error
503 Service Unavailable