Route53Domains / Client / delete_domain

delete_domain#

Route53Domains.Client.delete_domain(**kwargs)#

This operation deletes the specified domain. This action is permanent. For more information, see Deleting a domain name registration.

To transfer the domain registration to another registrar, use the transfer process that’s provided by the registrar to which you want to transfer the registration. Otherwise, the following apply:

  • You can’t get a refund for the cost of a deleted domain registration.

  • The registry for the top-level domain might hold the domain name for a brief time before releasing it for other users to register (varies by registry).

  • When the registration has been deleted, we’ll send you a confirmation to the registrant contact. The email will come from noreply@domainnameverification.net or noreply@registrar.amazon.com.

See also: AWS API Documentation

Request Syntax

response = client.delete_domain(
    DomainName='string'
)
Parameters:

DomainName (string) –

[REQUIRED]

Name of the domain to be deleted.

Return type:

dict

Returns:

Response Syntax

{
    'OperationId': 'string'
}

Response Structure

  • (dict) –

    • OperationId (string) –

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

Exceptions

  • Route53Domains.Client.exceptions.InvalidInput

  • Route53Domains.Client.exceptions.DuplicateRequest

  • Route53Domains.Client.exceptions.TLDRulesViolation

  • Route53Domains.Client.exceptions.UnsupportedTLD