Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1490380385.5 KB

Returns a list of virtual tape recovery points that are available for the specified tape gateway.

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

post/#X-Amz-Target=StorageGateway_20130630.DescribeTapeRecoveryPoints

Query parameters

Limitstring

Pagination limit

Markerstring

Pagination token

Headers

X-Amz-Target'StorageGateway_20130630.DescribeTapeRecoveryPoints' required

Request body

GatewayARNstring required

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

Markerstring

An opaque string that indicates the position at which to begin describing the virtual tape recovery points.

Limitinteger

Specifies that the number of virtual tape recovery points that are described be limited to the specified number.

Response

Success

GatewayARNstring

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

Markerstring
<p>An opaque string that indicates the position at which the virtual tape recovery points that were listed for description ended.</p> <p>Use this marker in your next request to list the next set of virtual tape recovery points in the list. If there are no more recovery points to describe, this field does not appear in the response.</p>

Example response

{
  "GatewayARN": "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B",
  "Marker": "1",
  "TapeRecoveryPointInfos": [
    {
      "TapeARN": "arn:aws:storagegateway:us-east-1:999999999:tape/AMZN01A2A4",
      "TapeRecoveryPointTime": "2016-12-16T13:50Z",
      "TapeSizeInBytes": 1471550497,
      "TapeStatus": "AVAILABLE"
    }
  ]
}