:doc:`Keyspaces <../../keyspaces>` / Client / delete_table

************
delete_table
************



.. py:method:: Keyspaces.Client.delete_table(**kwargs)

  

  The ``DeleteTable`` operation deletes a table and all of its data. After a ``DeleteTable`` request is received, the specified table is in the ``DELETING`` state until Amazon Keyspaces completes the deletion. If the table is in the ``ACTIVE`` state, you can delete it. If a table is either in the ``CREATING`` or ``UPDATING`` states, then Amazon Keyspaces returns a ``ResourceInUseException``. If the specified table does not exist, Amazon Keyspaces returns a ``ResourceNotFoundException``. If the table is already in the ``DELETING`` state, no error is returned.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/keyspaces-2022-02-10/DeleteTable>`_  


  **Request Syntax**
  ::

    response = client.delete_table(
        keyspaceName='string',
        tableName='string'
    )
    
  :type keyspaceName: string
  :param keyspaceName: **[REQUIRED]** 

    The name of the keyspace of the to be deleted table.

    

  
  :type tableName: string
  :param tableName: **[REQUIRED]** 

    The name of the table to be deleted.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`Keyspaces.Client.exceptions.ValidationException`

  
  *   :py:class:`Keyspaces.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`Keyspaces.Client.exceptions.InternalServerException`

  
  *   :py:class:`Keyspaces.Client.exceptions.ConflictException`

  
  *   :py:class:`Keyspaces.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`Keyspaces.Client.exceptions.ResourceNotFoundException`

  