Amazon Route 53 DNS resources provide failover protection by updating an Amazon Route 53 DNS record to point to the new active node’s network interface when a failover occurs.
Resource Type: comm/route53
Aliases: route53
Subcommands
Amazon Route 53 DNS resources are managed by commands of the form:
lkcli resource comm/route53 <subcommand> [flags]
| Subcommand |
Description |
Required Role |
create |
Create a new Route 53 DNS resource |
admin |
extend |
Extend to a standby server |
admin |
get-property |
Read a resource property |
guest |
set-property |
Update an editable resource property |
admin |
create
lkcli resource comm/route53 create \
--domain-name=<string> --host-name=<string> --network-interface=<string> [flags]
| Flag |
Short |
Type |
Required |
Default |
Constraints |
Description |
--domain-name |
— |
string |
Yes |
— |
— |
Domain name of the Route53 hosted zone to protect. You can also specify the hosted zone ID instead of the domain name.
If multiple hosted zones exist for the same domain name, specifying the domain name will result in an error. In this case, please specify the hosted zone ID. |
--host-name |
— |
string |
Yes |
— |
— |
Hostname portion of the DNS record name |
--network-interface |
— |
string |
Yes |
— |
— |
Network interface ID to associate with the DNS A record |
--verify-iam-role |
— |
bool |
No |
true |
— |
Verify IAM role permissions during creation |
--tag |
— |
string |
No |
Auto-generated |
— |
Resource tag name |
--switchback |
— |
enum |
No |
INTELLIGENT |
INTELLIGENT, AUTOMATIC |
Switchback type |
extend
lkcli resource comm/route53 extend \
--network-interface=<string> --primary-sys=<string> --primary-tag=<string> [flags]
| Flag |
Short |
Type |
Required |
Default |
Constraints |
Description |
--network-interface |
— |
string |
Yes |
— |
— |
Network interface ID on the standby server |
--primary-sys |
— |
string |
Yes |
— |
— |
Hostname of the server the existing resource is extended from |
--primary-tag |
— |
string |
Yes |
— |
— |
Tag of the existing resource to extend |
--standby-sys |
— |
string |
No |
Value of --host (defaults to localhost) |
— |
Hostname of the standby server |
--switchback |
— |
enum |
No |
INTELLIGENT |
INTELLIGENT, AUTOMATIC |
Switchback type |
--primary-priority |
— |
int |
No |
Defaults to the current priority of the --primary-sys server, or 1 if the resource has not yet been extended |
min: 1, max: 999 |
Failover priority for the primary server |
--standby-priority |
— |
int |
No |
Defaults to an unused value which is computed dynamically based on the priority values currently in-use |
min: 1, max: 999 |
Failover priority for the standby server |
get-property / set-property
lkcli resource comm/route53 get-property --tag=<string> --property=<string>
lkcli resource comm/route53 set-property --tag=<string> --property=<string> --value=<string>
| Flag |
Short |
Type |
Required |
Description |
--tag |
-t |
string |
Yes |
Resource tag name |
--property |
-p |
string |
Yes |
Property name (see Properties table below) |
--value |
-v |
string |
Yes (set-property only) |
New property value |
Properties
| Property |
Type |
Constraints |
Editable |
Description |
fqdn |
string |
— |
No |
Fully qualified domain name managed by this resource |
hosted-zone-id |
string |
— |
No |
AWS Route 53 hosted zone ID |
network-interface |
string |
— |
No |
Network interface ID associated with the Route 53 resource |
network-interface-guid |
string |
— |
No |
Network interface GUID associated with the Route 53 resource |
kit-name |
string |
— |
No |
Recovery kit name |
quickcheck-interval |
int |
min: 0, max: 604800 |
Yes |
Quickcheck interval in seconds (default: 180) |
local-recovery |
enum |
enabled, disabled |
Yes |
Enable local recovery |
switchback |
enum |
INTELLIGENT, AUTOMATIC |
Yes |
Switchback type |
Example Usage
# Create a Route 53 DNS resource
lkcli resource comm/route53 create \
--host=server1 \
--domain-name=example.com \
--host-name=mycluster \
--network-interface="Ethernet 2" \
--tag=route53-mycluster
# Extend to server2
lkcli resource comm/route53 extend \
--primary-sys=server1 \
--primary-tag=route53-mycluster \
--standby-sys=server2 \
--network-interface="Ethernet 2"
Post your comment on this topic.