Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
2184893
Add Dash steps for internal zone creation
RebeccaTamachiro May 21, 2025
4ed1fe6
Add tabs components and Dash steps to dns-views
RebeccaTamachiro May 21, 2025
d41b450
Revise create a view Dash steps
RebeccaTamachiro May 23, 2025
fb0724b
Add dash instructions for reference zone assignment
RebeccaTamachiro May 23, 2025
3bb666b
Get-started: remove api-only and add Dash tab placeholder
RebeccaTamachiro May 23, 2025
2ca66fd
Fix broken link
RebeccaTamachiro May 23, 2025
cb3afe2
Add partial for zone creation and replace in relevant pages
RebeccaTamachiro May 26, 2025
aa561fb
Add reference zone dash steps and intro to get-started
RebeccaTamachiro May 26, 2025
3ddc1ba
Create and apply partial for view-create-dash
RebeccaTamachiro May 26, 2025
6aaaf90
Overall review and add conditions to view creation partial
RebeccaTamachiro May 26, 2025
49b728d
Overall review and link to iDNS from docs landing page
RebeccaTamachiro May 27, 2025
4364cd0
Specify reference at the bottom of internal zones and view is API-only
RebeccaTamachiro May 28, 2025
b0fd936
Add Internal DNS to /products page
RebeccaTamachiro May 28, 2025
cc353db
Remove 'descriptive' specification for zone name
RebeccaTamachiro Jun 4, 2025
5e036fb
Update get-started to match Gateway resolver UI text
RebeccaTamachiro Jun 4, 2025
023b209
Fix typo
RebeccaTamachiro Jun 4, 2025
ba9fd22
Apply suggestions from code review
RebeccaTamachiro Jun 5, 2025
e60d3b5
Add missing period and implement some page descriptions
RebeccaTamachiro Jun 5, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 28 additions & 3 deletions src/content/docs/dns/internal-dns/dns-views.mdx

This comment was marked as off-topic.

Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ sidebar:
label: Views
---

import { Details, Render } from "~/components";
import { Details, Render, Tabs, TabItem } from "~/components";

Internal DNS views are logical groupings of [internal DNS zones](/dns/internal-dns/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.

Expand All @@ -20,16 +20,41 @@ When setting up DNS views, observe the following conditions:

## Create a view

<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select an account.
2. Go to **Internal DNS** > **Views**.
3. Give your view a descriptive name, observing the [configuration conditions](#configuration-conditions).
4. Add zones to your view by selecting **Manage zones added(TBD)**. Select the internal zones that should be used to resolve queries sent by Gateway resolver to this view and choose **Save** to confirm.

</TabItem>
<TabItem label="API">

Use the [Create Internal DNS View](/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/create/) endpoint. For each view you create, list all the internal zones that should be grouped under that view.

## Delete a view
</TabItem> </Tabs>

Use the [Delete Internal DNS View](/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/delete/) endpoint.
## Delete a view

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.

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 SERVFAIL.

<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select an account.
2. Go to **Internal DNS** > **Views**.
3. Find the view you want to delete.
4. Select the three dots in the corresponding row and choose *Delete*.
5. In the confirmation dialog, select **Delete** again to proceed.

</TabItem>
<TabItem label="API">

Use the [Delete Internal DNS View](/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/delete/) endpoint.

</TabItem> </Tabs>

## Other actions

- [Update a DNS view](/api/resources/dns/subresources/settings/subresources/account/subresources/views/methods/edit/) (`PATCH`)
Expand Down