AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
This operation registers a domain. For some top-level domains (TLDs), this operation requires extra parameters.
When you register a domain, Amazon Route 53 does the following:
Creates a Route 53 hosted zone that has the same name as the domain. Route 53 assigns four name servers to your hosted zone and automatically updates your domain registration with the names of these name servers.
Enables auto renew, so your domain registration will renew automatically each year. We'll notify you in advance of the renewal date so you can choose whether to renew the registration.
Optionally enables privacy protection, so WHOIS queries return contact for the registrar
or the phrase "REDACTED FOR PRIVACY", or "On behalf of
While some domains may allow different privacy settings per contact, we recommend specifying the same privacy setting for all contacts.
If registration is successful, returns an operation ID that you can use to track the progress and completion of the action. If the request is not completed successfully, the domain registrant is notified by email.
Charges your Amazon Web Services account an amount based on the top-level domain. For more information, see Amazon Route 53 Pricing.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginRegisterDomain and EndRegisterDomain.
Namespace: Amazon.Route53Domains
Assembly: AWSSDK.Route53Domains.dll
Version: 3.x.y.z
public virtual Task<RegisterDomainResponse> RegisterDomainAsync( RegisterDomainRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the RegisterDomain service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| DomainLimitExceededException | The number of domains has exceeded the allowed threshold for the account. |
| DuplicateRequestException | The request is already in progress for the domain. |
| InvalidInputException | The requested item is not acceptable. For example, for APIs that accept a domain name, the request might specify a domain name that doesn't belong to the account that submitted the request. For AcceptDomainTransferFromAnotherAwsAccount, the password might be invalid. |
| OperationLimitExceededException | The number of operations or jobs running exceeded the allowed threshold for the account. |
| TLDRulesViolationException | The top-level domain does not support this operation. |
| UnsupportedTLDException | Amazon Route 53 does not support this top-level domain (TLD). |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5