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

Copy
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:

Copy
myhost.example.com

Error (400 Bad Request)

Example response body:

Copy
IP address can't be resolved to DNS

Error (500 Internal Server Error)

Copy
An error has occurred