Policy >
Networking
>
IP Management
>
DNS
>
DNS Forwarder
>
Tier-0 Gateways
Get tier-0 DNS forwarder statistics
Get statistics of tier-0 DNS forwarder.
- no enforcement point path specified: Statistics will be evaluated on each enforcement
point.
- {enforcement_point_path}: Statistics are evaluated only on the given enforcement point.
Request:
Method:
GET
URI Path(s):
/policy/api/v1/infra/tier-0s/{tier-0-id}/dns-forwarder/statistics
/policy/api/v1/global-infra/tier-0s/{tier-0-id}/dns-forwarder/statistics
Request Headers:
n/a
Query Parameters:
PolicyRuntimeOnEpRequestParameters
+
PolicyRuntimeOnEpRequestParameters
(
schema
)
Name
Description
Type
Notes
enforcement_point_path
String Path of the enforcement point
enforcement point path, forward slashes must be escaped using %2F.
string
Request Body:
n/a
Example Request:
GET https://<policy-mgr>/policy/api/v1/infra/tier-0s/tier-01/dns-forwarder/statistics
Successful Response:
Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
AggregateDNSForwarderStatistics
+
AggregateDNSForwarderStatistics
(
schema
)
Name
Description
Type
Notes
intent_path
String path of the DNS forwarder intent
String path of the DNS forwarder intent.
string
Required
statistics_per_enforcement_point
List of DNS forwarder statistics per enforcement point
List of DNS forwarder statistics per enforcement point.
array of
DNSForwarderStatisticsPerEnforcementPoint
(Abstract type: pass one of the following concrete types)
NsxTDNSForwarderStatistics
Readonly
Example Response:
{ "statistics_per_enforcement_point": [ { "resource_type": "NsxTDNSForwarderStatistics", "enforcement_point_path": "/infra/sites/default/enforcement-points/default", "queries_answered_locally": 0, "conditional_forwarder_statistics": [ { "upstream_statistics": [ { "queries_succeeded": 0, "queries_failed": 0, "upstream_server": "10.0.0.0" }, { "queries_succeeded": 0, "queries_failed": 0, "upstream_server": "10.2.0.0" } ], "domain_names": [ "fqdn1", "fqdn2" ] } ], "default_forwarder_statistics": { "upstream_statistics": [ { "queries_succeeded": 0, "queries_failed": 0, "upstream_server": "11.0.0.0" }, { "queries_succeeded": 0, "queries_failed": 0, "upstream_server": "11.2.0.0" } ] }, "used_cache_stats": [ { "node_id": "6f1c310b-aeed-445e-aef9-9722c8967ab8", "used_cache_size": 300, "cached_entries_number": 200 }, { "node_id": "5b171969-1539-4be4-a761-83f46b6a262f", "used_cache_size": 200, "cached_entries_number": 190 } ], "queries_forwarded": 0, "configured_cache_size": 4096, "total_queries": 0 } ], "intent_path": "/infra/tier-0s/tier-01/dns-forwarder" }
Required Permissions:
read
Feature:
policy_statistics
Additional Errors:
404 Not Found
301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
412 Precondition Failed
500 Internal Server Error
503 Service Unavailable