Route53Domains / Client / restore_domain

restore_domain

Route53Domains.Client.restore_domain(**kwargs)

Restores a domain that has expired, or was deleted, before it becomes available for others to register. The cost of restoring your domain is billed to your Amazon Web Services account.

Not every TLD registry supports restoring domains, and the period during which a domain can be restored varies by TLD. To find out whether your domain can be restored and the period during which you can restore it, see Domains that you can register with Amazon Route 53 in the Amazon Route 53 Developer Guide.

Warning

Restoring a domain typically costs more, and sometimes much more, than registering or renewing a domain. To get the restoration price for a domain before you restore it, use GetDomainPrices.

Restoration is asynchronous. The response includes an operation ID that you can use with GetOperationDetail to track the progress of the request. When the restoration succeeds, the domain reappears in the response to ListDomains.

For more information, see Restoring an expired or deleted domain in the Amazon Route 53 Developer Guide.

See also: AWS API Documentation

Request Syntax

response = client.restore_domain(
    DomainName='string',
    Consent={
        'MaxPrice': 123.0,
        'Currency': 'string'
    }
)
Parameters:

  • DomainName (string) –

    [REQUIRED]

    The name of the domain that you want to restore. The domain must have been registered to the Amazon Web Services account that submits the request.

  • Consent (dict) –

    Specifies the maximum price that you agree to pay to restore the domain name. This element is required if the domain has registry premium pricing, and optional if the domain is priced at the standard rate for its TLD. If you include it and the restoration price is more than MaxPrice, the request fails.

    • MaxPrice (float) – [REQUIRED]

      The maximum amount that you agree to accept.

    • Currency (string) – [REQUIRED]

      The currency for the MaxPrice.

Return type:

dict

Returns:

Response Syntax

{
    'OperationId': 'string'
}

Response Structure

  • (dict) –

    The RestoreDomain response includes the following element.

    • OperationId (string) –

      Identifier for tracking the progress of the request. To query the operation status, use GetOperationDetail.

Exceptions