Create a domain

Adds a new Domain to Linode's DNS Manager. Linode is not a registrar, and you must own the domain before adding it here. Be sure to point your registrar to Linode's nameservers so that the records hosted here are used.

linode-cli domains create \ --type master \ --domain example.org \ --soa_email admin@example.org
Learn more...
domains:read_write
Learn more...
Path Params
string
required
Defaults to v4

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Body Params

Information about the domain you are registering.

axfr_ips
array of strings

The list of IPs that may perform a zone transfer for this Domain. The total combined length of all data within this array cannot exceed 1000 characters.

Note. This is potentially dangerous, and should be set to an empty list unless you intend to use it.

axfr_ips
string
length between 1 and 253

A description for this Domain. This is for display purposes only.

string
required
length between 1 and 253

Filterable The domain this Domain represents. Domain labels cannot be longer than 63 characters and must conform to RFC1035. Domains must be unique on Linode's platform, including across different Linode accounts; there cannot be two Domains representing the same domain.

integer
Defaults to 0

The amount of time in seconds that may pass before this Domain is no longer authoritative.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.

  • Any other value is rounded up to the nearest valid value.

  • A value of 0 is equivalent to the default value of 1209600.

master_ips
array of strings

The IP addresses representing the master DNS for this Domain. At least one value is required for type slave Domains. The total combined length of all data within this array cannot exceed 1000 characters.

master_ips
integer
Defaults to 0

The amount of time in seconds before this Domain should be refreshed.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.

  • Any other value is rounded up to the nearest valid value.

  • A value of 0 is equivalent to the default value of 14400.

integer
Defaults to 0

The interval, in seconds, at which a failed refresh should be retried.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.

  • Any other value is rounded up to the nearest valid value.

  • A value of 0 is equivalent to the default value of 14400.

string

Start of Authority email address. This is required for type master Domains.

string
Defaults to active

Used to control whether this Domain is currently being rendered.

tags
array of strings

Filterable An array of tags applied to this object. Tags are for organizational purposes only.

tags
integer
Defaults to 0

"Time to Live" - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
  • Any other value is rounded up to the nearest valid value.
  • A value of 0 is equivalent to the default value of 86400.
string
required

Whether this Domain represents the authoritative source of information for the domain it describes (master), or whether it is a read-only copy of a master (slave).

Responses

Response body
object
axfr_ips
array of strings

The list of IPs that may perform a zone transfer for this Domain. The total combined length of all data within this array cannot exceed 1000 characters.

Note. This is potentially dangerous, and should be set to an empty list unless you intend to use it.

axfr_ips
string
length between 1 and 253

A description for this Domain. This is for display purposes only.

string
length between 1 and 253

Filterable The domain this Domain represents. Domain labels cannot be longer than 63 characters and must conform to RFC1035. Domains must be unique on Linode's platform, including across different Linode accounts; there cannot be two Domains representing the same domain.

integer
Defaults to 0

The amount of time in seconds that may pass before this Domain is no longer authoritative.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.

  • Any other value is rounded up to the nearest valid value.

  • A value of 0 is equivalent to the default value of 1209600.

string
length between 1 and 50
deprecated

Filterable The group this Domain belongs to. This is for display purposes only.

integer

Read-only This Domain's unique ID.

master_ips
array of strings

The IP addresses representing the master DNS for this Domain. At least one value is required for type slave Domains. The total combined length of all data within this array cannot exceed 1000 characters.

master_ips
integer
Defaults to 0

The amount of time in seconds before this Domain should be refreshed.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.

  • Any other value is rounded up to the nearest valid value.

  • A value of 0 is equivalent to the default value of 14400.

integer
Defaults to 0

The interval, in seconds, at which a failed refresh should be retried.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.

  • Any other value is rounded up to the nearest valid value.

  • A value of 0 is equivalent to the default value of 14400.

string

Start of Authority email address. This is required for type master Domains.

string
Defaults to active

Used to control whether this Domain is currently being rendered.

disabled active

tags
array of strings

Filterable An array of tags applied to this object. Tags are for organizational purposes only.

tags
integer
Defaults to 0

"Time to Live" - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers.

  • Valid values are 0, 30, 120, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.
  • Any other value is rounded up to the nearest valid value.
  • A value of 0 is equivalent to the default value of 86400.
string

Whether this Domain represents the authoritative source of information for the domain it describes (master), or whether it is a read-only copy of a master (slave).

master slave

Language
Credentials