:doc:`StorageGateway <../../storagegateway>` / Client / delete_tape_pool

****************
delete_tape_pool
****************



.. py:method:: StorageGateway.Client.delete_tape_pool(**kwargs)

  

  Delete a custom tape pool. A custom tape pool can only be deleted if there are no tapes in the pool and if there are no automatic tape creation policies that reference the custom tape pool.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/storagegateway-2013-06-30/DeleteTapePool>`_  


  **Request Syntax**
  ::

    response = client.delete_tape_pool(
        PoolARN='string'
    )
    
  :type PoolARN: string
  :param PoolARN: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the custom tape pool to delete.

    

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

    
    ::

      {
          'PoolARN': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **PoolARN** *(string) --* 

        The Amazon Resource Name (ARN) of the custom tape pool being deleted.

        
  
  **Exceptions**
  
  *   :py:class:`StorageGateway.Client.exceptions.InvalidGatewayRequestException`

  
  *   :py:class:`StorageGateway.Client.exceptions.InternalServerError`

  