An MX (mail exchanger) record maps a domain name to a mail exchanger. A mail exchanger is a server that either delivers or forwards mail. You can specify one or more mail exchangers for a zone, as well as the preference for using each mail exchanger. A standard MX record applies to a particular domain or subdomain.
References to record:mx are object references. The name part of an MX record object reference has the following components:
- Name of the record
- Name of the view
Example: record:mx/ZG5zLmhvc3RjkuMC4xLg:some.name.com/myview
The object does not support the following operations when managed on Cloud Platform members:
These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.
The basic version of the object contains the field(s): mail_exchanger, name, preference, view.
The following fields are required to create this object:
| Field | Notes |
|---|---|
| mail_exchanger | |
| name | |
| preference |
Aws Route 53 record information.
Type
A/An ‘Aws Rte53 Record Info struct.
Search
The field is not available for search.
Notes
The aws_rte53_record_info cannot be updated.
aws_rte53_record_info cannot be written.
Structure containing all cloud API related information for this object.
Type
A/An Cloud Information struct.
Search
The field is not available for search.
Notes
The cloud_info cannot be updated.
cloud_info cannot be written.
Comment for the record; maximum 256 characters.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is empty.
Search
The field is available for search via
The time of the record creation in Epoch seconds format.
Type
Timestamp.
Search
The field is not available for search.
Notes
The creation_time cannot be updated.
creation_time cannot be written.
The record creator.
Note that changing creator from or to ‘SYSTEM’ value is not allowed.
Type
String.
Create
The default value is STATIC.
Search
The field is available for search via
The GSS-TSIG principal that owns this record.
Type
String.
Create
The default value is empty.
Search
The field is available for search via
Determines if the DDNS updates for this record are allowed or not.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
Determines if the record is disabled or not. False means that the record is enabled.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
The Mail exchanger name in punycode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is not available for search.
Notes
The dns_mail_exchanger cannot be updated.
dns_mail_exchanger cannot be written.
The name for a MX record in punycode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is not available for search.
Notes
The dns_name cannot be updated.
dns_name cannot be written.
Extensible attributes associated with the object.
For valid values for extensible attributes, see the following information.
Type
Extensible attributes.
This field allows +/- to be specified as part of the field name when updating the object, see the following information.
Create
The default value is empty.
Search
For how to search extensible attributes, see the following information.
Determines if the reclamation is allowed for the record or not.
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
The time of the last DNS query in Epoch seconds format.
Type
Timestamp.
Search
The field is not available for search.
Notes
The last_queried cannot be updated.
last_queried cannot be written.
Mail exchanger name in FQDN format. This value can be in unicode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The field is required on creation.
Search
The field is available for search via
Notes
The mail_exchanger is part of the base object.
Name for the MX record in FQDN format. This value can be in unicode format.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The field is required on creation.
Search
The field is available for search via
Notes
The name is part of the base object.
Preference value, 0 to 65535 (inclusive) in 32-bit unsigned integer format.
Type
Unsigned integer.
Create
The field is required on creation.
Search
The field is available for search via
Notes
The preference is part of the base object.
Determines if the record is reclaimable or not.
Type
Bool.
Search
The field is available for search via
Notes
The reclaimable cannot be updated.
reclaimable cannot be written.
The Time To Live (TTL) value for record. A 32-bit unsigned integer that represents the duration, in seconds, for which the record is valid (cached). Zero indicates that the record should not be cached.
Type
Unsigned integer.
Create
The default value is empty.
Search
The field is not available for search.
Notes
Use flag for: ttl
Type
Bool.
Create
The default value is False.
Search
The field is not available for search.
The name of the DNS view in which the record resides. Example: “external”.
Type
String.
Values with leading or trailing white space are not valid for this field.
Create
The default value is The default DNS view.
Search
The field is available for search via
Notes
The view is part of the base object.
The name of the zone in which the record resides. Example: “zone.com”. If a view is not specified when searching by zone, the default view is used.
Type
String.
Values with leading or trailing white space are not valid for this field.
Search
The field is available for search via
Notes
The zone cannot be updated.
zone cannot be written.
| Field | Type | Req | R/O | Base | Search |
|---|---|---|---|---|---|
| aws_rte53_record_info | struct | N | Y | N | N/A |
| cloud_info | struct | N | Y | N | N/A |
| comment | String | N | N | N | : = ~ |
| creation_time | Timestamp | N | Y | N | N/A |
| creator | String | N | N | N | = |
| ddns_principal | String | N | N | N | : = ~ |
| ddns_protected | Bool | N | N | N | N/A |
| disable | Bool | N | N | N | N/A |
| dns_mail_exchanger | String | N | Y | N | N/A |
| dns_name | String | N | Y | N | N/A |
| extattrs | Extattr | N | N | N | ext |
| forbid_reclamation | Bool | N | N | N | N/A |
| last_queried | Timestamp | N | Y | N | N/A |
| mail_exchanger | String | Y | N | Y | = ~ |
| name | String | Y | N | Y | : = ~ |
| preference | Unsigned int | Y | N | Y | < = > |
| reclaimable | Bool | N | Y | N | = |
| shared_record_group | String | N | Y | N | N/A |
| ttl | Unsigned int | N | N | N | N/A |
| use_ttl | Bool | N | N | N | N/A |
| view | String | N | N | Y | = |
| zone | String | N | Y | N | = |
