Resolve IP address to hostname
Returns the DNS hostname associated with the specified IP address, if available, using the DNS servers configured for ASMS (Reverse DNS Lookup).
The response body is a plain string containing the resolved hostname.
Resource name: /api/v1/reversednslookup
Request Method: GET
Request Parameters
Request Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ipaddress
(Mandatory) |
string | Yes | IP address to resolve to a hostname (IPv4 or IPv6). The server performs a reverse DNS lookup using ASMS DNS configuration. |
Request Example
cURL Example
curl -X GET "https://<localhost>/afa/api/v1/reversednslookup?ipaddress=192.168.1.10" \
-H "accept: */*"
Status Codes
| Code | Description |
|---|---|
| 200 | OK — Successfully resolved the IP address. Body is a plain string (hostname). |
| 400 | Bad Request — IP cannot be resolved to DNS or the IP is invalid. Body is a plain string (for example, IP address can't be resolved to DNS). |
| 401 | Unauthorized — Session is unauthorized. |
| 403 | Forbidden — User does not have permissions for this action. |
| 404 | Not Found — Body may be ApiFailure or a plain string. |
| 423 | Locked. |
| 500 | Internal Server Error — An error has occurred. |
Response Parameters
On success (200), the response body is a single plain-text string containing the resolved hostname (not a JSON object).
Response Examples
Success (200 OK)
Example response body:
myhost.example.com
Error (400 Bad Request)
Example response body:
IP address can't be resolved to DNS
Error (500 Internal Server Error)
An error has occurred