All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.storagegateway.AWSStorageGatewayAsync Maven / Gradle / Ivy

Go to download

The AWS Java SDK for AWS Storage Gateway module holds the client classes that are used for communicating with AWS Storage Gateway Service

There is a newer version: 1.12.780
Show newest version
/*
 * Copyright 2010-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 * 
 *  http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */
package com.amazonaws.services.storagegateway;

import java.util.concurrent.Future;

import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.handlers.AsyncHandler;
import com.amazonaws.services.storagegateway.model.*;

/**
 * Interface for accessing AWSStorageGateway asynchronously.
 * Each asynchronous method will return a Java Future object, and users are also allowed
 * to provide a callback handler.
 * AWS Storage Gateway Service 

* AWS Storage Gateway is the service that connects an on-premises * software appliance with cloud-based storage to provide seamless and * secure integration between an organization's on-premises IT * environment and AWS's storage infrastructure. The service enables you * to securely upload data to the AWS cloud for cost effective backup and * rapid disaster recovery. *

*

* Use the following links to get started using the AWS Storage * Gateway Service API Reference : *

* * */ public interface AWSStorageGatewayAsync extends AWSStorageGateway { /** *

* This operation deletes a snapshot of a volume. *

*

* You can take snapshots of your gateway volumes on a scheduled or * ad-hoc basis. This API enables you to delete a snapshot schedule for a * volume. For more information, see * Working with Snapshots * . In the DeleteSnapshotSchedule request, you identify * the volume by providing its Amazon Resource Name (ARN). *

*

* NOTE: To list or delete a snapshot, you must use the Amazon * EC2 API. in Amazon Elastic Compute Cloud API Reference. *

* * @param deleteSnapshotScheduleRequest Container for the necessary * parameters to execute the DeleteSnapshotSchedule operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteSnapshotSchedule service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteSnapshotScheduleAsync(DeleteSnapshotScheduleRequest deleteSnapshotScheduleRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes a snapshot of a volume. *

*

* You can take snapshots of your gateway volumes on a scheduled or * ad-hoc basis. This API enables you to delete a snapshot schedule for a * volume. For more information, see * Working with Snapshots * . In the DeleteSnapshotSchedule request, you identify * the volume by providing its Amazon Resource Name (ARN). *

*

* NOTE: To list or delete a snapshot, you must use the Amazon * EC2 API. in Amazon Elastic Compute Cloud API Reference. *

* * @param deleteSnapshotScheduleRequest Container for the necessary * parameters to execute the DeleteSnapshotSchedule operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteSnapshotSchedule service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteSnapshotScheduleAsync(DeleteSnapshotScheduleRequest deleteSnapshotScheduleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns your gateway's weekly maintenance start time * including the day and time of the week. Note that values are in terms * of the gateway's time zone. *

* * @param describeMaintenanceStartTimeRequest Container for the necessary * parameters to execute the DescribeMaintenanceStartTime operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeMaintenanceStartTime service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeMaintenanceStartTimeAsync(DescribeMaintenanceStartTimeRequest describeMaintenanceStartTimeRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns your gateway's weekly maintenance start time * including the day and time of the week. Note that values are in terms * of the gateway's time zone. *

* * @param describeMaintenanceStartTimeRequest Container for the necessary * parameters to execute the DescribeMaintenanceStartTime operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeMaintenanceStartTime service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeMaintenanceStartTimeAsync(DescribeMaintenanceStartTimeRequest describeMaintenanceStartTimeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation creates a volume on a specified gateway. This * operation is supported only for the gateway-stored volume * architecture. *

*

* The size of the volume to create is inferred from the disk size. You * can choose to preserve existing data on the disk, create volume from * an existing snapshot, or create an empty volume. If you choose to * create an empty gateway volume, then any existing data on the disk is * erased. *

*

* In the request you must specify the gateway and the disk information * on which you are creating the volume. In response, AWS Storage Gateway * creates the volume and returns volume information such as the volume * Amazon Resource Name (ARN), its size, and the iSCSI target ARN that * initiators can use to connect to the volume target. *

* * @param createStorediSCSIVolumeRequest Container for the necessary * parameters to execute the CreateStorediSCSIVolume operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * CreateStorediSCSIVolume service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createStorediSCSIVolumeAsync(CreateStorediSCSIVolumeRequest createStorediSCSIVolumeRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation creates a volume on a specified gateway. This * operation is supported only for the gateway-stored volume * architecture. *

*

* The size of the volume to create is inferred from the disk size. You * can choose to preserve existing data on the disk, create volume from * an existing snapshot, or create an empty volume. If you choose to * create an empty gateway volume, then any existing data on the disk is * erased. *

*

* In the request you must specify the gateway and the disk information * on which you are creating the volume. In response, AWS Storage Gateway * creates the volume and returns volume information such as the volume * Amazon Resource Name (ARN), its size, and the iSCSI target ARN that * initiators can use to connect to the volume target. *

* * @param createStorediSCSIVolumeRequest Container for the necessary * parameters to execute the CreateStorediSCSIVolume operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateStorediSCSIVolume service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createStorediSCSIVolumeAsync(CreateStorediSCSIVolumeRequest createStorediSCSIVolumeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists the tags that have been added to the specified * resource. *

* * @param listTagsForResourceRequest Container for the necessary * parameters to execute the ListTagsForResource operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * ListTagsForResource service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists the tags that have been added to the specified * resource. *

* * @param listTagsForResourceRequest Container for the necessary * parameters to execute the ListTagsForResource operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListTagsForResource service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation initiates a snapshot of a volume. *

*

* AWS Storage Gateway provides the ability to back up point-in-time * snapshots of your data to Amazon Simple Storage (S3) for durable * off-site recovery, as well as import the data to an Amazon Elastic * Block Store (EBS) volume in Amazon Elastic Compute Cloud (EC2). You * can take snapshots of your gateway volume on a scheduled or ad-hoc * basis. This API enables you to take ad-hoc snapshot. For more * information, see * Working With Snapshots in the AWS Storage Gateway Console * . *

*

* In the CreateSnapshot request you identify the volume by providing * its Amazon Resource Name (ARN). You must also provide description for * the snapshot. When AWS Storage Gateway takes the snapshot of specified * volume, the snapshot and description appears in the AWS Storage * Gateway Console. In response, AWS Storage Gateway returns you a * snapshot ID. You can use this snapshot ID to check the snapshot * progress or later use it when you want to create a volume from a * snapshot. *

*

* NOTE:To list or delete a snapshot, you must use the Amazon EC2 * API. For more information, see DescribeSnapshots or DeleteSnapshot in * the EC2 API reference. *

* * @param createSnapshotRequest Container for the necessary parameters to * execute the CreateSnapshot operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * CreateSnapshot service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createSnapshotAsync(CreateSnapshotRequest createSnapshotRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation initiates a snapshot of a volume. *

*

* AWS Storage Gateway provides the ability to back up point-in-time * snapshots of your data to Amazon Simple Storage (S3) for durable * off-site recovery, as well as import the data to an Amazon Elastic * Block Store (EBS) volume in Amazon Elastic Compute Cloud (EC2). You * can take snapshots of your gateway volume on a scheduled or ad-hoc * basis. This API enables you to take ad-hoc snapshot. For more * information, see * Working With Snapshots in the AWS Storage Gateway Console * . *

*

* In the CreateSnapshot request you identify the volume by providing * its Amazon Resource Name (ARN). You must also provide description for * the snapshot. When AWS Storage Gateway takes the snapshot of specified * volume, the snapshot and description appears in the AWS Storage * Gateway Console. In response, AWS Storage Gateway returns you a * snapshot ID. You can use this snapshot ID to check the snapshot * progress or later use it when you want to create a volume from a * snapshot. *

*

* NOTE:To list or delete a snapshot, you must use the Amazon EC2 * API. For more information, see DescribeSnapshots or DeleteSnapshot in * the EC2 API reference. *

* * @param createSnapshotRequest Container for the necessary parameters to * execute the CreateSnapshot operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateSnapshot service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createSnapshotAsync(CreateSnapshotRequest createSnapshotRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation adds one or more tags to the specified resource. You * use tags to add metadata to resources, which you can use to categorize * these resources. For example, you can categorize resources by purpose, * owner, environment, or team. Each tag consists of a key and a value, * which you define. You can add tags to the following AWS Storage * Gateway resources: *

* *
    *
  • * Storage gateways of all types *

    *
  • * *
* *
    *
  • * Storage Volumes *

    *
  • * *
* *
    *
  • * Virtual Tapes *

    *
  • * *
*

* You can create a maximum of 10 tags for each resource. Virtual tapes * and storage volumes that are recovered to a new gateway maintain their * tags. *

* * @param addTagsToResourceRequest Container for the necessary parameters * to execute the AddTagsToResource operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * AddTagsToResource service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addTagsToResourceAsync(AddTagsToResourceRequest addTagsToResourceRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation adds one or more tags to the specified resource. You * use tags to add metadata to resources, which you can use to categorize * these resources. For example, you can categorize resources by purpose, * owner, environment, or team. Each tag consists of a key and a value, * which you define. You can add tags to the following AWS Storage * Gateway resources: *

* *
    *
  • * Storage gateways of all types *

    *
  • * *
* *
    *
  • * Storage Volumes *

    *
  • * *
* *
    *
  • * Virtual Tapes *

    *
  • * *
*

* You can create a maximum of 10 tags for each resource. Virtual tapes * and storage volumes that are recovered to a new gateway maintain their * tags. *

* * @param addTagsToResourceRequest Container for the necessary parameters * to execute the AddTagsToResource operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * AddTagsToResource service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addTagsToResourceAsync(AddTagsToResourceRequest addTagsToResourceRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation configures one or more gateway local disks as working * storage for a gateway. This operation is supported only for the * gateway-stored volume architecture. This operation is deprecated * method in cached-volumes API version (20120630). Use AddUploadBuffer * instead. *

*

* NOTE: Working storage is also referred to as upload buffer. * You can also use the AddUploadBuffer operation to add upload buffer to * a stored-volume gateway. *

*

* In the request, you specify the gateway Amazon Resource Name (ARN) to * which you want to add working storage, and one or more disk IDs that * you want to configure as working storage. *

* * @param addWorkingStorageRequest Container for the necessary parameters * to execute the AddWorkingStorage operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * AddWorkingStorage service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addWorkingStorageAsync(AddWorkingStorageRequest addWorkingStorageRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation configures one or more gateway local disks as working * storage for a gateway. This operation is supported only for the * gateway-stored volume architecture. This operation is deprecated * method in cached-volumes API version (20120630). Use AddUploadBuffer * instead. *

*

* NOTE: Working storage is also referred to as upload buffer. * You can also use the AddUploadBuffer operation to add upload buffer to * a stored-volume gateway. *

*

* In the request, you specify the gateway Amazon Resource Name (ARN) to * which you want to add working storage, and one or more disk IDs that * you want to configure as working storage. *

* * @param addWorkingStorageRequest Container for the necessary parameters * to execute the AddWorkingStorage operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * AddWorkingStorage service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addWorkingStorageAsync(AddWorkingStorageRequest addWorkingStorageRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Cancels retrieval of a virtual tape from the virtual tape shelf (VTS) * to a gateway after the retrieval process is initiated. The virtual * tape is returned to the VTS. *

* * @param cancelRetrievalRequest Container for the necessary parameters * to execute the CancelRetrieval operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * CancelRetrieval service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future cancelRetrievalAsync(CancelRetrievalRequest cancelRetrievalRequest) throws AmazonServiceException, AmazonClientException; /** *

* Cancels retrieval of a virtual tape from the virtual tape shelf (VTS) * to a gateway after the retrieval process is initiated. The virtual * tape is returned to the VTS. *

* * @param cancelRetrievalRequest Container for the necessary parameters * to execute the CancelRetrieval operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CancelRetrieval service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future cancelRetrievalAsync(CancelRetrievalRequest cancelRetrievalRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns the bandwidth rate limits of a gateway. By * default, these limits are not set, which means no bandwidth rate * limiting is in effect. *

*

* This operation only returns a value for a bandwidth rate limit only * if the limit is set. If no limits are set for the gateway, then this * operation returns only the gateway ARN in the response body. To * specify which gateway to describe, use the Amazon Resource Name (ARN) * of the gateway in your request. *

* * @param describeBandwidthRateLimitRequest Container for the necessary * parameters to execute the DescribeBandwidthRateLimit operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeBandwidthRateLimit service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeBandwidthRateLimitAsync(DescribeBandwidthRateLimitRequest describeBandwidthRateLimitRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns the bandwidth rate limits of a gateway. By * default, these limits are not set, which means no bandwidth rate * limiting is in effect. *

*

* This operation only returns a value for a bandwidth rate limit only * if the limit is set. If no limits are set for the gateway, then this * operation returns only the gateway ARN in the response body. To * specify which gateway to describe, use the Amazon Resource Name (ARN) * of the gateway in your request. *

* * @param describeBandwidthRateLimitRequest Container for the necessary * parameters to execute the DescribeBandwidthRateLimit operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeBandwidthRateLimit service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeBandwidthRateLimitAsync(DescribeBandwidthRateLimitRequest describeBandwidthRateLimitRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a description of the specified Amazon Resource Name (ARN) of * virtual tapes. If a TapeARN is not specified, returns a * description of all virtual tapes associated with the specified * gateway. *

* * @param describeTapesRequest Container for the necessary parameters to * execute the DescribeTapes operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeTapes service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeTapesAsync(DescribeTapesRequest describeTapesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a description of the specified Amazon Resource Name (ARN) of * virtual tapes. If a TapeARN is not specified, returns a * description of all virtual tapes associated with the specified * gateway. *

* * @param describeTapesRequest Container for the necessary parameters to * execute the DescribeTapes operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeTapes service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeTapesAsync(DescribeTapesRequest describeTapesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

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

*

* 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 gateway-VTL. There is no charge for retrieving recovery points. *

* * @param retrieveTapeRecoveryPointRequest Container for the necessary * parameters to execute the RetrieveTapeRecoveryPoint operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * RetrieveTapeRecoveryPoint service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future retrieveTapeRecoveryPointAsync(RetrieveTapeRecoveryPointRequest retrieveTapeRecoveryPointRequest) throws AmazonServiceException, AmazonClientException; /** *

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

*

* 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 gateway-VTL. There is no charge for retrieving recovery points. *

* * @param retrieveTapeRecoveryPointRequest Container for the necessary * parameters to execute the RetrieveTapeRecoveryPoint operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * RetrieveTapeRecoveryPoint service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future retrieveTapeRecoveryPointAsync(RetrieveTapeRecoveryPointRequest retrieveTapeRecoveryPointRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Creates one or more virtual tapes. You write data to the virtual * tapes and then archive the tapes. *

*

* NOTE:Cache storage must be allocated to the gateway before you * can create virtual tapes. Use the AddCache operation to add cache * storage to a gateway. *

* * @param createTapesRequest Container for the necessary parameters to * execute the CreateTapes operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * CreateTapes service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createTapesAsync(CreateTapesRequest createTapesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Creates one or more virtual tapes. You write data to the virtual * tapes and then archive the tapes. *

*

* NOTE:Cache storage must be allocated to the gateway before you * can create virtual tapes. Use the AddCache operation to add cache * storage to a gateway. *

* * @param createTapesRequest Container for the necessary parameters to * execute the CreateTapes operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateTapes service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createTapesAsync(CreateTapesRequest createTapesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns information about the upload buffer of a * gateway. This operation is supported for both the gateway-stored and * gateway-cached volume architectures. *

*

* The response includes disk IDs that are configured as upload buffer * space, and it includes the amount of upload buffer space allocated and * used. *

* * @param describeUploadBufferRequest Container for the necessary * parameters to execute the DescribeUploadBuffer operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeUploadBuffer service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeUploadBufferAsync(DescribeUploadBufferRequest describeUploadBufferRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns information about the upload buffer of a * gateway. This operation is supported for both the gateway-stored and * gateway-cached volume architectures. *

*

* The response includes disk IDs that are configured as upload buffer * space, and it includes the amount of upload buffer space allocated and * used. *

* * @param describeUploadBufferRequest Container for the necessary * parameters to execute the DescribeUploadBuffer operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeUploadBuffer service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeUploadBufferAsync(DescribeUploadBufferRequest describeUploadBufferRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes Challenge-Handshake Authentication Protocol * (CHAP) credentials for a specified iSCSI target and initiator pair. *

* * @param deleteChapCredentialsRequest Container for the necessary * parameters to execute the DeleteChapCredentials operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteChapCredentials service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteChapCredentialsAsync(DeleteChapCredentialsRequest deleteChapCredentialsRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes Challenge-Handshake Authentication Protocol * (CHAP) credentials for a specified iSCSI target and initiator pair. *

* * @param deleteChapCredentialsRequest Container for the necessary * parameters to execute the DeleteChapCredentials operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteChapCredentials service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteChapCredentialsAsync(DeleteChapCredentialsRequest deleteChapCredentialsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation configures one or more gateway local disks as cache * for a cached-volume gateway. This operation is supported only for the * gateway-cached volume architecture (see * Storage Gateway Concepts * ). *

*

* In the request, you specify the gateway Amazon Resource Name (ARN) to * which you want to add cache, and one or more disk IDs that you want to * configure as cache. *

* * @param addCacheRequest Container for the necessary parameters to * execute the AddCache operation on AWSStorageGateway. * * @return A Java Future object containing the response from the AddCache * service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addCacheAsync(AddCacheRequest addCacheRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation configures one or more gateway local disks as cache * for a cached-volume gateway. This operation is supported only for the * gateway-cached volume architecture (see * Storage Gateway Concepts * ). *

*

* In the request, you specify the gateway Amazon Resource Name (ARN) to * which you want to add cache, and one or more disk IDs that you want to * configure as cache. *

* * @param addCacheRequest Container for the necessary parameters to * execute the AddCache operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the AddCache * service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addCacheAsync(AddCacheRequest addCacheRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns metadata about a gateway such as its name, * network interfaces, configured time zone, and the state (whether the * gateway is running or not). To specify which gateway to describe, use * the Amazon Resource Name (ARN) of the gateway in your request. *

* * @param describeGatewayInformationRequest Container for the necessary * parameters to execute the DescribeGatewayInformation operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeGatewayInformation service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeGatewayInformationAsync(DescribeGatewayInformationRequest describeGatewayInformationRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns metadata about a gateway such as its name, * network interfaces, configured time zone, and the state (whether the * gateway is running or not). To specify which gateway to describe, use * the Amazon Resource Name (ARN) of the gateway in your request. *

* * @param describeGatewayInformationRequest Container for the necessary * parameters to execute the DescribeGatewayInformation operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeGatewayInformation service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeGatewayInformationAsync(DescribeGatewayInformationRequest describeGatewayInformationRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists iSCSI initiators that are connected to a volume. * You can use this operation to determine whether a volume is being used * or not. *

* * @param listVolumeInitiatorsRequest Container for the necessary * parameters to execute the ListVolumeInitiators operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * ListVolumeInitiators service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listVolumeInitiatorsAsync(ListVolumeInitiatorsRequest listVolumeInitiatorsRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists iSCSI initiators that are connected to a volume. * You can use this operation to determine whether a volume is being used * or not. *

* * @param listVolumeInitiatorsRequest Container for the necessary * parameters to execute the ListVolumeInitiators operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListVolumeInitiators service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listVolumeInitiatorsAsync(ListVolumeInitiatorsRequest listVolumeInitiatorsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns a list of the gateway's local disks. To * specify which gateway to describe, you use the Amazon Resource Name * (ARN) of the gateway in the body of the request. *

*

* The request returns a list of all disks, specifying which are * configured as working storage, cache storage, or stored volume or not * configured at all. The response includes a DiskStatus * field. This field can have a value of present (the disk is available * to use), missing (the disk is no longer connected to the gateway), or * mismatch (the disk node is occupied by a disk that has incorrect * metadata or the disk content is corrupted). *

* * @param listLocalDisksRequest Container for the necessary parameters to * execute the ListLocalDisks operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * ListLocalDisks service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listLocalDisksAsync(ListLocalDisksRequest listLocalDisksRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns a list of the gateway's local disks. To * specify which gateway to describe, you use the Amazon Resource Name * (ARN) of the gateway in the body of the request. *

*

* The request returns a list of all disks, specifying which are * configured as working storage, cache storage, or stored volume or not * configured at all. The response includes a DiskStatus * field. This field can have a value of present (the disk is available * to use), missing (the disk is no longer connected to the gateway), or * mismatch (the disk node is occupied by a disk that has incorrect * metadata or the disk content is corrupted). *

* * @param listLocalDisksRequest Container for the necessary parameters to * execute the ListLocalDisks operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListLocalDisks service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listLocalDisksAsync(ListLocalDisksRequest listLocalDisksRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns information about the cache of a gateway. This * operation is supported only for the gateway-cached volume * architecture. *

*

* The response includes disk IDs that are configured as cache, and it * includes the amount of cache allocated and used. *

* * @param describeCacheRequest Container for the necessary parameters to * execute the DescribeCache operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeCache service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeCacheAsync(DescribeCacheRequest describeCacheRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns information about the cache of a gateway. This * operation is supported only for the gateway-cached volume * architecture. *

*

* The response includes disk IDs that are configured as cache, and it * includes the amount of cache allocated and used. *

* * @param describeCacheRequest Container for the necessary parameters to * execute the DescribeCache operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeCache service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeCacheAsync(DescribeCacheRequest describeCacheRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Disables a gateway when the gateway is no longer functioning. For * example, if your gateway VM is damaged, you can disable the gateway so * you can recover virtual tapes. *

*

* Use this operation for a gateway-VTL that is not reachable or not * functioning. *

*

* IMPORTANT:Once a gateway is disabled it cannot be enabled. *

* * @param disableGatewayRequest Container for the necessary parameters to * execute the DisableGateway operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DisableGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future disableGatewayAsync(DisableGatewayRequest disableGatewayRequest) throws AmazonServiceException, AmazonClientException; /** *

* Disables a gateway when the gateway is no longer functioning. For * example, if your gateway VM is damaged, you can disable the gateway so * you can recover virtual tapes. *

*

* Use this operation for a gateway-VTL that is not reachable or not * functioning. *

*

* IMPORTANT:Once a gateway is disabled it cannot be enabled. *

* * @param disableGatewayRequest Container for the necessary parameters to * execute the DisableGateway operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DisableGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future disableGatewayAsync(DisableGatewayRequest disableGatewayRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified virtual tape. *

* * @param deleteTapeRequest Container for the necessary parameters to * execute the DeleteTape operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteTape service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteTapeAsync(DeleteTapeRequest deleteTapeRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified virtual tape. *

* * @param deleteTapeRequest Container for the necessary parameters to * execute the DeleteTape operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteTape service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteTapeAsync(DeleteTapeRequest deleteTapeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation starts a gateway that you previously shut down (see * ShutdownGateway). After the gateway starts, you can then make other * API calls, your applications can read from or write to the gateway's * storage volumes and you will be able to take snapshot backups. *

*

* NOTE:When you make a request, you will get a 200 OK success * response immediately. However, it might take some time for the gateway * to be ready. You should call DescribeGatewayInformation and check the * status before making any additional API calls. For more information, * see ActivateGateway. *

*

* To specify which gateway to start, use the Amazon Resource Name (ARN) * of the gateway in your request. *

* * @param startGatewayRequest Container for the necessary parameters to * execute the StartGateway operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * StartGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future startGatewayAsync(StartGatewayRequest startGatewayRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation starts a gateway that you previously shut down (see * ShutdownGateway). After the gateway starts, you can then make other * API calls, your applications can read from or write to the gateway's * storage volumes and you will be able to take snapshot backups. *

*

* NOTE:When you make a request, you will get a 200 OK success * response immediately. However, it might take some time for the gateway * to be ready. You should call DescribeGatewayInformation and check the * status before making any additional API calls. For more information, * see ActivateGateway. *

*

* To specify which gateway to start, use the Amazon Resource Name (ARN) * of the gateway in your request. *

* * @param startGatewayRequest Container for the necessary parameters to * execute the StartGateway operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * StartGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future startGatewayAsync(StartGatewayRequest startGatewayRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation initiates a snapshot of a gateway from a volume * recovery point. This operation is supported only for the * gateway-cached volume architecture (see ). *

*

* A volume recovery point is a point in time at which all data of the * volume is consistent and from which you can create a snapshot. To get * a list of volume recovery point for gateway-cached volumes, use * ListVolumeRecoveryPoints. *

*

* In the CreateSnapshotFromVolumeRecoveryPoint request, * you identify the volume by providing its Amazon Resource Name (ARN). * You must also provide a description for the snapshot. When AWS Storage * Gateway takes a snapshot of the specified volume, the snapshot and its * description appear in the AWS Storage Gateway console. In response, * AWS Storage Gateway returns you a snapshot ID. You can use this * snapshot ID to check the snapshot progress or later use it when you * want to create a volume from a snapshot. *

*

* NOTE: To list or delete a snapshot, you must use the Amazon * EC2 API. For more information, in Amazon Elastic Compute Cloud API * Reference. *

* * @param createSnapshotFromVolumeRecoveryPointRequest Container for the * necessary parameters to execute the * CreateSnapshotFromVolumeRecoveryPoint operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * CreateSnapshotFromVolumeRecoveryPoint service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createSnapshotFromVolumeRecoveryPointAsync(CreateSnapshotFromVolumeRecoveryPointRequest createSnapshotFromVolumeRecoveryPointRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation initiates a snapshot of a gateway from a volume * recovery point. This operation is supported only for the * gateway-cached volume architecture (see ). *

*

* A volume recovery point is a point in time at which all data of the * volume is consistent and from which you can create a snapshot. To get * a list of volume recovery point for gateway-cached volumes, use * ListVolumeRecoveryPoints. *

*

* In the CreateSnapshotFromVolumeRecoveryPoint request, * you identify the volume by providing its Amazon Resource Name (ARN). * You must also provide a description for the snapshot. When AWS Storage * Gateway takes a snapshot of the specified volume, the snapshot and its * description appear in the AWS Storage Gateway console. In response, * AWS Storage Gateway returns you a snapshot ID. You can use this * snapshot ID to check the snapshot progress or later use it when you * want to create a volume from a snapshot. *

*

* NOTE: To list or delete a snapshot, you must use the Amazon * EC2 API. For more information, in Amazon Elastic Compute Cloud API * Reference. *

* * @param createSnapshotFromVolumeRecoveryPointRequest Container for the * necessary parameters to execute the * CreateSnapshotFromVolumeRecoveryPoint operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateSnapshotFromVolumeRecoveryPoint service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createSnapshotFromVolumeRecoveryPointAsync(CreateSnapshotFromVolumeRecoveryPointRequest createSnapshotFromVolumeRecoveryPointRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation creates a cached volume on a specified cached gateway. * This operation is supported only for the gateway-cached volume * architecture. *

*

* NOTE:Cache storage must be allocated to the gateway before you * can create a cached volume. Use the AddCache operation to add cache * storage to a gateway. *

*

* In the request, you must specify the gateway, size of the volume in * bytes, the iSCSI target name, an IP address on which to expose the * target, and a unique client token. In response, AWS Storage Gateway * creates the volume and returns information about it such as the volume * Amazon Resource Name (ARN), its size, and the iSCSI target ARN that * initiators can use to connect to the volume target. *

* * @param createCachediSCSIVolumeRequest Container for the necessary * parameters to execute the CreateCachediSCSIVolume operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * CreateCachediSCSIVolume service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createCachediSCSIVolumeAsync(CreateCachediSCSIVolumeRequest createCachediSCSIVolumeRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation creates a cached volume on a specified cached gateway. * This operation is supported only for the gateway-cached volume * architecture. *

*

* NOTE:Cache storage must be allocated to the gateway before you * can create a cached volume. Use the AddCache operation to add cache * storage to a gateway. *

*

* In the request, you must specify the gateway, size of the volume in * bytes, the iSCSI target name, an IP address on which to expose the * target, and a unique client token. In response, AWS Storage Gateway * creates the volume and returns information about it such as the volume * Amazon Resource Name (ARN), its size, and the iSCSI target ARN that * initiators can use to connect to the volume target. *

* * @param createCachediSCSIVolumeRequest Container for the necessary * parameters to execute the CreateCachediSCSIVolume operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateCachediSCSIVolume service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future createCachediSCSIVolumeAsync(CreateCachediSCSIVolumeRequest createCachediSCSIVolumeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation shuts down a gateway. To specify which gateway to shut * down, use the Amazon Resource Name (ARN) of the gateway in the body of * your request. *

*

* The operation shuts down the gateway service component running in the * storage gateway's virtual machine (VM) and not the VM. *

*

* NOTE:If you want to shut down the VM, it is recommended that * you first shut down the gateway component in the VM to avoid * unpredictable conditions. *

*

* After the gateway is shutdown, you cannot call any other API except * StartGateway, DescribeGatewayInformation, and ListGateways. For more * information, see ActivateGateway. Your applications cannot read from * or write to the gateway's storage volumes, and there are no snapshots * taken. *

*

* NOTE:When you make a shutdown request, you will get a 200 OK * success response immediately. However, it might take some time for the * gateway to shut down. You can call the DescribeGatewayInformation API * to check the status. For more information, see ActivateGateway. *

*

* If do not intend to use the gateway again, you must delete the * gateway (using DeleteGateway) to no longer pay software charges * associated with the gateway. *

* * @param shutdownGatewayRequest Container for the necessary parameters * to execute the ShutdownGateway operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * ShutdownGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future shutdownGatewayAsync(ShutdownGatewayRequest shutdownGatewayRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation shuts down a gateway. To specify which gateway to shut * down, use the Amazon Resource Name (ARN) of the gateway in the body of * your request. *

*

* The operation shuts down the gateway service component running in the * storage gateway's virtual machine (VM) and not the VM. *

*

* NOTE:If you want to shut down the VM, it is recommended that * you first shut down the gateway component in the VM to avoid * unpredictable conditions. *

*

* After the gateway is shutdown, you cannot call any other API except * StartGateway, DescribeGatewayInformation, and ListGateways. For more * information, see ActivateGateway. Your applications cannot read from * or write to the gateway's storage volumes, and there are no snapshots * taken. *

*

* NOTE:When you make a shutdown request, you will get a 200 OK * success response immediately. However, it might take some time for the * gateway to shut down. You can call the DescribeGatewayInformation API * to check the status. For more information, see ActivateGateway. *

*

* If do not intend to use the gateway again, you must delete the * gateway (using DeleteGateway) to no longer pay software charges * associated with the gateway. *

* * @param shutdownGatewayRequest Container for the necessary parameters * to execute the ShutdownGateway operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ShutdownGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future shutdownGatewayAsync(ShutdownGatewayRequest shutdownGatewayRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

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

*

* 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. *

* * @param describeTapeRecoveryPointsRequest Container for the necessary * parameters to execute the DescribeTapeRecoveryPoints operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeTapeRecoveryPoints service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeTapeRecoveryPointsAsync(DescribeTapeRecoveryPointsRequest describeTapeRecoveryPointsRequest) throws AmazonServiceException, AmazonClientException; /** *

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

*

* 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. *

* * @param describeTapeRecoveryPointsRequest Container for the necessary * parameters to execute the DescribeTapeRecoveryPoints operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeTapeRecoveryPoints service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeTapeRecoveryPointsAsync(DescribeTapeRecoveryPointsRequest describeTapeRecoveryPointsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists gateways owned by an AWS account in a region * specified in the request. The returned list is ordered by gateway * Amazon Resource Name (ARN). *

*

* By default, the operation returns a maximum of 100 gateways. This * operation supports pagination that allows you to optionally reduce the * number of gateways returned in a response. *

*

* If you have more gateways than are returned in a response-that is, * the response returns only a truncated list of your gateways-the * response contains a marker that you can specify in your next request * to fetch the next page of gateways. *

* * @param listGatewaysRequest Container for the necessary parameters to * execute the ListGateways operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * ListGateways service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listGatewaysAsync(ListGatewaysRequest listGatewaysRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists gateways owned by an AWS account in a region * specified in the request. The returned list is ordered by gateway * Amazon Resource Name (ARN). *

*

* By default, the operation returns a maximum of 100 gateways. This * operation supports pagination that allows you to optionally reduce the * number of gateways returned in a response. *

*

* If you have more gateways than are returned in a response-that is, * the response returns only a truncated list of your gateways-the * response contains a marker that you can specify in your next request * to fetch the next page of gateways. *

* * @param listGatewaysRequest Container for the necessary parameters to * execute the ListGateways operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListGateways service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listGatewaysAsync(ListGatewaysRequest listGatewaysRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns the description of the gateway volumes * specified in the request. The list of gateway volumes in the request * must be from one gateway. In the response Amazon Storage Gateway * returns volume information sorted by volume ARNs. *

* * @param describeStorediSCSIVolumesRequest Container for the necessary * parameters to execute the DescribeStorediSCSIVolumes operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeStorediSCSIVolumes service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeStorediSCSIVolumesAsync(DescribeStorediSCSIVolumesRequest describeStorediSCSIVolumesRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns the description of the gateway volumes * specified in the request. The list of gateway volumes in the request * must be from one gateway. In the response Amazon Storage Gateway * returns volume information sorted by volume ARNs. *

* * @param describeStorediSCSIVolumesRequest Container for the necessary * parameters to execute the DescribeStorediSCSIVolumes operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeStorediSCSIVolumes service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeStorediSCSIVolumesAsync(DescribeStorediSCSIVolumesRequest describeStorediSCSIVolumesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists the recovery points for a specified gateway. * This operation is supported only for the gateway-cached volume * architecture. *

*

* Each gateway-cached volume has one recovery point. A volume recovery * point is a point in time at which all data of the volume is consistent * and from which you can create a snapshot. To create a snapshot from a * volume recovery point use the CreateSnapshotFromVolumeRecoveryPoint * operation. *

* * @param listVolumeRecoveryPointsRequest Container for the necessary * parameters to execute the ListVolumeRecoveryPoints operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * ListVolumeRecoveryPoints service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listVolumeRecoveryPointsAsync(ListVolumeRecoveryPointsRequest listVolumeRecoveryPointsRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists the recovery points for a specified gateway. * This operation is supported only for the gateway-cached volume * architecture. *

*

* Each gateway-cached volume has one recovery point. A volume recovery * point is a point in time at which all data of the volume is consistent * and from which you can create a snapshot. To create a snapshot from a * volume recovery point use the CreateSnapshotFromVolumeRecoveryPoint * operation. *

* * @param listVolumeRecoveryPointsRequest Container for the necessary * parameters to execute the ListVolumeRecoveryPoints operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListVolumeRecoveryPoints service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listVolumeRecoveryPointsAsync(ListVolumeRecoveryPointsRequest listVolumeRecoveryPointsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a description of virtual tape library (VTL) devices for the * specified gateway. In the response, AWS Storage Gateway returns VTL * device information. *

*

* The list of VTL devices must be from one gateway. *

* * @param describeVTLDevicesRequest Container for the necessary * parameters to execute the DescribeVTLDevices operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeVTLDevices service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeVTLDevicesAsync(DescribeVTLDevicesRequest describeVTLDevicesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a description of virtual tape library (VTL) devices for the * specified gateway. In the response, AWS Storage Gateway returns VTL * device information. *

*

* The list of VTL devices must be from one gateway. *

* * @param describeVTLDevicesRequest Container for the necessary * parameters to execute the DescribeVTLDevices operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeVTLDevices service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeVTLDevicesAsync(DescribeVTLDevicesRequest describeVTLDevicesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Cancels archiving of a virtual tape to the virtual tape shelf (VTS) * after the archiving process is initiated. *

* * @param cancelArchivalRequest Container for the necessary parameters to * execute the CancelArchival operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * CancelArchival service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future cancelArchivalAsync(CancelArchivalRequest cancelArchivalRequest) throws AmazonServiceException, AmazonClientException; /** *

* Cancels archiving of a virtual tape to the virtual tape shelf (VTS) * after the archiving process is initiated. *

* * @param cancelArchivalRequest Container for the necessary parameters to * execute the CancelArchival operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CancelArchival service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future cancelArchivalAsync(CancelArchivalRequest cancelArchivalRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the gateway virtual machine (VM) software. The * request immediately triggers the software update. *

*

* NOTE:When you make this request, you get a 200 OK success * response immediately. However, it might take some time for the update * to complete. You can call DescribeGatewayInformation to verify the * gateway is in the STATE_RUNNING state. *

*

* IMPORTANT:A software update forces a system restart of your * gateway. You can minimize the chance of any disruption to your * applications by increasing your iSCSI Initiators' timeouts. For more * information about increasing iSCSI Initiator timeouts for Windows and * Linux, see Customizing Your Windows iSCSI Settings and Customizing * Your Linux iSCSI Settings, respectively. *

* * @param updateGatewaySoftwareNowRequest Container for the necessary * parameters to execute the UpdateGatewaySoftwareNow operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateGatewaySoftwareNow service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateGatewaySoftwareNowAsync(UpdateGatewaySoftwareNowRequest updateGatewaySoftwareNowRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the gateway virtual machine (VM) software. The * request immediately triggers the software update. *

*

* NOTE:When you make this request, you get a 200 OK success * response immediately. However, it might take some time for the update * to complete. You can call DescribeGatewayInformation to verify the * gateway is in the STATE_RUNNING state. *

*

* IMPORTANT:A software update forces a system restart of your * gateway. You can minimize the chance of any disruption to your * applications by increasing your iSCSI Initiators' timeouts. For more * information about increasing iSCSI Initiator timeouts for Windows and * Linux, see Customizing Your Windows iSCSI Settings and Customizing * Your Linux iSCSI Settings, respectively. *

* * @param updateGatewaySoftwareNowRequest Container for the necessary * parameters to execute the UpdateGatewaySoftwareNow operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateGatewaySoftwareNow service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateGatewaySoftwareNowAsync(UpdateGatewaySoftwareNowRequest updateGatewaySoftwareNowRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation resets all cache disks that have encountered a error * and makes the disks available for reconfiguration as cache storage. If * your cache disk encounters a error, the gateway prevents read and * write operations on virtual tapes in the gateway. For example, an * error can occur when a disk is corrupted or removed from the gateway. * When a cache is reset, the gateway loses its cache storage. At this * point you can reconfigure the disks as cache disks. *

*

* IMPORTANT: If the cache disk you are resetting contains data * that has not been uploaded to Amazon S3 yet, that data can be lost. * After you reset cache disks, there will be no configured cache disks * left in the gateway, so you must configure at least one new cache disk * for your gateway to function properly. *

* * @param resetCacheRequest Container for the necessary parameters to * execute the ResetCache operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * ResetCache service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future resetCacheAsync(ResetCacheRequest resetCacheRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation resets all cache disks that have encountered a error * and makes the disks available for reconfiguration as cache storage. If * your cache disk encounters a error, the gateway prevents read and * write operations on virtual tapes in the gateway. For example, an * error can occur when a disk is corrupted or removed from the gateway. * When a cache is reset, the gateway loses its cache storage. At this * point you can reconfigure the disks as cache disks. *

*

* IMPORTANT: If the cache disk you are resetting contains data * that has not been uploaded to Amazon S3 yet, that data can be lost. * After you reset cache disks, there will be no configured cache disks * left in the gateway, so you must configure at least one new cache disk * for your gateway to function properly. *

* * @param resetCacheRequest Container for the necessary parameters to * execute the ResetCache operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ResetCache service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future resetCacheAsync(ResetCacheRequest resetCacheRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the Challenge-Handshake Authentication * Protocol (CHAP) credentials for a specified iSCSI target. By default, * a gateway does not have CHAP enabled; however, for added security, you * might use it. *

*

* IMPORTANT: When you update CHAP credentials, all existing * connections on the target are closed and initiators must reconnect * with the new credentials. *

* * @param updateChapCredentialsRequest Container for the necessary * parameters to execute the UpdateChapCredentials operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateChapCredentials service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateChapCredentialsAsync(UpdateChapCredentialsRequest updateChapCredentialsRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the Challenge-Handshake Authentication * Protocol (CHAP) credentials for a specified iSCSI target. By default, * a gateway does not have CHAP enabled; however, for added security, you * might use it. *

*

* IMPORTANT: When you update CHAP credentials, all existing * connections on the target are closed and initiators must reconnect * with the new credentials. *

* * @param updateChapCredentialsRequest Container for the necessary * parameters to execute the UpdateChapCredentials operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateChapCredentials service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateChapCredentialsAsync(UpdateChapCredentialsRequest updateChapCredentialsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation activates the gateway you previously deployed on your * host. For more information, see * Activate the AWS Storage Gateway * . In the activation process, you specify information such as the * region you want to use for storing snapshots, the time zone for * scheduled snapshots the gateway snapshot schedule window, an * activation key, and a name for your gateway. The activation process * also associates your gateway with your account; for more information, * see UpdateGatewayInformation. *

*

* NOTE:You must turn on the gateway VM before you can activate * your gateway. *

* * @param activateGatewayRequest Container for the necessary parameters * to execute the ActivateGateway operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * ActivateGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future activateGatewayAsync(ActivateGatewayRequest activateGatewayRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation activates the gateway you previously deployed on your * host. For more information, see * Activate the AWS Storage Gateway * . In the activation process, you specify information such as the * region you want to use for storing snapshots, the time zone for * scheduled snapshots the gateway snapshot schedule window, an * activation key, and a name for your gateway. The activation process * also associates your gateway with your account; for more information, * see UpdateGatewayInformation. *

*

* NOTE:You must turn on the gateway VM before you can activate * your gateway. *

* * @param activateGatewayRequest Container for the necessary parameters * to execute the ActivateGateway operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ActivateGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future activateGatewayAsync(ActivateGatewayRequest activateGatewayRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the type of medium changer in a gateway-VTL. * When you activate a gateway-VTL, you select a medium changer type for * the gateway-VTL. This operation enables you to select a different type * of medium changer after a gateway-VTL is activated. *

* * @param updateVTLDeviceTypeRequest Container for the necessary * parameters to execute the UpdateVTLDeviceType operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateVTLDeviceType service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateVTLDeviceTypeAsync(UpdateVTLDeviceTypeRequest updateVTLDeviceTypeRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the type of medium changer in a gateway-VTL. * When you activate a gateway-VTL, you select a medium changer type for * the gateway-VTL. This operation enables you to select a different type * of medium changer after a gateway-VTL is activated. *

* * @param updateVTLDeviceTypeRequest Container for the necessary * parameters to execute the UpdateVTLDeviceType operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateVTLDeviceType service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateVTLDeviceTypeAsync(UpdateVTLDeviceTypeRequest updateVTLDeviceTypeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a description of specified virtual tapes in the virtual tape * shelf (VTS). *

*

* If a specific TapeARN is not specified, AWS Storage * Gateway returns a description of all virtual tapes found in the VTS * associated with your account. *

* * @param describeTapeArchivesRequest Container for the necessary * parameters to execute the DescribeTapeArchives operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeTapeArchives service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeTapeArchivesAsync(DescribeTapeArchivesRequest describeTapeArchivesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a description of specified virtual tapes in the virtual tape * shelf (VTS). *

*

* If a specific TapeARN is not specified, AWS Storage * Gateway returns a description of all virtual tapes found in the VTS * associated with your account. *

* * @param describeTapeArchivesRequest Container for the necessary * parameters to execute the DescribeTapeArchives operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeTapeArchives service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeTapeArchivesAsync(DescribeTapeArchivesRequest describeTapeArchivesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates a gateway's metadata, which includes the * gateway's name and time zone. To specify which gateway to update, use * the Amazon Resource Name (ARN) of the gateway in your request. *

* * @param updateGatewayInformationRequest Container for the necessary * parameters to execute the UpdateGatewayInformation operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateGatewayInformation service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateGatewayInformationAsync(UpdateGatewayInformationRequest updateGatewayInformationRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates a gateway's metadata, which includes the * gateway's name and time zone. To specify which gateway to update, use * the Amazon Resource Name (ARN) of the gateway in your request. *

* * @param updateGatewayInformationRequest Container for the necessary * parameters to execute the UpdateGatewayInformation operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateGatewayInformation service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateGatewayInformationAsync(UpdateGatewayInformationRequest updateGatewayInformationRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation removes one or more tags from the specified resource. *

* * @param removeTagsFromResourceRequest Container for the necessary * parameters to execute the RemoveTagsFromResource operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * RemoveTagsFromResource service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future removeTagsFromResourceAsync(RemoveTagsFromResourceRequest removeTagsFromResourceRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation removes one or more tags from the specified resource. *

* * @param removeTagsFromResourceRequest Container for the necessary * parameters to execute the RemoveTagsFromResource operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * RemoveTagsFromResource service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future removeTagsFromResourceAsync(RemoveTagsFromResourceRequest removeTagsFromResourceRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified virtual tape from the virtual tape shelf (VTS). *

* * @param deleteTapeArchiveRequest Container for the necessary parameters * to execute the DeleteTapeArchive operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteTapeArchive service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteTapeArchiveAsync(DeleteTapeArchiveRequest deleteTapeArchiveRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified virtual tape from the virtual tape shelf (VTS). *

* * @param deleteTapeArchiveRequest Container for the necessary parameters * to execute the DeleteTapeArchive operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteTapeArchive service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteTapeArchiveAsync(DeleteTapeArchiveRequest deleteTapeArchiveRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the bandwidth rate limits of a gateway. You * can update both the upload and download bandwidth rate limit or * specify only one of the two. If you don't set a bandwidth rate limit, * the existing rate limit remains. *

*

* By default, a gateway's bandwidth rate limits are not set. If you * don't set any limit, the gateway does not have any limitations on its * bandwidth usage and could potentially use the maximum available * bandwidth. *

*

* To specify which gateway to update, use the Amazon Resource Name * (ARN) of the gateway in your request. *

* * @param updateBandwidthRateLimitRequest Container for the necessary * parameters to execute the UpdateBandwidthRateLimit operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateBandwidthRateLimit service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateBandwidthRateLimitAsync(UpdateBandwidthRateLimitRequest updateBandwidthRateLimitRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates the bandwidth rate limits of a gateway. You * can update both the upload and download bandwidth rate limit or * specify only one of the two. If you don't set a bandwidth rate limit, * the existing rate limit remains. *

*

* By default, a gateway's bandwidth rate limits are not set. If you * don't set any limit, the gateway does not have any limitations on its * bandwidth usage and could potentially use the maximum available * bandwidth. *

*

* To specify which gateway to update, use the Amazon Resource Name * (ARN) of the gateway in your request. *

* * @param updateBandwidthRateLimitRequest Container for the necessary * parameters to execute the UpdateBandwidthRateLimit operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateBandwidthRateLimit service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateBandwidthRateLimitAsync(UpdateBandwidthRateLimitRequest updateBandwidthRateLimitRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns information about the working storage of a * gateway. This operation is supported only for the gateway-stored * volume architecture. This operation is deprecated in cached-volumes * API version (20120630). Use DescribeUploadBuffer instead. *

*

* NOTE: Working storage is also referred to as upload buffer. * You can also use the DescribeUploadBuffer operation to add upload * buffer to a stored-volume gateway. *

*

* The response includes disk IDs that are configured as working * storage, and it includes the amount of working storage allocated and * used. *

* * @param describeWorkingStorageRequest Container for the necessary * parameters to execute the DescribeWorkingStorage operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeWorkingStorage service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeWorkingStorageAsync(DescribeWorkingStorageRequest describeWorkingStorageRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns information about the working storage of a * gateway. This operation is supported only for the gateway-stored * volume architecture. This operation is deprecated in cached-volumes * API version (20120630). Use DescribeUploadBuffer instead. *

*

* NOTE: Working storage is also referred to as upload buffer. * You can also use the DescribeUploadBuffer operation to add upload * buffer to a stored-volume gateway. *

*

* The response includes disk IDs that are configured as working * storage, and it includes the amount of working storage allocated and * used. *

* * @param describeWorkingStorageRequest Container for the necessary * parameters to execute the DescribeWorkingStorage operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeWorkingStorage service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeWorkingStorageAsync(DescribeWorkingStorageRequest describeWorkingStorageRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates a gateway's weekly maintenance start time * information, including day and time of the week. The maintenance time * is the time in your gateway's time zone. *

* * @param updateMaintenanceStartTimeRequest Container for the necessary * parameters to execute the UpdateMaintenanceStartTime operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateMaintenanceStartTime service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateMaintenanceStartTimeAsync(UpdateMaintenanceStartTimeRequest updateMaintenanceStartTimeRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates a gateway's weekly maintenance start time * information, including day and time of the week. The maintenance time * is the time in your gateway's time zone. *

* * @param updateMaintenanceStartTimeRequest Container for the necessary * parameters to execute the UpdateMaintenanceStartTime operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateMaintenanceStartTime service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateMaintenanceStartTimeAsync(UpdateMaintenanceStartTimeRequest updateMaintenanceStartTimeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns an array of Challenge-Handshake Authentication * Protocol (CHAP) credentials information for a specified iSCSI target, * one for each target-initiator pair. *

* * @param describeChapCredentialsRequest Container for the necessary * parameters to execute the DescribeChapCredentials operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeChapCredentials service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeChapCredentialsAsync(DescribeChapCredentialsRequest describeChapCredentialsRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns an array of Challenge-Handshake Authentication * Protocol (CHAP) credentials information for a specified iSCSI target, * one for each target-initiator pair. *

* * @param describeChapCredentialsRequest Container for the necessary * parameters to execute the DescribeChapCredentials operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeChapCredentials service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeChapCredentialsAsync(DescribeChapCredentialsRequest describeChapCredentialsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes the specified gateway volume that you * previously created using the CreateCachediSCSIVolume or * CreateStorediSCSIVolume API. For gateway-stored volumes, the local * disk that was configured as the storage volume is not deleted. You can * reuse the local disk to create another storage volume. *

*

* Before you delete a gateway volume, make sure there are no iSCSI * connections to the volume you are deleting. You should also make sure * there is no snapshot in progress. You can use the Amazon Elastic * Compute Cloud (Amazon EC2) API to query snapshots on the volume you * are deleting and check the snapshot status. For more information, go * to * DescribeSnapshots * in the Amazon Elastic Compute Cloud API Reference . *

*

* In the request, you must provide the Amazon Resource Name (ARN) of * the storage volume you want to delete. *

* * @param deleteVolumeRequest Container for the necessary parameters to * execute the DeleteVolume operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteVolume service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteVolumeAsync(DeleteVolumeRequest deleteVolumeRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes the specified gateway volume that you * previously created using the CreateCachediSCSIVolume or * CreateStorediSCSIVolume API. For gateway-stored volumes, the local * disk that was configured as the storage volume is not deleted. You can * reuse the local disk to create another storage volume. *

*

* Before you delete a gateway volume, make sure there are no iSCSI * connections to the volume you are deleting. You should also make sure * there is no snapshot in progress. You can use the Amazon Elastic * Compute Cloud (Amazon EC2) API to query snapshots on the volume you * are deleting and check the snapshot status. For more information, go * to * DescribeSnapshots * in the Amazon Elastic Compute Cloud API Reference . *

*

* In the request, you must provide the Amazon Resource Name (ARN) of * the storage volume you want to delete. *

* * @param deleteVolumeRequest Container for the necessary parameters to * execute the DeleteVolume operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteVolume service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteVolumeAsync(DeleteVolumeRequest deleteVolumeRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation describes the snapshot schedule for the specified * gateway volume. The snapshot schedule information includes intervals * at which snapshots are automatically initiated on the volume. *

* * @param describeSnapshotScheduleRequest Container for the necessary * parameters to execute the DescribeSnapshotSchedule operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeSnapshotSchedule service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeSnapshotScheduleAsync(DescribeSnapshotScheduleRequest describeSnapshotScheduleRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation describes the snapshot schedule for the specified * gateway volume. The snapshot schedule information includes intervals * at which snapshots are automatically initiated on the volume. *

* * @param describeSnapshotScheduleRequest Container for the necessary * parameters to execute the DescribeSnapshotSchedule operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeSnapshotSchedule service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeSnapshotScheduleAsync(DescribeSnapshotScheduleRequest describeSnapshotScheduleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes a gateway. To specify which gateway to delete, * use the Amazon Resource Name (ARN) of the gateway in your request. The * operation deletes the gateway; however, it does not delete the gateway * virtual machine (VM) from your host computer. *

*

* After you delete a gateway, you cannot reactivate it. Completed * snapshots of the gateway volumes are not deleted upon deleting the * gateway, however, pending snapshots will not complete. After you * delete a gateway, your next step is to remove it from your * environment. *

*

* IMPORTANT: You no longer pay software charges after the * gateway is deleted; however, your existing Amazon EBS snapshots * persist and you will continue to be billed for these snapshots.??You * can choose to remove all remaining Amazon EBS snapshots by canceling * your Amazon EC2 subscription.?? If you prefer not to cancel your * Amazon EC2 subscription, you can delete your snapshots using the * Amazon EC2 console. For more information, see the AWS Storage Gateway * Detail Page. *

* * @param deleteGatewayRequest Container for the necessary parameters to * execute the DeleteGateway operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteGatewayAsync(DeleteGatewayRequest deleteGatewayRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes a gateway. To specify which gateway to delete, * use the Amazon Resource Name (ARN) of the gateway in your request. The * operation deletes the gateway; however, it does not delete the gateway * virtual machine (VM) from your host computer. *

*

* After you delete a gateway, you cannot reactivate it. Completed * snapshots of the gateway volumes are not deleted upon deleting the * gateway, however, pending snapshots will not complete. After you * delete a gateway, your next step is to remove it from your * environment. *

*

* IMPORTANT: You no longer pay software charges after the * gateway is deleted; however, your existing Amazon EBS snapshots * persist and you will continue to be billed for these snapshots.??You * can choose to remove all remaining Amazon EBS snapshots by canceling * your Amazon EC2 subscription.?? If you prefer not to cancel your * Amazon EC2 subscription, you can delete your snapshots using the * Amazon EC2 console. For more information, see the AWS Storage Gateway * Detail Page. *

* * @param deleteGatewayRequest Container for the necessary parameters to * execute the DeleteGateway operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteGateway service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteGatewayAsync(DeleteGatewayRequest deleteGatewayRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes the bandwidth rate limits of a gateway. You * can delete either the upload and download bandwidth rate limit, or you * can delete both. If you delete only one of the limits, the other limit * remains unchanged. To specify which gateway to work with, use the * Amazon Resource Name (ARN) of the gateway in your request. *

* * @param deleteBandwidthRateLimitRequest Container for the necessary * parameters to execute the DeleteBandwidthRateLimit operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DeleteBandwidthRateLimit service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteBandwidthRateLimitAsync(DeleteBandwidthRateLimitRequest deleteBandwidthRateLimitRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation deletes the bandwidth rate limits of a gateway. You * can delete either the upload and download bandwidth rate limit, or you * can delete both. If you delete only one of the limits, the other limit * remains unchanged. To specify which gateway to work with, use the * Amazon Resource Name (ARN) of the gateway in your request. *

* * @param deleteBandwidthRateLimitRequest Container for the necessary * parameters to execute the DeleteBandwidthRateLimit operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteBandwidthRateLimit service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteBandwidthRateLimitAsync(DeleteBandwidthRateLimitRequest deleteBandwidthRateLimitRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists the iSCSI stored volumes of a gateway. Results * are sorted by volume ARN. The response includes only the volume ARNs. * If you want additional volume information, use the * DescribeStorediSCSIVolumes API. *

*

* The operation supports pagination. By default, the operation returns * a maximum of up to 100 volumes. You can optionally specify the * Limit field in the body to limit the number of volumes in * the response. If the number of volumes returned in the response is * truncated, the response includes a Marker field. You can use this * Marker value in your subsequent request to retrieve the next set of * volumes. *

* * @param listVolumesRequest Container for the necessary parameters to * execute the ListVolumes operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * ListVolumes service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listVolumesAsync(ListVolumesRequest listVolumesRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation lists the iSCSI stored volumes of a gateway. Results * are sorted by volume ARN. The response includes only the volume ARNs. * If you want additional volume information, use the * DescribeStorediSCSIVolumes API. *

*

* The operation supports pagination. By default, the operation returns * a maximum of up to 100 volumes. You can optionally specify the * Limit field in the body to limit the number of volumes in * the response. If the number of volumes returned in the response is * truncated, the response includes a Marker field. You can use this * Marker value in your subsequent request to retrieve the next set of * volumes. *

* * @param listVolumesRequest Container for the necessary parameters to * execute the ListVolumes operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListVolumes service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future listVolumesAsync(ListVolumesRequest listVolumesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates a snapshot schedule configured for a gateway * volume. *

*

* The default snapshot schedule for volume is once every 24 hours, * starting at the creation time of the volume. You can use this API to * change the snapshot schedule configured for the volume. *

*

* In the request you must identify the gateway volume whose snapshot * schedule you want to update, and the schedule information, including * when you want the snapshot to begin on a day and the frequency (in * hours) of snapshots. *

* * @param updateSnapshotScheduleRequest Container for the necessary * parameters to execute the UpdateSnapshotSchedule operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * UpdateSnapshotSchedule service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateSnapshotScheduleAsync(UpdateSnapshotScheduleRequest updateSnapshotScheduleRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation updates a snapshot schedule configured for a gateway * volume. *

*

* The default snapshot schedule for volume is once every 24 hours, * starting at the creation time of the volume. You can use this API to * change the snapshot schedule configured for the volume. *

*

* In the request you must identify the gateway volume whose snapshot * schedule you want to update, and the schedule information, including * when you want the snapshot to begin on a day and the frequency (in * hours) of snapshots. *

* * @param updateSnapshotScheduleRequest Container for the necessary * parameters to execute the UpdateSnapshotSchedule operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateSnapshotSchedule service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future updateSnapshotScheduleAsync(UpdateSnapshotScheduleRequest updateSnapshotScheduleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation configures one or more gateway local disks as upload * buffer for a specified gateway. This operation is supported for both * the gateway-stored and gateway-cached volume architectures. *

*

* In the request, you specify the gateway Amazon Resource Name (ARN) to * which you want to add upload buffer, and one or more disk IDs that you * want to configure as upload buffer. *

* * @param addUploadBufferRequest Container for the necessary parameters * to execute the AddUploadBuffer operation on AWSStorageGateway. * * @return A Java Future object containing the response from the * AddUploadBuffer service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addUploadBufferAsync(AddUploadBufferRequest addUploadBufferRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation configures one or more gateway local disks as upload * buffer for a specified gateway. This operation is supported for both * the gateway-stored and gateway-cached volume architectures. *

*

* In the request, you specify the gateway Amazon Resource Name (ARN) to * which you want to add upload buffer, and one or more disk IDs that you * want to configure as upload buffer. *

* * @param addUploadBufferRequest Container for the necessary parameters * to execute the AddUploadBuffer operation on AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * AddUploadBuffer service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future addUploadBufferAsync(AddUploadBufferRequest addUploadBufferRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns a description of the gateway volumes specified * in the request. This operation is supported only for the * gateway-cached volume architecture. *

*

* The list of gateway volumes in the request must be from one gateway. * In the response Amazon Storage Gateway returns volume information * sorted by volume Amazon Resource Name (ARN). *

* * @param describeCachediSCSIVolumesRequest Container for the necessary * parameters to execute the DescribeCachediSCSIVolumes operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * DescribeCachediSCSIVolumes service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeCachediSCSIVolumesAsync(DescribeCachediSCSIVolumesRequest describeCachediSCSIVolumesRequest) throws AmazonServiceException, AmazonClientException; /** *

* This operation returns a description of the gateway volumes specified * in the request. This operation is supported only for the * gateway-cached volume architecture. *

*

* The list of gateway volumes in the request must be from one gateway. * In the response Amazon Storage Gateway returns volume information * sorted by volume Amazon Resource Name (ARN). *

* * @param describeCachediSCSIVolumesRequest Container for the necessary * parameters to execute the DescribeCachediSCSIVolumes operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeCachediSCSIVolumes service method, as returned by * AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future describeCachediSCSIVolumesAsync(DescribeCachediSCSIVolumesRequest describeCachediSCSIVolumesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Retrieves an archived virtual tape from the virtual tape shelf (VTS) * to a gateway-VTL. Virtual tapes archived in the VTS are not associated * with any gateway. However after a tape is retrieved, it is associated * with a gateway, even though it is also listed in the VTS. *

*

* Once a tape is successfully retrieved to a gateway, it cannot be * retrieved again to another gateway. You must archive the tape again * before you can retrieve it to another gateway. *

* * @param retrieveTapeArchiveRequest Container for the necessary * parameters to execute the RetrieveTapeArchive operation on * AWSStorageGateway. * * @return A Java Future object containing the response from the * RetrieveTapeArchive service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future retrieveTapeArchiveAsync(RetrieveTapeArchiveRequest retrieveTapeArchiveRequest) throws AmazonServiceException, AmazonClientException; /** *

* Retrieves an archived virtual tape from the virtual tape shelf (VTS) * to a gateway-VTL. Virtual tapes archived in the VTS are not associated * with any gateway. However after a tape is retrieved, it is associated * with a gateway, even though it is also listed in the VTS. *

*

* Once a tape is successfully retrieved to a gateway, it cannot be * retrieved again to another gateway. You must archive the tape again * before you can retrieve it to another gateway. *

* * @param retrieveTapeArchiveRequest Container for the necessary * parameters to execute the RetrieveTapeArchive operation on * AWSStorageGateway. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * RetrieveTapeArchive service method, as returned by AWSStorageGateway. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AWSStorageGateway indicating * either a problem with the data in the request, or a server side issue. */ public Future retrieveTapeArchiveAsync(RetrieveTapeArchiveRequest retrieveTapeArchiveRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy