2017-01-12 04:02:45 +08:00
---
name: CNAME
parameters:
- name
2017-04-12 13:02:57 +08:00
- target
2017-01-12 04:02:45 +08:00
- modifiers...
2023-01-13 05:59:42 +08:00
parameter_types:
name: string
target: string
"modifiers...": RecordModifier[]
2017-01-12 04:02:45 +08:00
---
CNAME adds a CNAME record to the domain. The name should be the relative label for the domain.
Using `@` or `*` for CNAME records is not recommended, as different providers support them differently.
2017-04-12 13:02:57 +08:00
Target should be a string representing the CNAME target. If it is a single label we will assume it is a relative name on the current domain. If it contains *any* dots, it should be a fully qualified domain name, ending with a `.` .
2017-01-12 04:02:45 +08:00
2023-01-20 20:56:20 +08:00
```javascript
2017-01-12 04:02:45 +08:00
D("example.com", REGISTRAR, DnsProvider("R53"),
CNAME("foo", "google.com."), // foo.example.com -> google.com
CNAME("abc", "@"), // abc.example.com -> example.com
2020-10-03 02:15:35 +08:00
CNAME("def", "test"), // def.example.com -> test.example.com
2017-01-12 04:02:45 +08:00
);
2022-02-18 01:22:31 +08:00
```