Read DNS Service Configs (v2.0)
Read all the DNS configs.
Path Parameters
- site_id string required
Site ID of the target resource.
- element_id string required
Element ID of the target device.
- 200
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
- count int32
The number of responses.
- id string
The ID of the response.
items DnsService[]
Array [cache_config ElemCacheConfig
Lists details of the cache configuration.
cache_size int32The cache size.
descriptionThe description of the DNS service configs. Max size = 1024.
disabled booleanList the disabled DNS service configs.
disabled_reason stringList the disabled DNS service configs reason.
dns_queries_metadata ElemDnsQueriesMetadata
Lists the DNS queries parameters that append the client metadata to the DNS query as it is sent to the upstream DNS server.
add_customer_premises_equipment ElemCustomerPremisesEquipment
The element ID, text, or element name is added based on the DNS query configuration.
identifier_text stringThe custom string added to the DNS query.
type string requiredPossible values: [
text
,element_id
,element_name
]The customer premises equipment type.
add_subnets Subnet[]
The subnet ID is added for the DNS query.
Array [ipv4_address stringThe IPv4 address for the add subnet.
ipv4_prefix_length int32 requiredThe prefix lenth of the IP4 address of the add subnet.
ipv6_address stringThe IPv6 address for the add subnet.
ipv6_prefix_length int32 requiredThe prefix lenth of the IPv6 address of the add subnet.
]dnsservice_profile_id stringThe DNS service profile ID.
dnsservicerole_bindings DnsServiceroleBindings[]
The bindings of the DNS srevice role.
Array [dnsservicerole_id stringThe DNS service role ID.
interfaces Interface[] required
The DNS role binding interfaces.
Array [interface_id stringThe interface ID.
interface_ip stringThe DNS server interface IP.
]]domains_to_addresses DomainsToAddress[]
The unique domain to address mapping and the IP address.
Array [domain_names string[]The domain name.
ipv4_address stringThe IPv4 address for the domain to address mapping.
ipv6_address stringThe IPv6 address for the domain to address mapping.
]domains_to_interfaces DomainsToInterface[]
The domain to interface mapping details.
Array [domain_names string[] requiredThe domains to interface domain name.
interface_id string requiredThe interface ID.
]element_id stringThe element ID.
enabled booleanThe enabled DNS service configs.
id stringThe ID of the DNS service configs.
inactive booleanLists the inactive DNS service configs.
inactive_reason stringReason the DNS service config is inactive.
max_concurrent_dns_queries int32The max number of concurrent DNS queries.
name string requiredName of the DNS service config.
region stringRegion
site_id string requiredID of the site.
tags string[]A information field that can be added to identify the DNS service roles. Maximum 10 unique tags of length 1024 each are allowed.
upperCaseName stringThe upper case names.
]
{
"count": 0,
"id": "string",
"items": [
{
"cache_config": {
"cache_size": 0
},
"disabled": true,
"disabled_reason": "string",
"dns_queries_metadata": {
"add_customer_premises_equipment": {
"identifier_text": "string",
"type": "text"
},
"add_subnets": [
{
"ipv4_address": "string",
"ipv4_prefix_length": 0,
"ipv6_address": "string",
"ipv6_prefix_length": 0
}
]
},
"dnsservice_profile_id": "string",
"dnsservicerole_bindings": [
{
"dnsservicerole_id": "string",
"interfaces": [
{
"interface_id": "string",
"interface_ip": "string"
}
]
}
],
"domains_to_addresses": [
{
"domain_names": [
"string"
],
"ipv4_address": "string",
"ipv6_address": "string"
}
],
"domains_to_interfaces": [
{
"domain_names": [
"string"
],
"interface_id": "string"
}
],
"element_id": "string",
"enabled": true,
"id": "string",
"inactive": true,
"inactive_reason": "string",
"max_concurrent_dns_queries": 0,
"name": "string",
"region": "string",
"site_id": "string",
"tags": [
"string"
],
"upperCaseName": "string"
}
]
}