Skip to content

Commit 624ed74

Browse files
authored
[DNS] Update API link (#18793)
1 parent 46a6792 commit 624ed74

File tree

1 file changed

+24
-13
lines changed
  • src/content/docs/dns/zone-setups/partial-setup

1 file changed

+24
-13
lines changed

src/content/docs/dns/zone-setups/partial-setup/setup.mdx

Lines changed: 24 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ sidebar:
66
head:
77
- tag: title
88
content: Set up a partial (CNAME) zone
9-
109
---
1110

1211
import { Details, Render, GlossaryTooltip, Steps } from "~/components";
@@ -17,46 +16,54 @@ import { Details, Render, GlossaryTooltip, Steps } from "~/components";
1716
A partial setup is only available to customers on a Business or Enterprise plan.
1817
:::
1918

20-
***
19+
---
2120

2221
## Before you begin
2322

2423
<Steps>
24+
2525
1. Create a Cloudflare account and add your domain.
2626
2. Choose **Business** or **Enterprise** as your plan.
2727
3. If you are onboarding a new domain to Cloudflare, ignore the instructions to change your nameservers.
2828
4. (Recommended) Plan for SSL/TLS certificates:
2929

30-
If you are only using [Universal SSL](/ssl/edge-certificates/universal-ssl/) prior to converting your zone, a certificate will be provisioned for your subdomains only after each of the respective DNS records ([step 3](#3-add-dns-records) below) are [proxied](/dns/manage-dns-records/reference/proxied-dns-records/). Refer to [Enable Universal SSL](/ssl/edge-certificates/universal-ssl/enable-universal-ssl/#partial-dns-setup) for details.
30+
If you are only using [Universal SSL](/ssl/edge-certificates/universal-ssl/) prior to converting your zone, a certificate will be provisioned for your subdomains only after each of the respective DNS records ([step 3](#3-add-dns-records) below) are [proxied](/dns/manage-dns-records/reference/proxied-dns-records/). Refer to [Enable Universal SSL](/ssl/edge-certificates/universal-ssl/enable-universal-ssl/#partial-dns-setup) for details.
31+
32+
If your domain is sensitive to downtime, instead of using Universal SSL, consider using an [advanced certificate](/ssl/edge-certificates/advanced-certificate-manager/) with [delegated DCV](/ssl/edge-certificates/changing-dcv-method/methods/delegated-dcv/#setup).
3133

32-
If your domain is sensitive to downtime, instead of using Universal SSL, consider using an [advanced certificate](/ssl/edge-certificates/advanced-certificate-manager/) with [delegated DCV](/ssl/edge-certificates/changing-dcv-method/methods/delegated-dcv/#setup).
3334
</Steps>
3435

3536
## 1. Convert your zone and review DNS records
3637

3738
<Steps>
39+
3840
1. On the **Overview** page, select **Convert to CNAME DNS Setup**.
3941
2. Select **Convert** to confirm.
4042
3. Save the information from the **Verification TXT Record**. If you lose the information, you can also access it by going to **DNS** > **Records** > **Verification TXT Record**.
4143
4. Make sure that you have all the DNS records (A, AAAA, or CNAME) for subdomains that you want to proxy through Cloudflare.
44+
4245
</Steps>
4346

4447
## 2. Verify ownership for your domain
4548

4649
Add the **Verification TXT Record** at your authoritative DNS provider. Cloudflare will verify the TXT record and send a confirmation email. This can take up to a few hours.
4750

4851
<Details header="Example verification record">
52+
4953
A verification record for `example.com` might be:
5054

5155
| Type | Name | Content |
5256
| ---- | ------------------------------- | ------------------- |
5357
| TXT | `cloudflare-verify.example.com` | 966215192-518620144 |
58+
5459
</Details>
5560

5661
:::note
62+
5763
If your authoritative DNS provider automatically appends DNS record `name` fields with your domain, make sure to only insert `cloudflare-verify` as the record name. Otherwise, it may result in an incorrect record name, such as `cloudflare-verify.example.com.example.com`.
5864

59-
After creating the record, you can use this [Dig Web Interface link](https://digwebinterface.com/?type=TXT\&ns=auth\&nameservers=) to search (`dig`) for `cloudflare-verify.<YOUR DOMAIN>` and validate if it is working.
65+
After creating the record, you can use this [Dig Web Interface link](https://digwebinterface.com/?type=TXT&ns=auth&nameservers=) to search (`dig`) for `cloudflare-verify.<YOUR DOMAIN>` and validate if it is working.
66+
6067
:::
6168

6269
That record must remain in place for as long as your domain is active on the partial setup on Cloudflare.
@@ -66,25 +73,29 @@ If your organization has multiple Cloudflare accounts, also consider using zone
6673
## 3. Add DNS records
6774

6875
<Steps>
76+
6977
1. At your authoritative DNS provider:
78+
7079
1. Create `CNAME` records pointing to `{your-hostname}.cdn.cloudflare.net` for every hostname you wish to proxy through Cloudflare.
7180

72-
<Details header="Example CNAME record at authoritative DNS provider">
81+
<Details header="Example CNAME record at authoritative DNS provider">
82+
83+
The `CNAME` record for `www.example.com` would be:
7384

74-
The `CNAME` record for `www.example.com` would be:
85+
```txt
86+
www.example.com CNAME www.example.com.cdn.cloudflare.net
87+
```
7588

76-
```txt
77-
www.example.com CNAME www.example.com.cdn.cloudflare.net
78-
```
79-
</Details>
89+
</Details>
8090

81-
2. Remove any previously existing `A`, `AAAA`, or `CNAME` records referencing the hostnames you want to proxy through Cloudflare. For these hostnames, leave only the records pointing to `{your-hostname}.cdn.cloudflare.net`.
91+
2. Remove any previously existing `A`, `AAAA`, or `CNAME` records referencing the hostnames you want to proxy through Cloudflare. For these hostnames, leave only the records pointing to `{your-hostname}.cdn.cloudflare.net`.
8292

8393
2. Repeat this process for each subdomain that should be proxied to Cloudflare.
94+
8495
</Steps>
8596

8697
---
8798

8899
## Other record types
89100

90-
If you are preparing a conversion from partial to full setup, or if you have a more specific use case, you can use the [Create DNS Record](/api/operations/dns-records-for-a-zone-create-dns-record) API endpoint to create DNS records of any supported type.
101+
If you are preparing a conversion from partial to full setup, or if you have a more specific use case, you can use the [Create DNS Record](/api/resources/dns/subresources/records/methods/create/) API endpoint to create DNS records of any supported type.

0 commit comments

Comments
 (0)