LinuxCommandLibrary

aws-route53

Manage Amazon Route 53 domains and records

TLDR

List all hosted zones, private and public

$ aws route53 list-hosted-zones
copy

Show all records in a zone
$ aws route53 list-resource-record-sets --hosted-zone-id [zone_id]
copy

Create a new, public zone using a request identifier to retry the operation safely
$ aws route53 create-hosted-zone --name [name] --caller-reference [request_identifier]
copy

Delete a zone (if the zone has non-defaults SOA and NS records the command will fail)
$ aws route53 delete-hosted-zone --id [zone_id]
copy

Test DNS resolving by Amazon servers of a given zone
$ aws route53 test-dns-answer --hosted-zone-id [zone_id] --record-name [name] --record-type [type]
copy

SYNOPSIS

aws route53 [options] []

PARAMETERS

--profile
    Specifies the AWS profile to use for authentication and authorization.

--region
    Specifies the AWS region to send the request to.

--output
    Specifies the output format (e.g., json, text, table).

--debug
    Enables debug logging.

create-hosted-zone
    Creates a new public or private hosted zone.

delete-hosted-zone
    Deletes an existing hosted zone.

get-hosted-zone
    Retrieves information about a specific hosted zone.

list-hosted-zones
    Lists all hosted zones associated with the current AWS account.

change-resource-record-sets
    Updates or deletes resource record sets within a hosted zone.

list-resource-record-sets
    Lists all resource record sets within a hosted zone.

get-change
    Returns the current status of a change batch request. The request was submitted and idetified by the value of Id.

create-health-check
    Creates a new health check.

delete-health-check
    Deletes a health check.

get-health-check
    Gets a health check.

list-health-checks
    Lists all health checks associated with the current AWS account.

DESCRIPTION

The `aws route53` command is part of the AWS Command Line Interface (CLI) and provides a way to interact with the Amazon Route 53 DNS web service.

It allows users to manage their DNS records, hosted zones, health checks, and domain registrations programmatically. This is useful for automating DNS management tasks, integrating with infrastructure-as-code tools like Terraform or CloudFormation, and managing DNS at scale.

With this command you can create, update, and delete DNS records, retrieve information about your hosted zones and resource record sets, monitor the health of your endpoints, and perform other DNS-related operations.

It provides a powerful tool for integrating DNS management into your automated workflows and improving the overall agility and scalability of your infrastructure.

CAVEATS

Requires the AWS CLI to be installed and configured with appropriate credentials and permissions.
Proper IAM permissions are crucial for executing commands successfully.

AUTHENTICATION

Authentication is handled via AWS CLI configuration. Ensure you have properly configured your credentials using `aws configure`.

ERROR HANDLING

The command returns error messages in JSON format, allowing for programmatic error handling.
Refer to AWS documentation for specific error codes and their meanings.

HISTORY

The `aws route53` command was developed as part of the AWS CLI to provide a command-line interface for managing Route 53, Amazon's scalable DNS web service.
Its development coincides with the growing adoption of cloud computing and the increasing need for programmatic control over DNS infrastructure.
It's evolved alongside Route 53 itself, adding new functionalities and capabilities as Route 53 has expanded its service offerings.

SEE ALSO

aws(1), aws-cli(1)

Copied to clipboard