:doc:`Route53Domains <../../route53domains>` / Client / delete_domain

*************
delete_domain
*************



.. py:method:: Route53Domains.Client.delete_domain(**kwargs)

  

  This operation deletes the specified domain. This action is permanent. For more information, see `Deleting a domain name registration <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-delete.html>`__.

   

  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 <https://docs.aws.amazon.com/goto/WebAPI/route53domains-2014-05-15/DeleteDomain>`_  


  **Request Syntax**
  ::

    response = client.delete_domain(
        DomainName='string'
    )
    
  :type DomainName: string
  :param DomainName: **[REQUIRED]** 

    Name of the domain to be deleted.

    

  
  
  :rtype: 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 <https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_GetOperationDetail.html>`__.

        
  
  **Exceptions**
  
  *   :py:class:`Route53Domains.Client.exceptions.InvalidInput`

  
  *   :py:class:`Route53Domains.Client.exceptions.DuplicateRequest`

  
  *   :py:class:`Route53Domains.Client.exceptions.TLDRulesViolation`

  
  *   :py:class:`Route53Domains.Client.exceptions.UnsupportedTLD`

  