---
title: "Test a resolver name on a Gateway."
slug: "test-a-resolver-name-on-a-gateway-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/test-a-resolver-name-on-a-gateway-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Test a resolver name on a Gateway.

Post/appliances/{id}/test-resolver-name

Test a resolver name on a Gateway.

SecurityHTTPType bearer

Path parametersidstring (uuid) Required

ID of the object.

Example12699e27-b584-464a-81ee-5b4784b6d425

Body parameters

What to test on name resolvers.

<select class='api-response-data' aria-label='Media type'><option value='c576a740-7736-4f63-bd17-dea7c0ccab6c'>application/json</option>
</select>object  resourceNamestring    

The resource name to test on the Gateway.

Exampleaws://tag:Application=Software Defined Perimeter

Responses200

Test is completed successfully.

<select class='api-response-data' aria-label='Media type'><option value='12082123-e488-4e91-9818-15e22bd2a5ed'>application/json</option>
</select>object  

The test result.

ips Array of string   

List of IPs resolved for the given name.

string    Example10.0.0.1
errorstring    

Error message if the resolution failed.

ExampleDNS name resolution error for ipv4, pycares errno 11: Could not contact DNS servers

400

JSON error. Check the JSON format.

<select class='api-response-data' aria-label='Media type'><option value='ac009375-a7e9-4f52-8a2b-66561a833daf'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

401

Token error. Login again.

<select class='api-response-data' aria-label='Media type'><option value='bc527758-74b7-4cd2-a3f7-f422bf5ce385'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

403

Insufficient permissions to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='5a95d691-8be6-4fbc-8509-3befcfeb6403'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

406

Invalid 'Accept' header.

<select class='api-response-data' aria-label='Media type'><option value='f551a57a-6448-48ff-b74f-7853666a2698'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

412

Appliance is not in the right state for this operation.

<select class='api-response-data' aria-label='Media type'><option value='23d93935-fdda-4d1e-a564-a736a5c9cd89'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

422

Request validation error. Check "errors" array for details.

<select class='api-response-data' aria-label='Media type'><option value='89427a40-badf-485a-8fc7-062a0304f9cd'>application/json</option>
</select>Expand Allobject  

Http 422 error for object validation.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

errors Array of object   

List of fields with validation errors.

object  fieldstring    

Name of the field that failed validation.

Examplename
messagestring    

Failure reason.

Examplemay not be null

500

Unexpected server side error.

<select class='api-response-data' aria-label='Media type'><option value='98fca372-1d40-4590-a654-6f7106635dd5'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.