Skip to content

Commit fb0724b

Browse files
Add dash instructions for reference zone assignment
1 parent d41b450 commit fb0724b

File tree

1 file changed

+16
-3
lines changed

1 file changed

+16
-3
lines changed

src/content/docs/dns/internal-dns/internal-zones/reference-zones.mdx

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 4
66
---
77

8-
import { Example, Render } from "~/components";
8+
import { Example, Render, Tabs, TabItem } from "~/components";
99

1010
During an [internal DNS query resolution](/dns/internal-dns/#architecture-overview), if no internal record is found within a matching internal zone, Cloudflare will check if the matching internal zone is referencing another internal zone. Successive references can be followed with a maximum of five references in a chain.
1111

@@ -22,11 +22,24 @@ A wildcard record (`*.example.local`) in the matching internal zone will take pr
2222

2323
## Set up
2424

25-
To set up a reference zone, use the [Update DNS settings](/api/resources/dns/subresources/settings/subresources/zone/methods/edit/) endpoint. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`.
25+
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
26+
27+
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select an account.
28+
2. Go to **Internal DNS** and select a zone.
29+
3. Within the selected zone, go to **Reference zone**.
30+
4. Select **Add reference zone**. If your zone already has a reference zone set up, you must first remove it. As explained in the [configuration conditions](#configuration-conditions), each internal zone can only reference one other zone at a time.
31+
5. Find the zone you want to use as reference and choose **Select** in the respective row.
32+
33+
</TabItem>
34+
<TabItem label="API">
35+
36+
Use the [Update DNS settings](/api/resources/dns/subresources/settings/subresources/zone/methods/edit/) endpoint. In `--json`, specify the `internal_dns` object with the parameter `reference_zone_id`.
2637

2738
<Example>
2839
<Render file="internal-reference-zone-api"/>
2940

3041
A third zone (C) could also point to zone B as a reference, but zone A cannot add another zone as a reference while also having zone B configured as its reference zone.
3142

32-
</ Example>
43+
</ Example>
44+
45+
</TabItem> </Tabs>

0 commit comments

Comments
 (0)