Amazon Route 53 Domains

{'Availability': {'DONT_KNOW'}}

This operation checks the availability of one domain name. You can access this API without authenticating. Note that if the availability status of a domain is pending, you must submit another request to determine the availability of the domain name.

Request Syntax

client.check_domain_availability(
    DomainName='string',
    IdnLangCode='string'
)

type DomainName

string

param DomainName

[REQUIRED]

The name of a domain.

Type: String

Default: None

Constraints: The domain name can contain only the letters a through z, the numbers 0 through 9, and hyphen (-). Internationalized Domain Names are not supported.

Required: Yes

type IdnLangCode

string

param IdnLangCode

Reserved for future use.

rtype

dict

returns

Response Syntax

{
    'Availability': 'AVAILABLE'|'AVAILABLE_RESERVED'|'AVAILABLE_PREORDER'|'UNAVAILABLE'|'UNAVAILABLE_PREMIUM'|'UNAVAILABLE_RESTRICTED'|'RESERVED'|'DONT_KNOW'
}

Response Structure

• (dict) --

  The CheckDomainAvailability response includes the following elements.

  • Availability (string) --

    Whether the domain name is available for registering.

    Note

    You can only register domains designated as AVAILABLE .

    Type: String

    Valid values:

    • AVAILABLE – The domain name is available.

    • AVAILABLE_RESERVED – The domain name is reserved under specific conditions.

    • AVAILABLE_PREORDER – The domain name is available and can be preordered.

    • UNAVAILABLE – The domain name is not available.

    • UNAVAILABLE_PREMIUM – The domain name is not available.

    • UNAVAILABLE_RESTRICTED – The domain name is forbidden.

    • RESERVED – The domain name has been reserved for another person or organization.

    • DONT_KNOW – The TLD registry didn't reply with a definitive answer about whether the domain name is available. Amazon Route 53 can return this response for a variety of reasons, for example, the registry is performing maintenance. Try again later.