Skip to content

Commit 70f2945

Browse files
authored
Update TXT record specification for accuracy
- The [DNS Standards](https://datatracker.ietf.org/doc/html/rfc1035#section-2.3.4) referenced support 255 octets (bytes), where one chare equals one byte. - Internal AzureDNS API code supports TXT record length of 255, so do AzureDNS APIs. - Verified using Azure that 255 chars are supported by AzureDNS for TXT record type, not 254 char limitation in Docs. - Changing here to fix the documentation.
1 parent eec59c6 commit 70f2945

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

articles/dns/dns-zones-records.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -94,9 +94,9 @@ The zone serial number in the SOA record isn't updated automatically when change
9494

9595
TXT records are used to map domain names to arbitrary text strings. They're used in multiple applications, in particular related to email configuration, such as the [Sender Policy Framework (SPF)](https://en.wikipedia.org/wiki/Sender_Policy_Framework) and [DomainKeys Identified Mail (DKIM)](https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail).
9696

97-
The DNS standards permit a single TXT record to contain multiple strings, each of which may be up to 254 characters in length. Where multiple strings are used, they are concatenated by clients and treated as a single string.
97+
The DNS standards permit a single TXT record to contain multiple strings, each of which may be up to 255 characters in length. Where multiple strings are used, they are concatenated by clients and treated as a single string.
9898

99-
When calling the Azure DNS REST API, you need to specify each TXT string separately. When using the Azure portal, PowerShell or CLI interfaces you should specify a single string per record, which is automatically divided into 254-character segments if necessary.
99+
When calling the Azure DNS REST API, you need to specify each TXT string separately. When using the Azure portal, PowerShell or CLI interfaces you should specify a single string per record, which is automatically divided into 255-character segments if necessary.
100100

101101
The multiple strings in a DNS record shouldn't be confused with the multiple TXT records in a TXT record set. A TXT record set can contain multiple records, *each of which* can contain multiple strings. Azure DNS supports a total string length of up to 1024 characters in each TXT record set (across all records combined).
102102

@@ -139,4 +139,4 @@ The following default limits apply when using Azure DNS:
139139
## Next steps
140140

141141
* To start using Azure DNS, learn how to [create a DNS zone](./dns-getstarted-portal.md) and [create DNS records](./dns-getstarted-portal.md).
142-
* To migrate an existing DNS zone, learn how to [import and export a DNS zone file](dns-import-export.md).
142+
* To migrate an existing DNS zone, learn how to [import and export a DNS zone file](dns-import-export.md).

0 commit comments

Comments
 (0)