--- title: Records --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [DNS](https://developers.cloudflare.com/api/go/resources/dns) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Records ##### [List DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/list) client.DNS.Records.List(ctx, params) (\*V4PagePaginationArray\[[RecordResponse]()], error) GET/zones/{zone\_id}/dns\_records ##### [DNS Record Details](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/get) client.DNS.Records.Get(ctx, dnsRecordID, params) (\*[RecordResponse](), error) GET/zones/{zone\_id}/dns\_records/{dns\_record\_id} ##### [Create DNS Record](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/create) client.DNS.Records.New(ctx, params) (\*[RecordResponse](), error) POST/zones/{zone\_id}/dns\_records ##### [Overwrite DNS Record](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/update) client.DNS.Records.Update(ctx, dnsRecordID, params) (\*[RecordResponse](), error) PUT/zones/{zone\_id}/dns\_records/{dns\_record\_id} ##### [Update DNS Record](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/edit) client.DNS.Records.Edit(ctx, dnsRecordID, params) (\*[RecordResponse](), error) PATCH/zones/{zone\_id}/dns\_records/{dns\_record\_id} ##### [Delete DNS Record](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/delete) client.DNS.Records.Delete(ctx, dnsRecordID, body) (\*[RecordDeleteResponse](), error) DELETE/zones/{zone\_id}/dns\_records/{dns\_record\_id} ##### [Export DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/export) client.DNS.Records.Export(ctx, query) (\*string, error) GET/zones/{zone\_id}/dns\_records/export ##### [Import DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/import) client.DNS.Records.Import(ctx, params) (\*[RecordImportResponse](), error) POST/zones/{zone\_id}/dns\_records/import ##### [Scan DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/scan) Deprecated client.DNS.Records.Scan(ctx, body) (\*[RecordScanResponse](), error) POST/zones/{zone\_id}/dns\_records/scan ##### [Trigger DNS Record Scan](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/scan_trigger) client.DNS.Records.ScanTrigger(ctx, body) (\*[RecordScanTriggerResponse](), error) POST/zones/{zone\_id}/dns\_records/scan/trigger ##### [Review Scanned DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/scan_review) client.DNS.Records.ScanReview(ctx, params) (\*[RecordScanReviewResponse](), error) POST/zones/{zone\_id}/dns\_records/scan/review ##### [List Scanned DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/scan_list) client.DNS.Records.ScanList(ctx, query) (\*SinglePage\[[RecordResponse]()], error) GET/zones/{zone\_id}/dns\_records/scan/review ##### [Batch DNS Records](https://developers.cloudflare.com/api/go/resources/dns/subresources/records/methods/batch) client.DNS.Records.Batch(ctx, params) (\*[RecordBatchResponse](), error) POST/zones/{zone\_id}/dns\_records/batch ##### ModelsExpand Collapse
type ARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type ARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid IPv4 address. formatipv4 Link to this property PrivateRouting boolOptional Enables private network routing to the origin. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings ARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20a_record%20%3E%20(schema)>)
type AAAARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type AAAARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid IPv6 address. formatipv6 Link to this property PrivateRouting boolOptional Enables private network routing to the origin. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings AAAARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20aaaa_record%20%3E%20(schema)>)
type BatchPatch interface{…} One of the following:
BatchPatchARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchAAAARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchCNAMERecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchMXRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchNSRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchOpenpgpkeyRecord ID string Identifier. maxLength32 Link to this property Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type BatchPatchOpenpgpkeyRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings BatchPatchOpenpgpkeyRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
BatchPatchPTRRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchTXTRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchCAARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchCERTRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchDNSKEYRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchDSRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchHTTPSRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchLOCRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchNAPTRRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchSMIMEARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchSRVRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchSSHFPRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchSVCBRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchTLSARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPatchURIRecord ID string Identifier. maxLength32 Link to this property
Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20batch_patch%20%3E%20(schema)>)
type BatchPut interface{…} One of the following:
BatchPutARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutAAAARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutCNAMERecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutMXRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutNSRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutOpenpgpkeyRecord ID string Identifier. maxLength32 Link to this property Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type BatchPutOpenpgpkeyRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings BatchPutOpenpgpkeyRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
BatchPutPTRRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutTXTRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutCAARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutCERTRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutDNSKEYRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutDSRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutHTTPSRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutLOCRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutNAPTRRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutSMIMEARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutSRVRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutSSHFPRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutSVCBRecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutTLSARecord ID string Identifier. maxLength32 Link to this property
Link to this property
BatchPutURIRecord ID string Identifier. maxLength32 Link to this property
Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20batch_put%20%3E%20(schema)>)
type CAARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type CAARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted CAA content. See ‘data’ to set CAA properties. Link to this property
Data CAARecordDataOptional Components of a CAA record. Flags float64Optional Flags for the CAA record. maximum255 minimum0 Link to this property Tag stringOptional Name of the property controlled by this record (e.g.: issue, issuewild, iodef). Link to this property Value stringOptional Value of the record. This field’s semantics depend on the chosen tag. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings CAARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20caa_record%20%3E%20(schema)>)
type CERTRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type CERTRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted CERT content. See ‘data’ to set CERT properties. Link to this property
Data CERTRecordDataOptional Components of a CERT record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Certificate stringOptional Certificate. Link to this property KeyTag float64Optional Key Tag. maximum65535 minimum0 Link to this property Type float64Optional Type. maximum65535 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings CERTRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20cert_record%20%3E%20(schema)>)
type CNAMERecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type CNAMERecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid hostname. Must not match the record’s name. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings CNAMERecordSettingsOptional Settings for the DNS record. FlattenCNAME boolOptional If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened. Link to this property IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20cname_record%20%3E%20(schema)>)
type DNSKEYRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type DNSKEYRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted DNSKEY content. See ‘data’ to set DNSKEY properties. Link to this property
Data DNSKEYRecordDataOptional Components of a DNSKEY record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Flags float64Optional Flags. maximum65535 minimum0 Link to this property Protocol float64Optional Protocol. maximum255 minimum0 Link to this property PublicKey stringOptional Public Key. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings DNSKEYRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20dnskey_record%20%3E%20(schema)>)
type DSRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type DSRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted DS content. See ‘data’ to set DS properties. Link to this property
Data DSRecordDataOptional Components of a DS record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Digest stringOptional Digest. Link to this property DigestType float64Optional Digest Type. maximum255 minimum0 Link to this property KeyTag float64Optional Key Tag. maximum65535 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings DSRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20ds_record%20%3E%20(schema)>)
type HTTPSRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type HTTPSRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted HTTPS content. See ‘data’ to set HTTPS properties. Link to this property
Data HTTPSRecordDataOptional Components of a HTTPS record. Priority float64Optional Priority. maximum65535 minimum0 Link to this property Target stringOptional Target. Link to this property Value stringOptional Value. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings HTTPSRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20https_record%20%3E%20(schema)>)
type LOCRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type LOCRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted LOC content. See ‘data’ to set LOC properties. Link to this property
Data LOCRecordDataOptional Components of a LOC record. Altitude float64Optional Altitude of location in meters. maximum42849672.95 minimum-100000 Link to this property LatDegrees float64Optional Degrees of latitude. maximum90 minimum0 Link to this property
LatDirection LOCRecordDataLatDirectionOptional Latitude direction. One of the following: const LOCRecordDataLatDirectionN LOCRecordDataLatDirection = "N" Link to this property const LOCRecordDataLatDirectionS LOCRecordDataLatDirection = "S" Link to this property
Link to this property LatMinutes float64Optional Minutes of latitude. maximum59 minimum0 Link to this property LatSeconds float64Optional Seconds of latitude. maximum59.999 minimum0 Link to this property LongDegrees float64Optional Degrees of longitude. maximum180 minimum0 Link to this property
LongDirection LOCRecordDataLongDirectionOptional Longitude direction. One of the following: const LOCRecordDataLongDirectionE LOCRecordDataLongDirection = "E" Link to this property const LOCRecordDataLongDirectionW LOCRecordDataLongDirection = "W" Link to this property
Link to this property LongMinutes float64Optional Minutes of longitude. maximum59 minimum0 Link to this property LongSeconds float64Optional Seconds of longitude. maximum59.999 minimum0 Link to this property PrecisionHorz float64Optional Horizontal precision of location. maximum90000000 minimum0 Link to this property PrecisionVert float64Optional Vertical precision of location. maximum90000000 minimum0 Link to this property Size float64Optional Size of location in meters. maximum90000000 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings LOCRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20loc_record%20%3E%20(schema)>)
type MXRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type MXRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid mail server hostname. formathostname Link to this property Priority float64Optional Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map. maximum65535 minimum0 Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings MXRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20mx_record%20%3E%20(schema)>)
type NAPTRRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type NAPTRRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted NAPTR content. See ‘data’ to set NAPTR properties. Link to this property
Data NAPTRRecordDataOptional Components of a NAPTR record. Flags stringOptional Flags. Link to this property Order float64Optional Order. maximum65535 minimum0 Link to this property Preference float64Optional Preference. maximum65535 minimum0 Link to this property Regex stringOptional Regex. Link to this property Replacement stringOptional Replacement. Link to this property Service stringOptional Service. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings NAPTRRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20naptr_record%20%3E%20(schema)>)
type NSRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type NSRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid name server host name. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings NSRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20ns_record%20%3E%20(schema)>)
type PTRRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type PTRRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Domain name pointing to the address. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings PTRRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20ptr_record%20%3E%20(schema)>)
type Record interface{…} One of the following:
type ARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type ARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid IPv4 address. formatipv4 Link to this property PrivateRouting boolOptional Enables private network routing to the origin. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings ARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type AAAARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type AAAARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid IPv6 address. formatipv6 Link to this property PrivateRouting boolOptional Enables private network routing to the origin. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings AAAARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type CNAMERecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type CNAMERecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid hostname. Must not match the record’s name. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings CNAMERecordSettingsOptional Settings for the DNS record. FlattenCNAME boolOptional If enabled, causes the CNAME record to be resolved externally and the resulting address records (e.g., A and AAAA) to be returned instead of the CNAME record itself. This setting is unavailable for proxied records, since they are always flattened. Link to this property IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type MXRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type MXRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid mail server hostname. formathostname Link to this property Priority float64Optional Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map. maximum65535 minimum0 Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings MXRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type NSRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type NSRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A valid name server host name. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings NSRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
RecordOpenpgpkey Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type RecordOpenpgpkeyType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings RecordOpenpgpkeySettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type PTRRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type PTRRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Domain name pointing to the address. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings PTRRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type TXTRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type TXTRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Text content for the record. The content must consist of quoted “character strings” (RFC 1035), each with a length of up to 255 bytes. Strings exceeding this allowed maximum length are automatically split. Learn more at https://www.cloudflare.com/learning/dns/dns-records/dns-txt-record/. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings TXTRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type CAARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type CAARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted CAA content. See ‘data’ to set CAA properties. Link to this property
Data CAARecordDataOptional Components of a CAA record. Flags float64Optional Flags for the CAA record. maximum255 minimum0 Link to this property Tag stringOptional Name of the property controlled by this record (e.g.: issue, issuewild, iodef). Link to this property Value stringOptional Value of the record. This field’s semantics depend on the chosen tag. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings CAARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type CERTRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type CERTRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted CERT content. See ‘data’ to set CERT properties. Link to this property
Data CERTRecordDataOptional Components of a CERT record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Certificate stringOptional Certificate. Link to this property KeyTag float64Optional Key Tag. maximum65535 minimum0 Link to this property Type float64Optional Type. maximum65535 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings CERTRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type DNSKEYRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type DNSKEYRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted DNSKEY content. See ‘data’ to set DNSKEY properties. Link to this property
Data DNSKEYRecordDataOptional Components of a DNSKEY record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Flags float64Optional Flags. maximum65535 minimum0 Link to this property Protocol float64Optional Protocol. maximum255 minimum0 Link to this property PublicKey stringOptional Public Key. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings DNSKEYRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type DSRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type DSRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted DS content. See ‘data’ to set DS properties. Link to this property
Data DSRecordDataOptional Components of a DS record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Digest stringOptional Digest. Link to this property DigestType float64Optional Digest Type. maximum255 minimum0 Link to this property KeyTag float64Optional Key Tag. maximum65535 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings DSRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type HTTPSRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type HTTPSRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted HTTPS content. See ‘data’ to set HTTPS properties. Link to this property
Data HTTPSRecordDataOptional Components of a HTTPS record. Priority float64Optional Priority. maximum65535 minimum0 Link to this property Target stringOptional Target. Link to this property Value stringOptional Value. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings HTTPSRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type LOCRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type LOCRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted LOC content. See ‘data’ to set LOC properties. Link to this property
Data LOCRecordDataOptional Components of a LOC record. Altitude float64Optional Altitude of location in meters. maximum42849672.95 minimum-100000 Link to this property LatDegrees float64Optional Degrees of latitude. maximum90 minimum0 Link to this property
LatDirection LOCRecordDataLatDirectionOptional Latitude direction. One of the following: const LOCRecordDataLatDirectionN LOCRecordDataLatDirection = "N" Link to this property const LOCRecordDataLatDirectionS LOCRecordDataLatDirection = "S" Link to this property
Link to this property LatMinutes float64Optional Minutes of latitude. maximum59 minimum0 Link to this property LatSeconds float64Optional Seconds of latitude. maximum59.999 minimum0 Link to this property LongDegrees float64Optional Degrees of longitude. maximum180 minimum0 Link to this property
LongDirection LOCRecordDataLongDirectionOptional Longitude direction. One of the following: const LOCRecordDataLongDirectionE LOCRecordDataLongDirection = "E" Link to this property const LOCRecordDataLongDirectionW LOCRecordDataLongDirection = "W" Link to this property
Link to this property LongMinutes float64Optional Minutes of longitude. maximum59 minimum0 Link to this property LongSeconds float64Optional Seconds of longitude. maximum59.999 minimum0 Link to this property PrecisionHorz float64Optional Horizontal precision of location. maximum90000000 minimum0 Link to this property PrecisionVert float64Optional Vertical precision of location. maximum90000000 minimum0 Link to this property Size float64Optional Size of location in meters. maximum90000000 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings LOCRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type NAPTRRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type NAPTRRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted NAPTR content. See ‘data’ to set NAPTR properties. Link to this property
Data NAPTRRecordDataOptional Components of a NAPTR record. Flags stringOptional Flags. Link to this property Order float64Optional Order. maximum65535 minimum0 Link to this property Preference float64Optional Preference. maximum65535 minimum0 Link to this property Regex stringOptional Regex. Link to this property Replacement stringOptional Replacement. Link to this property Service stringOptional Service. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings NAPTRRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type SMIMEARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SMIMEARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted SMIMEA content. See ‘data’ to set SMIMEA properties. Link to this property
Data SMIMEARecordDataOptional Components of a SMIMEA record. Certificate stringOptional Certificate. Link to this property MatchingType float64Optional Matching Type. maximum255 minimum0 Link to this property Selector float64Optional Selector. maximum255 minimum0 Link to this property Usage float64Optional Usage. maximum255 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SMIMEARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type SRVRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SRVRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Priority, weight, port, and SRV target. See ‘data’ for setting the individual component values. Link to this property
Data SRVRecordDataOptional Components of a SRV record. Port float64Optional The port of the service. maximum65535 minimum0 Link to this property Priority float64Optional Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map. maximum65535 minimum0 Link to this property Target stringOptional A valid hostname. formathostname Link to this property Weight float64Optional The record weight. maximum65535 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SRVRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type SSHFPRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SSHFPRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted SSHFP content. See ‘data’ to set SSHFP properties. Link to this property
Data SSHFPRecordDataOptional Components of a SSHFP record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Fingerprint stringOptional Fingerprint. Link to this property Type float64Optional Type. maximum255 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SSHFPRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type SVCBRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SVCBRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted SVCB content. See ‘data’ to set SVCB properties. Link to this property
Data SVCBRecordDataOptional Components of a SVCB record. Priority float64Optional Priority. maximum65535 minimum0 Link to this property Target stringOptional Target. Link to this property Value stringOptional Value. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SVCBRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type TLSARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type TLSARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted TLSA content. See ‘data’ to set TLSA properties. Link to this property
Data TLSARecordDataOptional Components of a TLSA record. Certificate stringOptional Certificate. Link to this property MatchingType float64Optional Matching Type. maximum255 minimum0 Link to this property Selector float64Optional Selector. maximum255 minimum0 Link to this property Usage float64Optional Usage. maximum255 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings TLSARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
type URIRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type URIRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted URI content. See ‘data’ to set URI properties. Link to this property
Data URIRecordDataOptional Components of a URI record. Target stringOptional The record content. Link to this property Weight float64Optional The record weight. maximum65535 minimum0 Link to this property
Link to this property Priority float64Optional Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map. maximum65535 minimum0 Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings URIRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20record%20%3E%20(schema)>)
type RecordResponse interface{…} One of the following:
type RecordResponseARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseARecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseAAAARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseAAAARecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseCNAMERecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseCNAMERecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseMXRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseMXRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseNSRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseNSRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseOpenpgpkeyRecord struct{…} ID string Identifier. maxLength32 Link to this property Comment string Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content string A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseOpenpgpkeyRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property Proxied bool Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings RecordResponseOpenpgpkeyRecordSettings Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTags Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type RecordResponseOpenpgpkeyRecordType Record type. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponsePTRRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponsePTRRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseTXTRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseTXTRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseCAARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseCAARecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseCERTRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseCERTRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseDNSKEYRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseDNSKEYRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseDSRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseDSRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseHTTPSRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseHTTPSRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseLOCRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseLOCRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseNAPTRRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseNAPTRRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSMIMEARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseSMIMEARecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSRVRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseSRVRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSSHFPRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseSSHFPRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseSVCBRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseSVCBRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseTLSARecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseTLSARecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
type RecordResponseURIRecord struct{…} ID string Identifier. maxLength32 Link to this property CreatedOn Time When the record was created. formatdate-time Link to this property
Meta RecordResponseURIRecordMeta Extra Cloudflare-specific metadata about the record. DeadGlue boolOptional Whether this glue record is not served because a shallower NS delegation takes precedence over the deeper delegation that needs it. Present only when true; reachable glue carries only is_glue. See Unreachable glue records. Link to this property IsGlue boolOptional Whether this A or AAAA record is glue for a subdomain NS delegation. See Glue records. Link to this property ShadowedBy \[]stringOptional IDs of the NS records that shadow this record. See Shadowed records. Link to this property ShadowedRecordsCount int64Optional Number of records shadowed by this NS delegation. See Shadowed records. maximum10000 minimum0 Link to this property
Link to this property ModifiedOn Time When the record was last modified. formatdate-time Link to this property Proxiable bool Whether the record can be proxied by Cloudflare or not. Link to this property CommentModifiedOn TimeOptional When the record comment was last modified. Omitted if there is no comment. formatdate-time Link to this property TagsModifiedOn TimeOptional When the record tags were last modified. Omitted if there are no tags. formatdate-time Link to this property
Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20record_response%20%3E%20(schema)>) type RecordTags string Individual tag of the form name:value (the name must consist of only letters, numbers, underscores and hyphens) [Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20record_tags%20%3E%20(schema)>)
type SMIMEARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SMIMEARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted SMIMEA content. See ‘data’ to set SMIMEA properties. Link to this property
Data SMIMEARecordDataOptional Components of a SMIMEA record. Certificate stringOptional Certificate. Link to this property MatchingType float64Optional Matching Type. maximum255 minimum0 Link to this property Selector float64Optional Selector. maximum255 minimum0 Link to this property Usage float64Optional Usage. maximum255 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SMIMEARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20smimea_record%20%3E%20(schema)>)
type SRVRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SRVRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Priority, weight, port, and SRV target. See ‘data’ for setting the individual component values. Link to this property
Data SRVRecordDataOptional Components of a SRV record. Port float64Optional The port of the service. maximum65535 minimum0 Link to this property Priority float64Optional Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map. maximum65535 minimum0 Link to this property Target stringOptional A valid hostname. formathostname Link to this property Weight float64Optional The record weight. maximum65535 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SRVRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20srv_record%20%3E%20(schema)>)
type SSHFPRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SSHFPRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted SSHFP content. See ‘data’ to set SSHFP properties. Link to this property
Data SSHFPRecordDataOptional Components of a SSHFP record. Algorithm float64Optional Algorithm. maximum255 minimum0 Link to this property Fingerprint stringOptional Fingerprint. Link to this property Type float64Optional Type. maximum255 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SSHFPRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20sshfp_record%20%3E%20(schema)>)
type SVCBRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type SVCBRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted SVCB content. See ‘data’ to set SVCB properties. Link to this property
Data SVCBRecordDataOptional Components of a SVCB record. Priority float64Optional Priority. maximum65535 minimum0 Link to this property Target stringOptional Target. Link to this property Value stringOptional Value. Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings SVCBRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20svcb_record%20%3E%20(schema)>)
type TLSARecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type TLSARecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted TLSA content. See ‘data’ to set TLSA properties. Link to this property
Data TLSARecordDataOptional Components of a TLSA record. Certificate stringOptional Certificate. Link to this property MatchingType float64Optional Matching Type. maximum255 minimum0 Link to this property Selector float64Optional Selector. maximum255 minimum0 Link to this property Usage float64Optional Usage. maximum255 minimum0 Link to this property
Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings TLSARecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20tlsa_record%20%3E%20(schema)>)
type TTL interface{…} Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. One of the following: float64 Link to this property type TTL float64 Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20ttl%20%3E%20(schema)>)
type TXTRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type TXTRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Text content for the record. The content must consist of quoted “character strings” (RFC 1035), each with a length of up to 255 bytes. Strings exceeding this allowed maximum length are automatically split. Learn more at https://www.cloudflare.com/learning/dns/dns-records/dns-txt-record/. Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings TXTRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20txt_record%20%3E%20(schema)>)
type URIRecord struct{…} Name string Complete DNS record name, including the zone name, in Punycode. maxLength255 minLength1 Link to this property TTL TTL Time To Live (TTL) of the DNS record in seconds. Setting to 1 means ‘automatic’. Value must be between 60 and 86400, with the minimum reduced to 30 for Enterprise zones. Link to this property Type URIRecordType Record type. Link to this property Comment stringOptional Comments or notes about the DNS record. This field has no effect on DNS responses. Link to this property Content stringOptional Formatted URI content. See ‘data’ to set URI properties. Link to this property
Data URIRecordDataOptional Components of a URI record. Target stringOptional The record content. Link to this property Weight float64Optional The record weight. maximum65535 minimum0 Link to this property
Link to this property Priority float64Optional Required for MX and URI records; ignored for other record types (but may still be returned by the API). Records with lower priorities are preferred. This field is to be deprecated in favor of the priority field within the data map. maximum65535 minimum0 Link to this property Proxied boolOptional Whether the record is receiving the performance and security benefits of Cloudflare. Link to this property
Settings URIRecordSettingsOptional Settings for the DNS record. IPV4Only boolOptional When enabled, only A records will be generated, and AAAA records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property IPV6Only boolOptional When enabled, only AAAA records will be generated, and A records will not be created. This setting is intended for exceptional cases. Note that this option only applies to proxied records and it has no effect on whether Cloudflare communicates with the origin using IPv4 or IPv6. Link to this property
Link to this property Tags \[]RecordTagsOptional Custom tags for the DNS record. This field has no effect on DNS responses. Link to this property
[Link to this property](<#(resource)%20dns.records%20%3E%20(model)%20uri_record%20%3E%20(schema)>)