Lightsail web addresses
Lightsail web addresses are subdomains of amazonlightsail.com, such as
mysite.amazonlightsail.com, that are automatically configured for HTTPS traffic.
When you attach a web address to a distribution, Lightsail creates the DNS records and the
SSL/TLS certificate for it, so visitors can reach the distribution over HTTPS. Lightsail manages the
certificate and the DNS records for you: they don't appear with your SSL/TLS certificates or in
your DNS zones, and you can't change them.
Lightsail web addresses are easier and quicker to set up than custom domains. For more information, see Choose a web address or a custom domain.
Web addresses are free while they are attached to your Lightsail resources. Each month, you get 24 hours of free unattached web address time. After that, we charge USD $1 per month for each unattached web address.
A web address name can have one or two parts, separated by a period. For example,
mysite.amazonlightsail.com has one part (mysite), and its child web
address blog.mysite.amazonlightsail.com has two parts (blog and
mysite). For more information, see Child web addresses.
In the Lightsail API and AWS CLI, web addresses are called subdomains. For more information, see CreateSubdomain in the Lightsail API Reference.
Contents
Use a web address
To use a web address, attach it to a distribution. To use a web address with an instance, bucket, container service, or load balancer, create a distribution with that resource as its origin. For more information, see Understand distribution origins in Amazon Lightsail.
A web address can be attached to one distribution at a time, and a distribution can have one web address.
For instructions, see the following topics:
How much do web addresses cost?
Web addresses are free while they are attached to your Lightsail resources. Each month, you get 24 hours of free unattached web address time. After that, we charge USD $1 per month for each unattached web address. If your account belongs to an organization in AWS Organizations, the 24 free hours are shared by all the accounts in the organization.
DNS queries to your web addresses count toward your monthly allowance of 3 million DNS queries. If your account belongs to an organization in AWS Organizations, the allowance is shared by all the accounts in the organization. Beyond the allowance, you're charged USD $0.40 per 1 million DNS queries.
Web address statuses
The status of a web address shows whether you can attach, detach, or delete it, or whether
it's waiting for an operation to finish. You can see it on the Lightsail web
addresses page and in the state that GetSubdomains
returns.
- Creating
-
Lightsail is setting up your web address. You can't attach or delete it yet. You aren't charged for it.
- Create failed
-
Lightsail accepted your request but couldn't finish setting up your web address. You aren't charged for it, but it counts toward your quota until you delete it. Delete the web address, and then create it again.
If your request to create a web address fails, for example because the name isn't available, no web address is created, and you get an error right away.
- Unattached
-
Your web address is ready to be attached to a distribution. You can attach or delete it.
- Attaching
-
Lightsail is attaching your web address to a distribution.
- Attached
-
Your web address is attached to a distribution and serves its content over HTTPS.
- Detaching
-
Lightsail is detaching your web address from a resource.
- Transferring
-
Lightsail is moving your web address to a different resource.
- Implicit
-
Reserved for your account because you created a child web address under it. For more information, see Child web addresses.
Child web addresses
A child web address is a web address under one of your web addresses, such as
blog.mysite.amazonlightsail.com under mysite.amazonlightsail.com.
Use one for another site under the same name, such as a blog. A child web address has two
parts, and its parent is the web address with one part.
When you create a child web address, such as blog.mysite.amazonlightsail.com,
and you haven't created its parent, mysite.amazonlightsail.com, Lightsail
reserves mysite.amazonlightsail.com for your account with the
Implicit status, so that no other account can create it. An implicit web
address isn't charged and doesn't count toward your quota of web addresses. To use an implicit
web address, claim it. After you claim it, it counts toward your quota and is charged while it
isn't attached. For instructions, see Claim an implicit web address.
A child web address is a separate web address. You can attach, detach, transfer, and delete a child web address like any other web address. You can't attach a web address and its child web address to the same resource.
You're charged for a child web address while it isn't attached, like any other web address.
To reach one resource at more than one name, such as example.com and
blog.example.com, use a custom domain instead of web addresses. For more
information, see Use a custom domain with your
distribution.
Quotas and considerations
-
You can have up to 30 web addresses in your account.
-
Web addresses that failed to create count toward this quota until you delete them.
-
When you delete a web address that was attached to a distribution, Lightsail holds its name for your account for 30 to 37 days, called the cooldown period. The exact length is random, so that no one can predict when the name becomes available to other accounts. The deleted web address counts toward this quota during that time. For more information, see What happens to the name of a deleted web address.
-
Implicit web addresses don't count toward this quota.
-
You can't increase this quota.
-
Web address names are unique across all AWS accounts. For the naming rules, see Web address naming rules.
-
AWS can take down a web address, or take other action described in the AWS Acceptable Use Policy
, if AWS believes that its name or content violates someone else's rights, such as copyrights or trademarks, or doesn't follow that policy. -
You can attach a web address to one resource at a time. To move a web address to a different resource, transfer it. For instructions, see Transfer a web address using the Lightsail console.
-
You can transfer a web address once every 24 hours. This limit applies to each web address, not to your account.
-
A distribution can use a web address or a custom domain, but not both at the same time. To change from one to the other, see Switch between a web address and a custom domain.
-
Lightsail manages the DNS records for your web address. You can't add or change records, such as MX records for email.
-
Lightsail manages the SSL/TLS certificate for your web address and renews it for you. The certificate doesn't appear with your other Lightsail certificates, and it doesn't count toward your Lightsail certificate quota.
-
Web addresses are global resources. When you use the Lightsail API or the AWS CLI to manage web addresses, specify the US East (N. Virginia) (
us-east-1) AWS Region.