Skip to content

Commit 8525a7e

Browse files
Adjust dns-views outline and fill in setup instructions and links
1 parent e1e3dc2 commit 8525a7e

File tree

1 file changed

+16
-8
lines changed

1 file changed

+16
-8
lines changed

src/content/docs/dns/internal-dns/how-to/dns-views.mdx

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,28 +6,36 @@ sidebar:
66
label: Views
77
---
88

9-
intro
9+
import { Details } from "~/components";
1010

11-
### Linked internal zones
11+
Internal DNS views are logical groupings of [internal DNS zones](/dns/internal-dns/how-to/internal-zones/). As explained in the [architecture overview](/dns/internal-dns/#architecture-overview), DNS views are referenced by [Gateway resolver policies](/cloudflare-one/policies/gateway/resolver-policies/) to define how a specific query should be resolved.
1212

13-
### Reference by resolver policies
13+
Refer to the sections below for details on how to manage your DNS views, or consider the [get started](/dns/internal-dns/#architecture-overview) for the complete workflow.
1414

15-
## Setup
16-
17-
### Configuration conditions
15+
## Configuration conditions
1816

1917
When setting up DNS views, observe the following conditions:
2018

2119
- DNS views can be empty, with no [internal zones](/dns/internal-dns/how-to/internal-zones/) linked to them.
2220
- A DNS view cannot contain public DNS zones[^1].
2321
- Each internal DNS zone name must be unique within a given DNS view.
2422

25-
### Create a view
23+
## Create a view
24+
25+
Use the [Create Internal DNS View](/api/resources/dns/subresources/settings/subresources/views/methods/create/) endpoint. For each view you create, list all the internal zones that should be grouped under that view.
26+
27+
## Delete a view
2628

27-
### Delete a view
29+
Use the [Delete Internal DNS View](/api/resources/dns/subresources/settings/subresources/views/methods/delete/) endpoint
2830

2931
DNS views can be deleted even if they still have internal zones linked to them. The internal DNS zones will continue to exist but will be unlinked once the view is deleted.
3032

3133
It is also possible to delete a DNS view that is being referenced by a Gateway resolver policy. In this case, queries matching the policy will return `NXDOMAIN`.
3234

35+
## Other actions
36+
37+
- [Update a DNS view](/api/resources/dns/subresources/settings/subresources/views/methods/edit/) (`PATCH`)
38+
- [Get view details](/api/resources/dns/subresources/settings/subresources/views/methods/get/) (`GET`)
39+
- [List DNS views](/api/resources/dns/subresources/settings/subresources/views/methods/list/) (`GET`)
40+
3341
[^1]: DNS zones that contain public DNS records and are accessible by public resolvers.

0 commit comments

Comments
 (0)