Zones and records

This page covers putting a domain on Yeap Cloud DNS: creating the zone, changing the nameservers at your registrar, confirming delegation, and adding and managing records.

#Create a zone

1. Go to DNS管理 → 区域管理 (DNS Management → Zones) and click 创建区域 (Create zone) at the top right.
2. Step 1, 输入域名 (Enter domain): in 区域名称 (Zone name), enter the apex domain, for example example.com. Internationalized domain names such as 中国.com work too. They are stored in Punycode, and the list still shows the original name. 描述 (Description) is optional.
3. Step 2, 选择套餐 (Choose plan): pick a DNS plan for this zone. A free plan activates right away. With a paid plan, you'll be asked to pay after the zone is created, and the zone activates once the invoice is paid.
4. Step 3, 完成配置 (Finish): the page shows the Nameserver 列表 (Nameserver list), which are the nameservers assigned to this zone. Click 复制 (Copy) next to each one and keep them.

When the zone is created, the system adds its SOA record and the root (@) NS records. These are system records. You can't edit or delete them, and they count toward the record quota.

#Change nameservers (delegation)

In your registrar's control panel, set the domain's nameservers to the ones shown in step 3. Copy them exactly as the console shows them, and don't make up your own.

• Enter all of the assigned nameservers and remove any others. Otherwise some queries will still go to your old provider.
• You can look up and copy these nameservers at any time. They're on the 名称服务器 (NS) card at the top of the zone's records page.
• Nameserver changes usually take anywhere from a few minutes to a few hours to spread worldwide. The time depends on the registry and on how long the old NS records were cached.

#NS check and zone status

The 状态 (Status) column in the zone list shows each zone's status:

If a zone is Active but the domain's NS records don't point to us yet, it also shows a 待接入 (Awaiting delegation) tag under the status.

How the check works: the platform looks up the domain's current NS records through public DNS. If at least one of them matches a nameserver assigned to the zone, the domain counts as delegated and the 待接入 tag goes away.

• Zones waiting for delegation are checked automatically in the background, in batches about every 10 minutes.
• To check right away, click the 检查NS是否已切换到我们的服务器 (Check whether NS points to us) icon on the zone's row. If the domain isn't delegated yet, a dialog shows 当前NS (the current NS found on the public internet) next to 应该指向 (the assigned nameservers you should use). You can copy the values from there.

#Add and manage records

In the zone list, click the 管理记录 (Manage records) icon to open the records page, then click 添加记录 (Add record). Each record has these fields:

#Supported record types

For content that is a hostname (CNAME, MX, NS, PTR, and the SRV target), you can include or leave off the trailing dot. The system treats it as a fully qualified name either way.

#Validation rules

• A CNAME can't share a name with any other record. For example, if www already has an A record, you can't add a CNAME for www, and the reverse is also true. The apex (@) always has NS and SOA records, so the apex can't be a CNAME.
• The apex SOA and NS records are managed by the system. The console marks them "系统记录，不可修改" (system record, can't be changed).
• If the content is malformed, the save is rejected with an error. Examples are an invalid IP in an A record, or SRV content that isn't in weight port target form.

#Bulk import

On the records page, click 更多操作 → 批量导入 (More → Bulk import):

1. Enter one record per line in the text box, or click 从文件导入 (Import from file) to load a text or CSV file. Use this format:

   textCopy

   name|type|TTL|priority|content|geo|comment

   For example:

   textCopy

   www|A|3600|0|203.0.113.10||Web server
   mail|MX|3600|10|mail.example.com||Mail server

   Comma-separated CSV works too. Name, type and content are required. A blank TTL defaults to 3600 and a blank priority defaults to 0. The geo field is for advanced use and is normally left blank.

2. Click 预览导入数据 (Preview) to check how the lines were parsed, then click 导入 (Import).

3. When the import finishes, you'll see how many records succeeded and how many failed. Each record is validated on its own, so a failure on one line (bad format, CNAME conflict, quota exceeded) doesn't stop the others.

#Download the zone file

Click 更多操作 → 下载 Zone 文件 (More → Download zone file) to download the zone's current configuration as a text file (<zone>.zone). This is handy for backups and for checking your records.

#Edit or delete a zone

• 编辑区域 (Edit zone): you can change the zone's description. The zone name can't be changed.
• 删除区域 (Delete zone): click it and confirm. After deletion, the platform's nameservers stop answering for the domain, and the domain stops resolving.