[{"label":"Latest (v1.0)","version":"latest"}]
nsx-vmc-policy

Query Nameserver

Description

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). If enforcement point is specified, then DNS forwarder nslookup answer will get fetched from specified enforcement point. Otherwise from all enforcement points.

Request

Request

URL

URL


get
https://nsxmanager.your.domain/policy/api/v1/infra/tier-1s/{tier-1-id}/dns-forwarder/nslookup
Copy

Path Parameters

Path Parameters

string
tier-1-id Required

Query Parameters

Query Parameters

string
address Optional

IP address or FQDN for nslookup


string
enforcement_point_path Optional

String Path of the enforcement point


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns AggregatePolicyDnsAnswer of type(s) application/json
{
	"dns_answer_per_enforcement_point": [
		{
			"enforcement_point_path": "string",
			"resource_type": "NsxTDnsAnswer"
		}
	],
	"intent_path": "string"
}
string
intent_path Required

String path of the DNS forwarder intent.


dns_answer_per_enforcement_point Optional

List of DNS forwarder nslookup answer per enforcement point.

Errors

Errors

ApiError
400

Bad Request


ApiError
403

Forbidden


ApiError
404

Not Found


ApiError
412

Precondition Failed


ApiError
500

Internal Server Error


ApiError
503

Service Unavailable

Code Samples

Code Samples

PowerCLI Client SDK Example

Invoke-LookupAddressViaTier1DNSForwarder -tier1Id "Mytier1Id" -address "Myaddress" -enforcementPointPath "MyenforcementPointPath"

cURL Command

curl https://nsxmanager.your.domain/policy/api/v1/infra/tier-1s/{tier-1-id}/dns-forwarder/nslookup
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: query-nameserver
x-vmw-nsx-module: PolicyDnsForwarder


Feedback

Was this page helpful?