Remove Dns Settings

Remove Dns Settings
Remove DNS Settings

Removes all DNS server configuration from the HCX Manager appliance. Resets DNS settings to defaults or empty.

Important Notes:

  • Service Restart Required: You must restart the Application Service and Web Service after removing DNS
  • Use with caution: Removing DNS may break connectivity to vCenter, NSX, and other services
  • Consider reconfiguring DNS immediately after removal

Restart Commands:

systemctl restart app-engine
systemctl restart web-engine

Warning: Without DNS configuration, the HCX Manager may not resolve:

  • vCenter Server hostnames
  • NSX Manager hostnames
  • NTP server hostnames
  • External service endpoints
Request
URI
DELETE
https://{server}:9443/system/network/dns
COPY
Authentication
This operation uses the following authentication methods.
Responses
204

DNS settings removed successfully (No Content)

Operation doesn't return any data structure

500

Internal server error - Failed to remove DNS

Returns ErrorResponse of type(s) application/json 
{
    "isSuccess": false,
    "message": "Request schema validation failed",
    "httpStatusCode": 400
}
boolean
isSuccess
Required

Indicates if the operation was successful

string
message
Required

Human-readable error message

integer
httpStatusCode
Required

HTTP status code


Code Samples
COPY
                    curl -X DELETE -H 'Authorization: <value>' https://{api_host}/system/network/dns
On This Page
System Configuration Operations
GET
Get Nsp Configuration
Deprecated
POST
Create Nsp Configuration
Deprecated
PUT
Update Nsp Configuration
Deprecated
GET
Get Static Routes
PUT
Configure Static Route
GET
Get Network Settings
PUT
Configure Dns Settings
DELETE
Remove Dns Settings
GET
Get Time Settings
PUT
Configure Time Settings
DELETE
Remove Ntp Settings
PUT
Change Appliance Password
GET
Get Apache Proxy Configuration
Deprecated
POST
Configure Apache Proxy
Deprecated