---
title: DNS Configuration
summary: Customers with access to multiple sets of IP pools are able to manage DNS records associated with the IP pools.
url: https://www.fastly.com/documentation/reference/api/ip-configuration/spp/dns-configuration
---

Customers with access to multiple sets of IP pools are able to manage DNS records associated with the IP pools.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `name` | string | The CNAME record for your DNS Configuration. It must be a valid FQDN that starts with a custom label and ends with <code>.customer.fastly.com</code> (e.g., <code>example.customer.fastly.net</code>). Supported characters for the custom label include a-z, 0-9, hyphens, and underscores. |
| `dualstack` | boolean | True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false. |
| `region` | string | The region string will be “global” for all configurations involving the customer’s SPP vipspace. (Read-only) |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `dualstack` | boolean | True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false. |
| `name` | string | The CNAME record for your DNS Configuration. It must be a valid FQDN that starts with a custom label and ends with <code>.customer.fastly.com</code> (e.g., <code>example.customer.fastly.net</code>). Supported characters for the custom label include a-z, 0-9, hyphens, and underscores. |
| `relationships.tls_configuration.id` | string | Alphanumeric string identifying a TLS configuration. |
| `type` | string | Resource type. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `dualstack` | boolean | True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false. |
| `id` | string | Alphanumeric string identifying a DNS configuration. |
| `name` | string | The CNAME record for your DNS Configuration. It must be a valid FQDN that starts with a custom label and ends with <code>.customer.fastly.com</code> (e.g., <code>example.customer.fastly.net</code>). Supported characters for the custom label include a-z, 0-9, hyphens, and underscores. |
| `region` | string | The region string will be “global” for all configurations involving the customer’s SPP vipspace. (Read-only) |
| `relationships.tls_configuration.id` | string | Alphanumeric string identifying a TLS configuration. |
| `type` | string | Resource type. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `dualstack` | boolean | True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false. |
| `type` | string | Resource type. |

## API endpoints

### List DNS configurations

**GET** `/dns/configurations`

List all DNS configurations.

### Create a DNS configuration

**POST** `/dns/configurations`

Create a DNS configuration.

### Get a DNS configuration

**GET** `/dns/configurations/{dns_configuration_id}`

Show a specific DNS configuration.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `dns_configuration_id` | string | path | Yes | The ID for a DNS configuration (UUID). |

### Delete a DNS configuration

**DELETE** `/dns/configurations/{dns_configuration_id}`

Remove a DNS configuration.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `dns_configuration_id` | string | path | Yes | The ID for a DNS configuration (UUID). |

### Update a DNS configuration

**PATCH** `/dns/configurations/{dns_configuration_id}`

Update a DNS configuration.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `dns_configuration_id` | string | path | Yes | The ID for a DNS configuration (UUID). |