Query Nameserver
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
URLURL
https://nsxmanager.your.domain/policy/api/v1/infra/tier-0s/{tier-0-id}/dns-forwarder/nslookup
Path Parameters
Path Parameters
| Required | Parameter Name | Type | Description |
|---|---|---|---|
| required |
|
string | Not available |
Query Parameters
Query Parameters
| Required | Parameter Name | Type | Description |
|---|---|---|---|
| optional |
|
string | IP address or FQDN for nslookup |
| optional |
|
string | String Path of the enforcement point |
Response
Response
Response BodyResponse Body
200 OK returns
AggregatePolicyDnsAnswer
{
"dns_answer_per_enforcement_point": [
{
"enforcement_point_path": "string",
"resource_type": "string"
}
],
"intent_path": "string"
}| Property Name | Type | Description |
|---|---|---|
| intent_path | string |
String path of the DNS forwarder intent. |
| dns_answer_per_enforcement_point | array of PolicyDnsAnswerPerEnforcementPoint |
List of DNS forwarder nslookup answer per enforcement point. |
cURL Command
curl https://nsxmanager.your.domain/policy/api/v1/infra/tier-0s/{tier-0-id}/dns-forwarder/nslookup
Errors
| Code | Returns | Description |
|---|---|---|
| 412 | PreconditionFailed | Not available |
| 500 | InternalServerError | The server encountered an unexpected condition which prevented it from fulfilling the request. |
| 503 | ServiceUnavailable | The server is currently unavailable (because it is overloaded or down for maintenance). |
| 400 | BadRequest | The request cannot be fulfilled due to bad syntax. |
| 403 | Forbidden | The server understood the request, but is refusing to fulfill it. |
| 404 | NotFound | The requested resource could not be found but may be available again in the future. |
