Read DNS Service Configs (v2.0)

GET 
/sdwan/v2.0/api/sites/:site_id/elements/:element_id/dnsservices

Read all the DNS configs.

Request

Path Parameters

site_id stringrequired

Site ID of the target resource.

element_id stringrequired

Element ID of the target device.

Responses

200

Successful Operation

application/json

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 int32
The cache size.
description
The description of the DNS service configs. Max size = 1024.
disabled boolean
List the disabled DNS service configs.
disabled_reason string
List 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 string
The custom string added to the DNS query.
type stringrequired
Possible 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 string
The IPv4 address for the add subnet.
ipv4_prefix_length int32required
The prefix lenth of the IP4 address of the add subnet.
ipv6_address string
The IPv6 address for the add subnet.
ipv6_prefix_length int32required
The prefix lenth of the IPv6 address of the add subnet.
]
dnsservice_profile_id string
The DNS service profile ID.
dnsservicerole_bindings DnsServiceroleBindings[]
The bindings of the DNS srevice role.
Array [
dnsservicerole_id string
The DNS service role ID.
interfaces Interface[]required
The DNS role binding interfaces.
Array [
interface_id string
The interface ID.
interface_ip string
The 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 string
The IPv4 address for the domain to address mapping.
ipv6_address string
The IPv6 address for the domain to address mapping.
]
domains_to_interfaces DomainsToInterface[]
The domain to interface mapping details.
Array [
domain_names string[]required
The domains to interface domain name.
interface_id stringrequired
The interface ID.
]
element_id string
The element ID.
enabled boolean
The enabled DNS service configs.
id string
The ID of the DNS service configs.
inactive boolean
Lists the inactive DNS service configs.
inactive_reason string
Reason the DNS service config is inactive.
max_concurrent_dns_queries int32
The max number of concurrent DNS queries.
name stringrequired
Name of the DNS service config.
region string
Region
site_id stringrequired
ID 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 string
The upper case names.
]

Example (from schema)

{
  "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"
    }
  ]
}

Loading...