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

****************************
retrieve_tape_recovery_point
****************************



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

  

  Retrieves the recovery point for the specified virtual tape. This operation is only supported in the tape gateway type.

   

  A recovery point is a point in time view of a virtual tape at which all the data on the tape is consistent. If your gateway crashes, virtual tapes that have recovery points can be recovered to a new gateway.

   

  .. note::

    

    The virtual tape can be retrieved to only one gateway. The retrieved tape is read-only. The virtual tape can be retrieved to only a tape gateway. There is no charge for retrieving recovery points.

    

  

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


  **Request Syntax**
  ::

    response = client.retrieve_tape_recovery_point(
        TapeARN='string',
        GatewayARN='string'
    )
    
  :type TapeARN: string
  :param TapeARN: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the virtual tape for which you want to retrieve the recovery point.

    

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

    The Amazon Resource Name (ARN) of the gateway. Use the  ListGateways operation to return a list of gateways for your account and Amazon Web Services Region.

    

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

    
    ::

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

    

    - *(dict) --* 

      RetrieveTapeRecoveryPointOutput

      
      

      - **TapeARN** *(string) --* 

        The Amazon Resource Name (ARN) of the virtual tape for which the recovery point was retrieved.

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

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

  

  **Examples**

  Retrieves the recovery point for the specified virtual tape.
  ::

    response = client.retrieve_tape_recovery_point(
        GatewayARN='arn:aws:storagegateway:us-east-1:999999999999:gateway/sgw-12A3456B',
        TapeARN='arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'TapeARN': 'arn:aws:storagegateway:us-east-1:999999999999:tape/TEST0AA2AF',
        'ResponseMetadata': {
            '...': '...',
        },
    }

  