Skip to content

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

Description

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.

Usage

storagegateway_describe_tape_recovery_points(GatewayARN, Marker, Limit)

Arguments

  • GatewayARN

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

  • Marker

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

  • Limit

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

Value

A list with the following syntax:

list(
  GatewayARN = "string",
  TapeRecoveryPointInfos = list(
    list(
      TapeARN = "string",
      TapeRecoveryPointTime = as.POSIXct(
        "2015-01-01"
      ),
      TapeSizeInBytes = 123,
      TapeStatus = "string"
    )
  ),
  Marker = "string"
)

Request syntax

svc$describe_tape_recovery_points(
  GatewayARN = "string",
  Marker = "string",
  Limit = 123
)

Examples

# Returns a list of virtual tape recovery points that are available for
# the specified gateway-VTL.
svc$describe_tape_recovery_points(
  GatewayARN = "arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B",
  Limit = 1L,
  Marker = "1"
)