Domains
Domain Clone
https://api.linode.com/v4/domains/{domainId}/clone
Clones a Domain and all associated DNS records from a Domain that is registered in Linode's DNS manager.
Path Parameters
ID of the Domain to clone.
Request Body Schema
The new domain for the clone. 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.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"domain": "example.com"
}' \
https://api.linode.com/v4/domains/123/clone
Response Samples
- 200
- default
{
"status": "active",
"id": 1234,
"description": "",
"type": "master",
"domain": "example.org",
"group": "",
"soa_email": "admin@example.org",
"retry_sec": 300,
"master_ips": [],
"axfr_ips": [],
"expire_sec": 300,
"refresh_sec": 300,
"ttl_sec": 300,
"tags": []
}
Responses
200: A new Domain in Linode's DNS Manager, based on a cloned Domain.
Used to control whether this Domain is currently being rendered.
This Domain's unique ID
A description for this Domain. This is for display purposes only.
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").
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.
The group this Domain belongs to. This is for display purposes only.
Start of Authority email address. This is required for type
master Domains.
The interval, in seconds, at which a failed refresh should be retried.
Valid values are 0, 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.
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.
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.
The amount of time in seconds that may pass before this Domain is no longer authoritative.
Valid values are 0, 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.
The amount of time in seconds before this Domain should be refreshed.
Valid values are 0, 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.
"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, 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.
An array of tags applied to this object. Tags are for organizational purposes only.
default: Error
What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.
The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.