dnscontrol/documentation/language-reference/domain-modifiers/SVCB.md
2024-12-17 07:46:37 -05:00

31 lines
1.1 KiB
Markdown

---
name: SVCB
parameters:
- name
- priority
- target
- params
- modifiers...
parameter_types:
name: string
priority: number
target: string
params: string
"modifiers...": RecordModifier[]
---
SVCB adds an SVCB record to a domain. The name should be the relative label for the record. Use `@` for the domain apex.
The priority must be a positive number, the address should be an ip address, either a string, or a numeric value obtained via [IP](../top-level-functions/IP.md).
The params may be configured to specify the `alpn`, `ipv4hint`, `ipv6hint`, `ech` or `port` setting. Several params may be joined by a space. Not existing params may be specified as an empty string `""`
Modifiers can be any number of [record modifiers](https://docs.dnscontrol.org/language-reference/record-modifiers) or JSON objects, which will be merged into the record's metadata.
{% code title="dnsconfig.js" %}
```javascript
D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
SVCB("@", 1, ".", "ipv4hint=123.123.123.123 alpn=h3,h2 port=443"),
);
```
{% endcode %}