# Records ## List DNS Records `dns.records.list(RecordListParams**kwargs) -> SyncV4PagePaginationArray[RecordResponse]` **get** `/zones/{zone_id}/dns_records` List, search, sort, and filter a zones' DNS records. ### Parameters - `zone_id: str` Identifier. - `comment: Optional[Comment]` - `absent: Optional[str]` If this parameter is present, only records *without* a comment are returned. - `contains: Optional[str]` Substring of the DNS record comment. Comment filters are case-insensitive. - `endswith: Optional[str]` Suffix of the DNS record comment. Comment filters are case-insensitive. - `exact: Optional[str]` Exact value of the DNS record comment. Comment filters are case-insensitive. - `present: Optional[str]` If this parameter is present, only records *with* a comment are returned. - `startswith: Optional[str]` Prefix of the DNS record comment. Comment filters are case-insensitive. - `content: Optional[Content]` - `contains: Optional[str]` Substring of the DNS record content. Content filters are case-insensitive. - `endswith: Optional[str]` Suffix of the DNS record content. Content filters are case-insensitive. - `exact: Optional[str]` Exact value of the DNS record content. Content filters are case-insensitive. - `startswith: Optional[str]` Prefix of the DNS record content. Content filters are case-insensitive. - `direction: Optional[SortDirection]` Direction to order DNS records in. - `"asc"` - `"desc"` - `match: Optional[Literal["any", "all"]]` Whether to match all search requirements or at least one (any). If set to `all`, acts like a logical AND between filters. If set to `any`, acts like a logical OR instead. Note that the interaction between tag filters is controlled by the `tag-match` parameter instead. - `"any"` - `"all"` - `name: Optional[Name]` - `contains: Optional[str]` Substring of the DNS record name. Name filters are case-insensitive. - `endswith: Optional[str]` Suffix of the DNS record name. Name filters are case-insensitive. - `exact: Optional[str]` Exact value of the DNS record name. Name filters are case-insensitive. - `startswith: Optional[str]` Prefix of the DNS record name. Name filters are case-insensitive. - `order: Optional[Literal["type", "name", "content", 2 more]]` Field to order DNS records by. - `"type"` - `"name"` - `"content"` - `"ttl"` - `"proxied"` - `page: Optional[float]` Page number of paginated results. - `per_page: Optional[float]` Number of DNS records per page. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `search: Optional[str]` Allows searching in multiple properties of a DNS record simultaneously. This parameter is intended for human users, not automation. Its exact behavior is intentionally left unspecified and is subject to change in the future. This parameter works independently of the `match` setting. For automated searches, please use the other available parameters. - `tag: Optional[Tag]` - `absent: Optional[str]` Name of a tag which must *not* be present on the DNS record. Tag filters are case-insensitive. - `contains: Optional[str]` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value contains ``. Tag filters are case-insensitive. - `endswith: Optional[str]` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value ends with ``. Tag filters are case-insensitive. - `exact: Optional[str]` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value is ``. Tag filters are case-insensitive. - `present: Optional[str]` Name of a tag which must be present on the DNS record. Tag filters are case-insensitive. - `startswith: Optional[str]` A tag and value, of the form `:`. The API will only return DNS records that have a tag named `` whose value starts with ``. Tag filters are case-insensitive. - `tag_match: Optional[Literal["any", "all"]]` Whether to match all tag search requirements or at least one (any). If set to `all`, acts like a logical AND between tag filters. If set to `any`, acts like a logical OR instead. Note that the regular `match` parameter is still used to combine the resulting condition with other filters that aren't related to tags. - `"any"` - `"all"` - `type: Optional[Literal["A", "AAAA", "CAA", 18 more]]` Record type. - `"A"` - `"AAAA"` - `"CAA"` - `"CERT"` - `"CNAME"` - `"DNSKEY"` - `"DS"` - `"HTTPS"` - `"LOC"` - `"MX"` - `"NAPTR"` - `"NS"` - `"OPENPGPKEY"` - `"PTR"` - `"SMIMEA"` - `"SRV"` - `"SSHFP"` - `"SVCB"` - `"TLSA"` - `"TXT"` - `"URI"` ### Returns - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.dns.records.list( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ## DNS Record Details `dns.records.get(strdns_record_id, RecordGetParams**kwargs) -> RecordResponse` **get** `/zones/{zone_id}/dns_records/{dns_record_id}` DNS Record Details ### Parameters - `zone_id: str` Identifier. - `dns_record_id: str` Identifier. ### Returns - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record_response = client.dns.records.get( dns_record_id="023e105f4ecef8ad9ca31a8372d0c353", zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(record_response) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } } ``` ## Create DNS Record `dns.records.create(RecordCreateParams**kwargs) -> RecordResponse` **post** `/zones/{zone_id}/dns_records` Create a new DNS record for a zone. Notes: - A/AAAA records cannot exist on the same name as CNAME records. - NS records cannot exist on the same name as any other record type. - Domain names are always represented in Punycode, even if Unicode characters were used when creating the record. ### Parameters - `zone_id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `ttl: TTLParam` 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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[ARecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[SequenceNotStr[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Returns - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record_response = client.dns.records.create( zone_id="023e105f4ecef8ad9ca31a8372d0c353", name="example.com", ttl=3600, type="A", ) print(record_response) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } } ``` ## Overwrite DNS Record `dns.records.update(strdns_record_id, RecordUpdateParams**kwargs) -> RecordResponse` **put** `/zones/{zone_id}/dns_records/{dns_record_id}` Overwrite an existing DNS record. Notes: - A/AAAA records cannot exist on the same name as CNAME records. - NS records cannot exist on the same name as any other record type. - Domain names are always represented in Punycode, even if Unicode characters were used when creating the record. ### Parameters - `zone_id: str` Identifier. - `dns_record_id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `ttl: TTLParam` 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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[ARecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[SequenceNotStr[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Returns - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record_response = client.dns.records.update( dns_record_id="023e105f4ecef8ad9ca31a8372d0c353", zone_id="023e105f4ecef8ad9ca31a8372d0c353", name="example.com", ttl=3600, type="A", ) print(record_response) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } } ``` ## Update DNS Record `dns.records.edit(strdns_record_id, RecordEditParams**kwargs) -> RecordResponse` **patch** `/zones/{zone_id}/dns_records/{dns_record_id}` Update an existing DNS record. Notes: - A/AAAA records cannot exist on the same name as CNAME records. - NS records cannot exist on the same name as any other record type. - Domain names are always represented in Punycode, even if Unicode characters were used when creating the record. ### Parameters - `zone_id: str` Identifier. - `dns_record_id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `ttl: TTLParam` 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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[ARecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[SequenceNotStr[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Returns - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record_response = client.dns.records.edit( dns_record_id="023e105f4ecef8ad9ca31a8372d0c353", zone_id="023e105f4ecef8ad9ca31a8372d0c353", name="example.com", ttl=3600, type="A", ) print(record_response) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } } ``` ## Delete DNS Record `dns.records.delete(strdns_record_id, RecordDeleteParams**kwargs) -> RecordDeleteResponse` **delete** `/zones/{zone_id}/dns_records/{dns_record_id}` Delete DNS Record ### Parameters - `zone_id: str` Identifier. - `dns_record_id: str` Identifier. ### Returns - `class RecordDeleteResponse: …` - `id: Optional[str]` Identifier. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) record = client.dns.records.delete( dns_record_id="023e105f4ecef8ad9ca31a8372d0c353", zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(record.id) ``` #### Response ```json { "result": { "id": "023e105f4ecef8ad9ca31a8372d0c353" } } ``` ## Export DNS Records `dns.records.export(RecordExportParams**kwargs) -> RecordExportResponse` **get** `/zones/{zone_id}/dns_records/export` You can export your [BIND config](https://en.wikipedia.org/wiki/Zone_file "Zone file") through this endpoint. See [the documentation](https://developers.cloudflare.com/dns/manage-dns-records/how-to/import-and-export/ "Import and export records") for more information. ### Parameters - `zone_id: str` Identifier. ### Returns - `str` Exported BIND zone file. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.dns.records.export( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response) ``` ## Import DNS Records `dns.records.import_(RecordImportParams**kwargs) -> RecordImportResponse` **post** `/zones/{zone_id}/dns_records/import` You can upload your [BIND config](https://en.wikipedia.org/wiki/Zone_file "Zone file") through this endpoint. It assumes that cURL is called from a location with bind_config.txt (valid BIND config) present. See [the documentation](https://developers.cloudflare.com/dns/manage-dns-records/how-to/import-and-export/ "Import and export records") for more information. ### Parameters - `zone_id: str` Identifier. - `file: str` BIND config to import. **Tip:** When using cURL, a file can be uploaded using `--form 'file=@bind_config.txt'`. - `proxied: Optional[str]` Whether or not proxiable records should receive the performance and security benefits of Cloudflare. The value should be either `true` or `false`. ### Returns - `class RecordImportResponse: …` - `recs_added: Optional[float]` Number of DNS records added. - `total_records_parsed: Optional[float]` Total number of DNS records parsed. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.dns.records.import_( zone_id="023e105f4ecef8ad9ca31a8372d0c353", file="www.example.com. 300 IN A 127.0.0.1", ) print(response.recs_added) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "recs_added": 5, "total_records_parsed": 5 } } ``` ## Scan DNS Records `dns.records.scan(RecordScanParams**kwargs) -> RecordScanResponse` **post** `/zones/{zone_id}/dns_records/scan` Scan for common DNS records on your domain and automatically add them to your zone. Useful if you haven't updated your nameservers yet. ### Parameters - `zone_id: str` Identifier. - `body: object` ### Returns - `class RecordScanResponse: …` - `recs_added: Optional[float]` Number of DNS records added. - `total_records_parsed: Optional[float]` Total number of DNS records parsed. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.dns.records.scan( zone_id="023e105f4ecef8ad9ca31a8372d0c353", body={}, ) print(response.recs_added) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "recs_added": 5, "total_records_parsed": 5 } } ``` ## Trigger DNS Record Scan `dns.records.scan_trigger(RecordScanTriggerParams**kwargs) -> RecordScanTriggerResponse` **post** `/zones/{zone_id}/dns_records/scan/trigger` Initiates an asynchronous scan for common DNS records on your domain. Note that this **does not** automatically add records to your zone. The scan runs in the background, and results can be reviewed later using the `/scan/review` endpoints. Useful if you haven't updated your nameservers yet. ### Parameters - `zone_id: str` Identifier. ### Returns - `class RecordScanTriggerResponse: …` - `errors: List[Error]` - `code: int` - `message: str` - `documentation_url: Optional[str]` - `source: Optional[ErrorSource]` - `pointer: Optional[str]` - `messages: List[Message]` - `code: int` - `message: str` - `documentation_url: Optional[str]` - `source: Optional[MessageSource]` - `pointer: Optional[str]` - `success: Literal[true]` Whether the API call was successful. - `true` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.dns.records.scan_trigger( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.errors) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true } ``` ## Review Scanned DNS Records `dns.records.scan_review(RecordScanReviewParams**kwargs) -> RecordScanReviewResponse` **post** `/zones/{zone_id}/dns_records/scan/review` Accept or reject DNS records found by the DNS records scan. Accepted records will be permanently added to the zone, while rejected records will be permanently deleted. ### Parameters - `zone_id: str` Identifier. - `accepts: Optional[Iterable[Accept]]` - `class ARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class AAAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["AAAA"]` Record type. - `"AAAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv6 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CNAMERecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CNAME"]` Record type. - `"CNAME"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid hostname. Must not match the record's name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `flatten_cname: Optional[bool]` 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. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class MXRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["MX"]` Record type. - `"MX"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid mail server hostname. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class NSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["NS"]` Record type. - `"NS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid name server host name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class AcceptDNSRecordsOpenpgpkeyRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `ttl: TTLParam` 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. - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[AcceptDNSRecordsOpenpgpkeyRecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[SequenceNotStr[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["PTR"]` Record type. - `"PTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Domain name pointing to the address. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class TXTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["TXT"]` Record type. - `"TXT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` 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 . - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CAA"]` Record type. - `"CAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CAA content. See 'data' to set CAA properties. - `data: Optional[Data]` Components of a CAA record. - `flags: Optional[float]` Flags for the CAA record. - `tag: Optional[str]` Name of the property controlled by this record (e.g.: issue, issuewild, iodef). - `value: Optional[str]` Value of the record. This field's semantics depend on the chosen tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CERTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CERT"]` Record type. - `"CERT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CERT content. See 'data' to set CERT properties. - `data: Optional[Data]` Components of a CERT record. - `algorithm: Optional[float]` Algorithm. - `certificate: Optional[str]` Certificate. - `key_tag: Optional[float]` Key Tag. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class DNSKEYRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["DNSKEY"]` Record type. - `"DNSKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DNSKEY content. See 'data' to set DNSKEY properties. - `data: Optional[Data]` Components of a DNSKEY record. - `algorithm: Optional[float]` Algorithm. - `flags: Optional[float]` Flags. - `protocol: Optional[float]` Protocol. - `public_key: Optional[str]` Public Key. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class DSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["DS"]` Record type. - `"DS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DS content. See 'data' to set DS properties. - `data: Optional[Data]` Components of a DS record. - `algorithm: Optional[float]` Algorithm. - `digest: Optional[str]` Digest. - `digest_type: Optional[float]` Digest Type. - `key_tag: Optional[float]` Key Tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class HTTPSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["HTTPS"]` Record type. - `"HTTPS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted HTTPS content. See 'data' to set HTTPS properties. - `data: Optional[Data]` Components of a HTTPS record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class LOCRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["LOC"]` Record type. - `"LOC"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted LOC content. See 'data' to set LOC properties. - `data: Optional[Data]` Components of a LOC record. - `altitude: Optional[float]` Altitude of location in meters. - `lat_degrees: Optional[float]` Degrees of latitude. - `lat_direction: Optional[Literal["N", "S"]]` Latitude direction. - `"N"` - `"S"` - `lat_minutes: Optional[float]` Minutes of latitude. - `lat_seconds: Optional[float]` Seconds of latitude. - `long_degrees: Optional[float]` Degrees of longitude. - `long_direction: Optional[Literal["E", "W"]]` Longitude direction. - `"E"` - `"W"` - `long_minutes: Optional[float]` Minutes of longitude. - `long_seconds: Optional[float]` Seconds of longitude. - `precision_horz: Optional[float]` Horizontal precision of location. - `precision_vert: Optional[float]` Vertical precision of location. - `size: Optional[float]` Size of location in meters. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class NAPTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["NAPTR"]` Record type. - `"NAPTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted NAPTR content. See 'data' to set NAPTR properties. - `data: Optional[Data]` Components of a NAPTR record. - `flags: Optional[str]` Flags. - `order: Optional[float]` Order. - `preference: Optional[float]` Preference. - `regex: Optional[str]` Regex. - `replacement: Optional[str]` Replacement. - `service: Optional[str]` Service. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SMIMEARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SMIMEA"]` Record type. - `"SMIMEA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SMIMEA content. See 'data' to set SMIMEA properties. - `data: Optional[Data]` Components of a SMIMEA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SRVRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SRV"]` Record type. - `"SRV"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Priority, weight, port, and SRV target. See 'data' for setting the individual component values. - `data: Optional[Data]` Components of a SRV record. - `port: Optional[float]` The port of the service. - `priority: Optional[float]` 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. - `target: Optional[str]` A valid hostname. - `weight: Optional[float]` The record weight. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SSHFPRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SSHFP"]` Record type. - `"SSHFP"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SSHFP content. See 'data' to set SSHFP properties. - `data: Optional[Data]` Components of a SSHFP record. - `algorithm: Optional[float]` Algorithm. - `fingerprint: Optional[str]` Fingerprint. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SVCBRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SVCB"]` Record type. - `"SVCB"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SVCB content. See 'data' to set SVCB properties. - `data: Optional[Data]` Components of a SVCB record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class TLSARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["TLSA"]` Record type. - `"TLSA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted TLSA content. See 'data' to set TLSA properties. - `data: Optional[Data]` Components of a TLSA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class URIRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["URI"]` Record type. - `"URI"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted URI content. See 'data' to set URI properties. - `data: Optional[Data]` Components of a URI record. - `target: Optional[str]` The record content. - `weight: Optional[float]` The record weight. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `rejects: Optional[Iterable[Reject]]` - `id: str` Identifier. ### Returns - `class RecordScanReviewResponse: …` - `accepts: Optional[List[RecordResponse]]` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `rejects: Optional[List[str]]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.dns.records.scan_review( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.accepts) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "accepts": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "rejects": [ "023e105f4ecef8ad9ca31a8372d0c353" ] } } ``` ## List Scanned DNS Records `dns.records.scan_list(RecordScanListParams**kwargs) -> SyncSinglePage[RecordResponse]` **get** `/zones/{zone_id}/dns_records/scan/review` Retrieves the list of DNS records discovered up to this point by the asynchronous scan. These records are temporary until explicitly accepted or rejected via `POST /scan/review`. Additional records may be discovered by the scan later. ### Parameters - `zone_id: str` Identifier. ### Returns - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.dns.records.scan_list( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ## Batch DNS Records `dns.records.batch(RecordBatchParams**kwargs) -> RecordBatchResponse` **post** `/zones/{zone_id}/dns_records/batch` Send a Batch of DNS Record API calls to be executed together. Notes: - Although Cloudflare will execute the batched operations in a single database transaction, Cloudflare's distributed KV store must treat each record change as a single key-value pair. This means that the propagation of changes is not atomic. See [the documentation](https://developers.cloudflare.com/dns/manage-dns-records/how-to/batch-record-changes/ "Batch DNS records") for more information. - The operations you specify within the /batch request body are always executed in the following order: - Deletes - Patches - Puts - Posts ### Parameters - `zone_id: str` Identifier. - `deletes: Optional[Iterable[Delete]]` - `id: str` Identifier. - `patches: Optional[Iterable[BatchPatchParam]]` - `class ARecord: …` - `id: str` Identifier. - `class AAAARecord: …` - `id: str` Identifier. - `class CNAMERecord: …` - `id: str` Identifier. - `class MXRecord: …` - `id: str` Identifier. - `class NSRecord: …` - `id: str` Identifier. - `class OpenpgpkeyRecord: …` - `id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[OpenpgpkeyRecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `id: str` Identifier. - `class TXTRecord: …` - `id: str` Identifier. - `class CAARecord: …` - `id: str` Identifier. - `class CERTRecord: …` - `id: str` Identifier. - `class DNSKEYRecord: …` - `id: str` Identifier. - `class DSRecord: …` - `id: str` Identifier. - `class HTTPSRecord: …` - `id: str` Identifier. - `class LOCRecord: …` - `id: str` Identifier. - `class NAPTRRecord: …` - `id: str` Identifier. - `class SMIMEARecord: …` - `id: str` Identifier. - `class SRVRecord: …` - `id: str` Identifier. - `class SSHFPRecord: …` - `id: str` Identifier. - `class SVCBRecord: …` - `id: str` Identifier. - `class TLSARecord: …` - `id: str` Identifier. - `class URIRecord: …` - `id: str` Identifier. - `posts: Optional[Iterable[Post]]` - `class ARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class AAAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["AAAA"]` Record type. - `"AAAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv6 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CNAMERecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CNAME"]` Record type. - `"CNAME"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid hostname. Must not match the record's name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `flatten_cname: Optional[bool]` 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. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class MXRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["MX"]` Record type. - `"MX"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid mail server hostname. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class NSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["NS"]` Record type. - `"NS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid name server host name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PostDNSRecordsOpenpgpkeyRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `ttl: TTLParam` 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. - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[PostDNSRecordsOpenpgpkeyRecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[SequenceNotStr[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["PTR"]` Record type. - `"PTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Domain name pointing to the address. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class TXTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["TXT"]` Record type. - `"TXT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` 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 . - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CAA"]` Record type. - `"CAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CAA content. See 'data' to set CAA properties. - `data: Optional[Data]` Components of a CAA record. - `flags: Optional[float]` Flags for the CAA record. - `tag: Optional[str]` Name of the property controlled by this record (e.g.: issue, issuewild, iodef). - `value: Optional[str]` Value of the record. This field's semantics depend on the chosen tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CERTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CERT"]` Record type. - `"CERT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CERT content. See 'data' to set CERT properties. - `data: Optional[Data]` Components of a CERT record. - `algorithm: Optional[float]` Algorithm. - `certificate: Optional[str]` Certificate. - `key_tag: Optional[float]` Key Tag. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class DNSKEYRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["DNSKEY"]` Record type. - `"DNSKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DNSKEY content. See 'data' to set DNSKEY properties. - `data: Optional[Data]` Components of a DNSKEY record. - `algorithm: Optional[float]` Algorithm. - `flags: Optional[float]` Flags. - `protocol: Optional[float]` Protocol. - `public_key: Optional[str]` Public Key. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class DSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["DS"]` Record type. - `"DS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DS content. See 'data' to set DS properties. - `data: Optional[Data]` Components of a DS record. - `algorithm: Optional[float]` Algorithm. - `digest: Optional[str]` Digest. - `digest_type: Optional[float]` Digest Type. - `key_tag: Optional[float]` Key Tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class HTTPSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["HTTPS"]` Record type. - `"HTTPS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted HTTPS content. See 'data' to set HTTPS properties. - `data: Optional[Data]` Components of a HTTPS record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class LOCRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["LOC"]` Record type. - `"LOC"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted LOC content. See 'data' to set LOC properties. - `data: Optional[Data]` Components of a LOC record. - `altitude: Optional[float]` Altitude of location in meters. - `lat_degrees: Optional[float]` Degrees of latitude. - `lat_direction: Optional[Literal["N", "S"]]` Latitude direction. - `"N"` - `"S"` - `lat_minutes: Optional[float]` Minutes of latitude. - `lat_seconds: Optional[float]` Seconds of latitude. - `long_degrees: Optional[float]` Degrees of longitude. - `long_direction: Optional[Literal["E", "W"]]` Longitude direction. - `"E"` - `"W"` - `long_minutes: Optional[float]` Minutes of longitude. - `long_seconds: Optional[float]` Seconds of longitude. - `precision_horz: Optional[float]` Horizontal precision of location. - `precision_vert: Optional[float]` Vertical precision of location. - `size: Optional[float]` Size of location in meters. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class NAPTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["NAPTR"]` Record type. - `"NAPTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted NAPTR content. See 'data' to set NAPTR properties. - `data: Optional[Data]` Components of a NAPTR record. - `flags: Optional[str]` Flags. - `order: Optional[float]` Order. - `preference: Optional[float]` Preference. - `regex: Optional[str]` Regex. - `replacement: Optional[str]` Replacement. - `service: Optional[str]` Service. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SMIMEARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SMIMEA"]` Record type. - `"SMIMEA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SMIMEA content. See 'data' to set SMIMEA properties. - `data: Optional[Data]` Components of a SMIMEA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SRVRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SRV"]` Record type. - `"SRV"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Priority, weight, port, and SRV target. See 'data' for setting the individual component values. - `data: Optional[Data]` Components of a SRV record. - `port: Optional[float]` The port of the service. - `priority: Optional[float]` 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. - `target: Optional[str]` A valid hostname. - `weight: Optional[float]` The record weight. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SSHFPRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SSHFP"]` Record type. - `"SSHFP"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SSHFP content. See 'data' to set SSHFP properties. - `data: Optional[Data]` Components of a SSHFP record. - `algorithm: Optional[float]` Algorithm. - `fingerprint: Optional[str]` Fingerprint. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SVCBRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SVCB"]` Record type. - `"SVCB"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SVCB content. See 'data' to set SVCB properties. - `data: Optional[Data]` Components of a SVCB record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class TLSARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["TLSA"]` Record type. - `"TLSA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted TLSA content. See 'data' to set TLSA properties. - `data: Optional[Data]` Components of a TLSA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class URIRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["URI"]` Record type. - `"URI"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted URI content. See 'data' to set URI properties. - `data: Optional[Data]` Components of a URI record. - `target: Optional[str]` The record content. - `weight: Optional[float]` The record weight. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `puts: Optional[Iterable[BatchPutParam]]` - `class ARecord: …` - `id: str` Identifier. - `class AAAARecord: …` - `id: str` Identifier. - `class CNAMERecord: …` - `id: str` Identifier. - `class MXRecord: …` - `id: str` Identifier. - `class NSRecord: …` - `id: str` Identifier. - `class OpenpgpkeyRecord: …` - `id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[OpenpgpkeyRecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `id: str` Identifier. - `class TXTRecord: …` - `id: str` Identifier. - `class CAARecord: …` - `id: str` Identifier. - `class CERTRecord: …` - `id: str` Identifier. - `class DNSKEYRecord: …` - `id: str` Identifier. - `class DSRecord: …` - `id: str` Identifier. - `class HTTPSRecord: …` - `id: str` Identifier. - `class LOCRecord: …` - `id: str` Identifier. - `class NAPTRRecord: …` - `id: str` Identifier. - `class SMIMEARecord: …` - `id: str` Identifier. - `class SRVRecord: …` - `id: str` Identifier. - `class SSHFPRecord: …` - `id: str` Identifier. - `class SVCBRecord: …` - `id: str` Identifier. - `class TLSARecord: …` - `id: str` Identifier. - `class URIRecord: …` - `id: str` Identifier. ### Returns - `class RecordBatchResponse: …` - `deletes: Optional[List[RecordResponse]]` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `patches: Optional[List[RecordResponse]]` - `class A: …` - `class AAAA: …` - `class CNAME: …` - `class MX: …` - `class NS: …` - `class Openpgpkey: …` - `class PTR: …` - `class TXT: …` - `class CAA: …` - `class CERT: …` - `class DNSKEY: …` - `class DS: …` - `class HTTPS: …` - `class LOC: …` - `class NAPTR: …` - `class SMIMEA: …` - `class SRV: …` - `class SSHFP: …` - `class SVCB: …` - `class TLSA: …` - `class URI: …` - `posts: Optional[List[RecordResponse]]` - `class A: …` - `class AAAA: …` - `class CNAME: …` - `class MX: …` - `class NS: …` - `class Openpgpkey: …` - `class PTR: …` - `class TXT: …` - `class CAA: …` - `class CERT: …` - `class DNSKEY: …` - `class DS: …` - `class HTTPS: …` - `class LOC: …` - `class NAPTR: …` - `class SMIMEA: …` - `class SRV: …` - `class SSHFP: …` - `class SVCB: …` - `class TLSA: …` - `class URI: …` - `puts: Optional[List[RecordResponse]]` - `class A: …` - `class AAAA: …` - `class CNAME: …` - `class MX: …` - `class NS: …` - `class Openpgpkey: …` - `class PTR: …` - `class TXT: …` - `class CAA: …` - `class CERT: …` - `class DNSKEY: …` - `class DS: …` - `class HTTPS: …` - `class LOC: …` - `class NAPTR: …` - `class SMIMEA: …` - `class SRV: …` - `class SSHFP: …` - `class SVCB: …` - `class TLSA: …` - `class URI: …` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.dns.records.batch( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.deletes) ``` #### Response ```json { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "deletes": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "patches": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "posts": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ], "puts": [ { "name": "example.com", "ttl": 3600, "type": "A", "comment": "Domain verification record", "content": "198.51.100.4", "private_routing": true, "proxied": true, "settings": { "ipv4_only": true, "ipv6_only": true }, "tags": [ "owner:dns-team" ], "id": "023e105f4ecef8ad9ca31a8372d0c353", "created_on": "2014-01-01T05:20:00.12345Z", "meta": {}, "modified_on": "2014-01-01T05:20:00.12345Z", "proxiable": true, "comment_modified_on": "2024-01-01T05:20:00.12345Z", "tags_modified_on": "2025-01-01T05:20:00.12345Z" } ] } } ``` ## Domain Types ### A Record - `class ARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### AAAA Record - `class AAAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["AAAA"]` Record type. - `"AAAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv6 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Batch Patch - `BatchPatch` - `class ARecord: …` - `id: str` Identifier. - `class AAAARecord: …` - `id: str` Identifier. - `class CNAMERecord: …` - `id: str` Identifier. - `class MXRecord: …` - `id: str` Identifier. - `class NSRecord: …` - `id: str` Identifier. - `class OpenpgpkeyRecord: …` - `id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[OpenpgpkeyRecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `id: str` Identifier. - `class TXTRecord: …` - `id: str` Identifier. - `class CAARecord: …` - `id: str` Identifier. - `class CERTRecord: …` - `id: str` Identifier. - `class DNSKEYRecord: …` - `id: str` Identifier. - `class DSRecord: …` - `id: str` Identifier. - `class HTTPSRecord: …` - `id: str` Identifier. - `class LOCRecord: …` - `id: str` Identifier. - `class NAPTRRecord: …` - `id: str` Identifier. - `class SMIMEARecord: …` - `id: str` Identifier. - `class SRVRecord: …` - `id: str` Identifier. - `class SSHFPRecord: …` - `id: str` Identifier. - `class SVCBRecord: …` - `id: str` Identifier. - `class TLSARecord: …` - `id: str` Identifier. - `class URIRecord: …` - `id: str` Identifier. ### Batch Put - `BatchPut` - `class ARecord: …` - `id: str` Identifier. - `class AAAARecord: …` - `id: str` Identifier. - `class CNAMERecord: …` - `id: str` Identifier. - `class MXRecord: …` - `id: str` Identifier. - `class NSRecord: …` - `id: str` Identifier. - `class OpenpgpkeyRecord: …` - `id: str` Identifier. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[OpenpgpkeyRecordSettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `id: str` Identifier. - `class TXTRecord: …` - `id: str` Identifier. - `class CAARecord: …` - `id: str` Identifier. - `class CERTRecord: …` - `id: str` Identifier. - `class DNSKEYRecord: …` - `id: str` Identifier. - `class DSRecord: …` - `id: str` Identifier. - `class HTTPSRecord: …` - `id: str` Identifier. - `class LOCRecord: …` - `id: str` Identifier. - `class NAPTRRecord: …` - `id: str` Identifier. - `class SMIMEARecord: …` - `id: str` Identifier. - `class SRVRecord: …` - `id: str` Identifier. - `class SSHFPRecord: …` - `id: str` Identifier. - `class SVCBRecord: …` - `id: str` Identifier. - `class TLSARecord: …` - `id: str` Identifier. - `class URIRecord: …` - `id: str` Identifier. ### CAA Record - `class CAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["CAA"]` Record type. - `"CAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CAA content. See 'data' to set CAA properties. - `data: Optional[Data]` Components of a CAA record. - `flags: Optional[float]` Flags for the CAA record. - `tag: Optional[str]` Name of the property controlled by this record (e.g.: issue, issuewild, iodef). - `value: Optional[str]` Value of the record. This field's semantics depend on the chosen tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### CERT Record - `class CERTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["CERT"]` Record type. - `"CERT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CERT content. See 'data' to set CERT properties. - `data: Optional[Data]` Components of a CERT record. - `algorithm: Optional[float]` Algorithm. - `certificate: Optional[str]` Certificate. - `key_tag: Optional[float]` Key Tag. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### CNAME Record - `class CNAMERecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["CNAME"]` Record type. - `"CNAME"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid hostname. Must not match the record's name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `flatten_cname: Optional[bool]` 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. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### DNSKEY Record - `class DNSKEYRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["DNSKEY"]` Record type. - `"DNSKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DNSKEY content. See 'data' to set DNSKEY properties. - `data: Optional[Data]` Components of a DNSKEY record. - `algorithm: Optional[float]` Algorithm. - `flags: Optional[float]` Flags. - `protocol: Optional[float]` Protocol. - `public_key: Optional[str]` Public Key. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### DS Record - `class DSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["DS"]` Record type. - `"DS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DS content. See 'data' to set DS properties. - `data: Optional[Data]` Components of a DS record. - `algorithm: Optional[float]` Algorithm. - `digest: Optional[str]` Digest. - `digest_type: Optional[float]` Digest Type. - `key_tag: Optional[float]` Key Tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### HTTPS Record - `class HTTPSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["HTTPS"]` Record type. - `"HTTPS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted HTTPS content. See 'data' to set HTTPS properties. - `data: Optional[Data]` Components of a HTTPS record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### LOC Record - `class LOCRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["LOC"]` Record type. - `"LOC"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted LOC content. See 'data' to set LOC properties. - `data: Optional[Data]` Components of a LOC record. - `altitude: Optional[float]` Altitude of location in meters. - `lat_degrees: Optional[float]` Degrees of latitude. - `lat_direction: Optional[Literal["N", "S"]]` Latitude direction. - `"N"` - `"S"` - `lat_minutes: Optional[float]` Minutes of latitude. - `lat_seconds: Optional[float]` Seconds of latitude. - `long_degrees: Optional[float]` Degrees of longitude. - `long_direction: Optional[Literal["E", "W"]]` Longitude direction. - `"E"` - `"W"` - `long_minutes: Optional[float]` Minutes of longitude. - `long_seconds: Optional[float]` Seconds of longitude. - `precision_horz: Optional[float]` Horizontal precision of location. - `precision_vert: Optional[float]` Vertical precision of location. - `size: Optional[float]` Size of location in meters. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### MX Record - `class MXRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["MX"]` Record type. - `"MX"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid mail server hostname. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### NAPTR Record - `class NAPTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["NAPTR"]` Record type. - `"NAPTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted NAPTR content. See 'data' to set NAPTR properties. - `data: Optional[Data]` Components of a NAPTR record. - `flags: Optional[str]` Flags. - `order: Optional[float]` Order. - `preference: Optional[float]` Preference. - `regex: Optional[str]` Regex. - `replacement: Optional[str]` Replacement. - `service: Optional[str]` Service. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### NS Record - `class NSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["NS"]` Record type. - `"NS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid name server host name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### PTR Record - `class PTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["PTR"]` Record type. - `"PTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Domain name pointing to the address. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Record - `Record` - `class ARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["A"]` Record type. - `"A"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv4 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class AAAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["AAAA"]` Record type. - `"AAAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid IPv6 address. - `private_routing: Optional[bool]` Enables private network routing to the origin. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CNAMERecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CNAME"]` Record type. - `"CNAME"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid hostname. Must not match the record's name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `flatten_cname: Optional[bool]` 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. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class MXRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["MX"]` Record type. - `"MX"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid mail server hostname. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class NSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["NS"]` Record type. - `"NS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A valid name server host name. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class Openpgpkey: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[OpenpgpkeySettings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class PTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["PTR"]` Record type. - `"PTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Domain name pointing to the address. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class TXTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["TXT"]` Record type. - `"TXT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` 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 . - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CAARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CAA"]` Record type. - `"CAA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CAA content. See 'data' to set CAA properties. - `data: Optional[Data]` Components of a CAA record. - `flags: Optional[float]` Flags for the CAA record. - `tag: Optional[str]` Name of the property controlled by this record (e.g.: issue, issuewild, iodef). - `value: Optional[str]` Value of the record. This field's semantics depend on the chosen tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class CERTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["CERT"]` Record type. - `"CERT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted CERT content. See 'data' to set CERT properties. - `data: Optional[Data]` Components of a CERT record. - `algorithm: Optional[float]` Algorithm. - `certificate: Optional[str]` Certificate. - `key_tag: Optional[float]` Key Tag. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class DNSKEYRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["DNSKEY"]` Record type. - `"DNSKEY"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DNSKEY content. See 'data' to set DNSKEY properties. - `data: Optional[Data]` Components of a DNSKEY record. - `algorithm: Optional[float]` Algorithm. - `flags: Optional[float]` Flags. - `protocol: Optional[float]` Protocol. - `public_key: Optional[str]` Public Key. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class DSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["DS"]` Record type. - `"DS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted DS content. See 'data' to set DS properties. - `data: Optional[Data]` Components of a DS record. - `algorithm: Optional[float]` Algorithm. - `digest: Optional[str]` Digest. - `digest_type: Optional[float]` Digest Type. - `key_tag: Optional[float]` Key Tag. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class HTTPSRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["HTTPS"]` Record type. - `"HTTPS"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted HTTPS content. See 'data' to set HTTPS properties. - `data: Optional[Data]` Components of a HTTPS record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class LOCRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["LOC"]` Record type. - `"LOC"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted LOC content. See 'data' to set LOC properties. - `data: Optional[Data]` Components of a LOC record. - `altitude: Optional[float]` Altitude of location in meters. - `lat_degrees: Optional[float]` Degrees of latitude. - `lat_direction: Optional[Literal["N", "S"]]` Latitude direction. - `"N"` - `"S"` - `lat_minutes: Optional[float]` Minutes of latitude. - `lat_seconds: Optional[float]` Seconds of latitude. - `long_degrees: Optional[float]` Degrees of longitude. - `long_direction: Optional[Literal["E", "W"]]` Longitude direction. - `"E"` - `"W"` - `long_minutes: Optional[float]` Minutes of longitude. - `long_seconds: Optional[float]` Seconds of longitude. - `precision_horz: Optional[float]` Horizontal precision of location. - `precision_vert: Optional[float]` Vertical precision of location. - `size: Optional[float]` Size of location in meters. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class NAPTRRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["NAPTR"]` Record type. - `"NAPTR"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted NAPTR content. See 'data' to set NAPTR properties. - `data: Optional[Data]` Components of a NAPTR record. - `flags: Optional[str]` Flags. - `order: Optional[float]` Order. - `preference: Optional[float]` Preference. - `regex: Optional[str]` Regex. - `replacement: Optional[str]` Replacement. - `service: Optional[str]` Service. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SMIMEARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SMIMEA"]` Record type. - `"SMIMEA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SMIMEA content. See 'data' to set SMIMEA properties. - `data: Optional[Data]` Components of a SMIMEA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SRVRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SRV"]` Record type. - `"SRV"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Priority, weight, port, and SRV target. See 'data' for setting the individual component values. - `data: Optional[Data]` Components of a SRV record. - `port: Optional[float]` The port of the service. - `priority: Optional[float]` 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. - `target: Optional[str]` A valid hostname. - `weight: Optional[float]` The record weight. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SSHFPRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SSHFP"]` Record type. - `"SSHFP"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SSHFP content. See 'data' to set SSHFP properties. - `data: Optional[Data]` Components of a SSHFP record. - `algorithm: Optional[float]` Algorithm. - `fingerprint: Optional[str]` Fingerprint. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class SVCBRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["SVCB"]` Record type. - `"SVCB"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SVCB content. See 'data' to set SVCB properties. - `data: Optional[Data]` Components of a SVCB record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class TLSARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["TLSA"]` Record type. - `"TLSA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted TLSA content. See 'data' to set TLSA properties. - `data: Optional[Data]` Components of a TLSA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. - `class URIRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `type: Literal["URI"]` Record type. - `"URI"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted URI content. See 'data' to set URI properties. - `data: Optional[Data]` Components of a URI record. - `target: Optional[str]` The record content. - `weight: Optional[float]` The record weight. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Record Response - `RecordResponse` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. ### Record Tags - `str` Individual tag of the form name:value (the name must consist of only letters, numbers, underscores and hyphens) ### SMIMEA Record - `class SMIMEARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["SMIMEA"]` Record type. - `"SMIMEA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SMIMEA content. See 'data' to set SMIMEA properties. - `data: Optional[Data]` Components of a SMIMEA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### SRV Record - `class SRVRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["SRV"]` Record type. - `"SRV"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Priority, weight, port, and SRV target. See 'data' for setting the individual component values. - `data: Optional[Data]` Components of a SRV record. - `port: Optional[float]` The port of the service. - `priority: Optional[float]` 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. - `target: Optional[str]` A valid hostname. - `weight: Optional[float]` The record weight. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### SSHFP Record - `class SSHFPRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["SSHFP"]` Record type. - `"SSHFP"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SSHFP content. See 'data' to set SSHFP properties. - `data: Optional[Data]` Components of a SSHFP record. - `algorithm: Optional[float]` Algorithm. - `fingerprint: Optional[str]` Fingerprint. - `type: Optional[float]` Type. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### SVCB Record - `class SVCBRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["SVCB"]` Record type. - `"SVCB"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted SVCB content. See 'data' to set SVCB properties. - `data: Optional[Data]` Components of a SVCB record. - `priority: Optional[float]` Priority. - `target: Optional[str]` Target. - `value: Optional[str]` Value. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### TLSA Record - `class TLSARecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["TLSA"]` Record type. - `"TLSA"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted TLSA content. See 'data' to set TLSA properties. - `data: Optional[Data]` Components of a TLSA record. - `certificate: Optional[str]` Certificate. - `matching_type: Optional[float]` Matching Type. - `selector: Optional[float]` Selector. - `usage: Optional[float]` Usage. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### TTL - `Union[float, Literal[1]]` 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. - `float` - `Literal[1]` 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. - `1` ### TXT Record - `class TXTRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["TXT"]` Record type. - `"TXT"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` 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 . - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### URI Record - `class URIRecord: …` - `name: str` Complete DNS record name, including the zone name, in Punycode. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["URI"]` Record type. - `"URI"` - `comment: Optional[str]` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: Optional[str]` Formatted URI content. See 'data' to set URI properties. - `data: Optional[Data]` Components of a URI record. - `target: Optional[str]` The record content. - `weight: Optional[float]` The record weight. - `priority: Optional[float]` 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. - `proxied: Optional[bool]` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: Optional[Settings]` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: Optional[List[RecordTags]]` Custom tags for the DNS record. This field has no effect on DNS responses. ### Record Delete Response - `class RecordDeleteResponse: …` - `id: Optional[str]` Identifier. ### Record Export Response - `str` Exported BIND zone file. ### Record Import Response - `class RecordImportResponse: …` - `recs_added: Optional[float]` Number of DNS records added. - `total_records_parsed: Optional[float]` Total number of DNS records parsed. ### Record Scan Response - `class RecordScanResponse: …` - `recs_added: Optional[float]` Number of DNS records added. - `total_records_parsed: Optional[float]` Total number of DNS records parsed. ### Record Scan Trigger Response - `class RecordScanTriggerResponse: …` - `errors: List[Error]` - `code: int` - `message: str` - `documentation_url: Optional[str]` - `source: Optional[ErrorSource]` - `pointer: Optional[str]` - `messages: List[Message]` - `code: int` - `message: str` - `documentation_url: Optional[str]` - `source: Optional[MessageSource]` - `pointer: Optional[str]` - `success: Literal[true]` Whether the API call was successful. - `true` ### Record Scan Review Response - `class RecordScanReviewResponse: …` - `accepts: Optional[List[RecordResponse]]` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `rejects: Optional[List[str]]` ### Record Batch Response - `class RecordBatchResponse: …` - `deletes: Optional[List[RecordResponse]]` - `class A: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class AAAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CNAME: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class MX: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class Openpgpkey: …` - `id: str` Identifier. - `comment: str` Comments or notes about the DNS record. This field has no effect on DNS responses. - `content: str` A single Base64-encoded OpenPGP Transferable Public Key (RFC 4880 Section 11.1) - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `name: str` Complete DNS record name, including the zone name, in Punycode. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `proxied: bool` Whether the record is receiving the performance and security benefits of Cloudflare. - `settings: OpenpgpkeySettings` Settings for the DNS record. - `ipv4_only: Optional[bool]` 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. - `ipv6_only: Optional[bool]` 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. - `tags: List[RecordTags]` Custom tags for the DNS record. This field has no effect on DNS responses. - `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. - `float` - `Literal[1]` 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. - `1` - `type: Literal["OPENPGPKEY"]` Record type. - `"OPENPGPKEY"` - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class PTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TXT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CAA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class CERT: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DNSKEY: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class DS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class HTTPS: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class LOC: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class NAPTR: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SMIMEA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SRV: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SSHFP: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class SVCB: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class TLSA: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `class URI: …` - `id: str` Identifier. - `created_on: datetime` When the record was created. - `meta: object` Extra Cloudflare-specific information about the record. - `modified_on: datetime` When the record was last modified. - `proxiable: bool` Whether the record can be proxied by Cloudflare or not. - `comment_modified_on: Optional[datetime]` When the record comment was last modified. Omitted if there is no comment. - `tags_modified_on: Optional[datetime]` When the record tags were last modified. Omitted if there are no tags. - `patches: Optional[List[RecordResponse]]` - `class A: …` - `class AAAA: …` - `class CNAME: …` - `class MX: …` - `class NS: …` - `class Openpgpkey: …` - `class PTR: …` - `class TXT: …` - `class CAA: …` - `class CERT: …` - `class DNSKEY: …` - `class DS: …` - `class HTTPS: …` - `class LOC: …` - `class NAPTR: …` - `class SMIMEA: …` - `class SRV: …` - `class SSHFP: …` - `class SVCB: …` - `class TLSA: …` - `class URI: …` - `posts: Optional[List[RecordResponse]]` - `class A: …` - `class AAAA: …` - `class CNAME: …` - `class MX: …` - `class NS: …` - `class Openpgpkey: …` - `class PTR: …` - `class TXT: …` - `class CAA: …` - `class CERT: …` - `class DNSKEY: …` - `class DS: …` - `class HTTPS: …` - `class LOC: …` - `class NAPTR: …` - `class SMIMEA: …` - `class SRV: …` - `class SSHFP: …` - `class SVCB: …` - `class TLSA: …` - `class URI: …` - `puts: Optional[List[RecordResponse]]` - `class A: …` - `class AAAA: …` - `class CNAME: …` - `class MX: …` - `class NS: …` - `class Openpgpkey: …` - `class PTR: …` - `class TXT: …` - `class CAA: …` - `class CERT: …` - `class DNSKEY: …` - `class DS: …` - `class HTTPS: …` - `class LOC: …` - `class NAPTR: …` - `class SMIMEA: …` - `class SRV: …` - `class SSHFP: …` - `class SVCB: …` - `class TLSA: …` - `class URI: …`