From a6008b338a24e83636048562e947d97b9c9a777f Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro <62246989+RebeccaTamachiro@users.noreply.github.com> Date: Thu, 28 Nov 2024 14:45:30 +0000 Subject: [PATCH] [DNS] More intro info to DNS records overview (#18319) * Add background info paragraph and link out for more * Introduce DNS records table, as well as proxy status and flattening * Fill in common field descriptions and add an example with explanantion * Fix broken link * Text review and adjust setup link to a more introductory page --- .../docs/dns/manage-dns-records/index.mdx | 33 +++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/manage-dns-records/index.mdx b/src/content/docs/dns/manage-dns-records/index.mdx index b827de62b345b9c..0c79d1edffa1997 100644 --- a/src/content/docs/dns/manage-dns-records/index.mdx +++ b/src/content/docs/dns/manage-dns-records/index.mdx @@ -6,11 +6,40 @@ sidebar: --- -import { DirectoryListing, FeatureTable, GlossaryTooltip } from "~/components" +import { DirectoryListing, FeatureTable, GlossaryTooltip, Details, Example } from "~/components" DNS records contain information about your domain and are used to make your website or application available to visitors and other web services. -For background about different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). +Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. According to your [setup](/dns/get-started/), you can use Cloudflare to manage your DNS records. + +## DNS records table + +DNS records have different types and each type serves a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/). + +When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](/dns/cname-flattening/). These are specific features offered by Cloudflare. + +<Details header="Record fields"> +- **Type**: Defines the purpose of a record. Different types of record require different information in their corresponding `Content` field. +- **Name**: Identifies the resource that the record resolves to. Depending on the purpose of the record, the value you want to add to this field will also change. +- **Content**: Contains the core value of a record, depending on the record type. +- **TTL**: Controls how long each record is cached by DNS resolvers. +</Details> + +<Details header="Example"> + +<Example> +DNS management for **example.com**: + +| Type | Name | Content | Proxy status | TTL | +| ---- | ------- | ------------ | ------------ | ------ | +| A | `blog` | `192.0.2.1` | Proxied | Auto | + +In this example, an IP address resolution record of type `A` is indicating that the resources that correspond to the subdomain `blog.example.com` can be reached on the IPv4 address `192.0.2.1`. + +Also, as this record is <GlossaryTooltip term="proxy status" link="/dns/manage-dns-records/reference/proxied-dns-records/">proxied</GlossaryTooltip>, Cloudflare automatically defines for how long this information should be cached by DNS resolvers. +</Example> + +</Details> ## DNS records quota