🌎
you are here
Somehow, adding a new record to Route53 takes 100 lines of Python. So now it only takes one.
>>> from youarehere import create_record
>>> create_record("A", "foo.example.com", "4.4.4.4")
You can also easily point a record to the current machine:
>>> from youarehere import point_record_to_here
>>> point_record_to_here("foo.example.com")
use case
You have a Raspberry Pi that travels around and you want to keep a pointer to it in Route53. Add this as a cron-job:
$ python3 -c "point_record_to_here('my-pi.example.com')"
create_record
Arguments
Argument | Type | Default | Description |
---|---|---|---|
record_type | str |
The type of the record to add (e.g. A, CNAME, etc). For an exhaustive list, see youarehere.VALID_RECORD_TYPES . |
|
name | str |
The DNS record name (e.g. "foo.example.com" ) |
|
destination |
str / List[str]
|
The destination IP or values (e.g. ["4.4.4.4", "8.8.8.8"] ). If you provide a single string, it will be treated as an Array[1]. |
|
hosted_zone_id | str |
None | ID of the hosted zone to which to add this record. Guess automatically by default, or use youarehere.guess_hosted_zone_id_for_name . |
comment | str |
"" | An optional comment for the change request (e.g. "Baby's first DNS record!" ) |
ttl | int |
300 | The TTL for your record; defaults to 300 which is probably too low. |
Documentation auto-generated with docshund
, bork bork.
CLI Usage
Examples:
Point 'test.example.com' to the current machine:
$ youarehere test.example.com
Point 'test.example.com' to the IP 93.184.216.34
$ youarehere test.example.com 93.184.216.34
Point 'test.example.com' to a set of IPs in descending order, with a TTL of 6000 seconds.
$ youarehere test.example.com 93.184.216.34,93.184.216.35 --ttl 6000
Argument | Description |
---|---|
name | Record to add (e.g. "test.example.com") |
destination | IP destination. Default: Current global IP. |
Flag | Description |
---|---|
--type | (A) The type of record to add |
--ttl | (300) The TTL of the new DNS record |
--dry-run | (False) Print and quit without making changes |