NSX-T Data Center REST API

Perform host resolution test

Perform host resolution test from individual manager node,
where this API is executed for the requested hostname.
Depending upon resolved hostname, response can have -
only resolved_ip_addresses or only resolved_ip6_addresses or
both resolved_ip_addresses and resolved_ip6_addresses.

Request:

Method:
POST
URI Path(s):
/api/v1/administration/network-diagnosis/host-resolution-test
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
HostResolutionRequest+

Example Request:

Request 1- POST https://<nsx-mgr>/api/v1/administration/network-diagnosis/host-resolution-test { "hostname": "target-hostname-with-ipv4-only.com" } Request 2- POST https://<nsx-mgr>/api/v1/administration/network-diagnosis/host-resolution-test { "hostname": "target-hostname-with-ipv6-only.com" } Request 3- POST https://<nsx-mgr>/api/v1/administration/network-diagnosis/host-resolution-test { "hostname": "target-hostname-with-both-ipv4-ipv6-only.com" } Request 4- POST https://<nsx-mgr>/api/v1/administration/network-diagnosis/host-resolution-test { "hostname": "unreachable-hostname.com" }

Successful Response:

Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
HostResolutionResponse+

Example Response:

Response 1- Status: 200 ok { "resolved_ip_addresses": ["142.250.68.110"] } Response 2- Status: 200 ok { "resolved_ip6_addresses": ["2607:f8b0:4007:815::200e"] } Response 3- Status: 200 ok { "resolved_ip_addresses": ["142.250.68.110"], "resolved_ip6_addresses": ["2607:f8b0:4007:815::200e"] } Response 4- Status: 404 not found { "error_code": 37181, "message": "Error in host resolution" }

Required Permissions:

crud

Feature:

system_administration

Additional Errors: