retrieveTapeRecoveryPoint method

Future<RetrieveTapeRecoveryPointOutput> retrieveTapeRecoveryPoint({ required String gatewayARN, required String tapeARN, })

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.

May throw InvalidGatewayRequestException. May throw InternalServerError.

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

Implementation

Future<RetrieveTapeRecoveryPointOutput> retrieveTapeRecoveryPoint({
  required String gatewayARN,
  required String tapeARN,
}) async {
  ArgumentError.checkNotNull(gatewayARN, 'gatewayARN');
  _s.validateStringLength(
    'gatewayARN',
    gatewayARN,
    50,
    500,
    isRequired: true,
  );
  ArgumentError.checkNotNull(tapeARN, 'tapeARN');
  _s.validateStringLength(
    'tapeARN',
    tapeARN,
    50,
    500,
    isRequired: true,
  );
  final headers = <String, String>{
    'Content-Type': 'application/x-amz-json-1.1',
    'X-Amz-Target': 'StorageGateway_20130630.RetrieveTapeRecoveryPoint'
  };
  final jsonResponse = await _protocol.send(
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    // TODO queryParams
    headers: headers,
    payload: {
      'GatewayARN': gatewayARN,
      'TapeARN': tapeARN,
    },
  );

  return RetrieveTapeRecoveryPointOutput.fromJson(jsonResponse.body);
}