Skip to content

Commit bc499f1

Browse files
More details on reference zones logic and conditions
1 parent 19eece2 commit bc499f1

File tree

2 files changed

+16
-3
lines changed

2 files changed

+16
-3
lines changed

src/content/docs/dns/internal-dns/get-started.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ Although there are some steps that can be achieved on the dashboard, currently t
5353

5454
### (Optional) Reference a zone from another zone
5555

56-
1. Use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint to add a reference from an internal zone to another internal zone. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`.
56+
1. Use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint to add a reference from an internal zone to another internal zone. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`. For details, refer to [Manage internal zones](/dns/internal-dns/internal-zones/#reference-zones).
5757

5858
<Example>
5959
<Render file="internal-reference-zone-api"/>

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

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,27 @@ When setting up internal zones, observe the following conditions:
2828

2929
Since the resolver policy configuration will require a view, you must link the internal zones to at least one view to be able to use them when routing requests to Internal DNS. For a full procedure overview, refer to [get started](/dns/internal-dns/get-started/).
3030

31-
## Configure a reference zone
31+
## Reference zones
32+
33+
### How it works
3234

3335
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.
3436

35-
To configure a reference zone to be used in such cases, use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`.
37+
Successive references can be followed with a maximum of five references in a chain.
38+
39+
### Setup
40+
41+
To set up a reference zone, use the [Update DNS settings](/api/resources/dns/subresources/settings/methods/edit/) endpoint. In `--data`, specify the `internal_dns` object with the parameter `reference_zone_id`.
42+
43+
Each internal zone can only reference one other zone, but the same zone can be referenced by multiple internal zones.
44+
45+
Public zones cannot be used as reference zones.
3646

3747
<Example>
3848
<Render file="internal-reference-zone-api"/>
49+
50+
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.
51+
3952
</ Example>
4053

4154
## Other actions

0 commit comments

Comments
 (0)