com.amazonaws.services.glacier.AmazonGlacierAsync Maven / Gradle / Ivy
/*
* Copyright 2010-2016 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.glacier;
import com.amazonaws.services.glacier.model.*;
/**
* Interface for accessing Amazon Glacier asynchronously. Each asynchronous
* method will return a Java Future object representing the asynchronous
* operation; overloads which accept an {@code AsyncHandler} can be used to
* receive notification when an asynchronous operation completes.
*
*
* Amazon Glacier is a storage solution for "cold data."
*
*
* Amazon Glacier is an extremely low-cost storage service that provides secure,
* durable, and easy-to-use storage for data backup and archival. With Amazon
* Glacier, customers can store their data cost effectively for months, years,
* or decades. Amazon Glacier also enables customers to offload the
* administrative burdens of operating and scaling storage to AWS, so they don't
* have to worry about capacity planning, hardware provisioning, data
* replication, hardware failure and recovery, or time-consuming hardware
* migrations.
*
*
* Amazon Glacier is a great storage choice when low storage cost is paramount,
* your data is rarely retrieved, and retrieval latency of several hours is
* acceptable. If your application requires fast or frequent access to your
* data, consider using Amazon S3. For more information, go to Amazon Simple Storage Service (Amazon
* S3).
*
*
* You can store any kind of data in any format. There is no maximum limit on
* the total amount of data you can store in Amazon Glacier.
*
*
* If you are a first-time user of Amazon Glacier, we recommend that you begin
* by reading the following sections in the Amazon Glacier Developer
* Guide:
*
*
* -
*
* What
* is Amazon Glacier - This section of the Developer Guide describes the
* underlying data model, the operations it supports, and the AWS SDKs that you
* can use to interact with the service.
*
*
* -
*
* Getting Started with Amazon Glacier - The Getting Started section walks
* you through the process of creating a vault, uploading archives, creating
* jobs to download archives, retrieving the job output, and deleting archives.
*
*
*
*/
public interface AmazonGlacierAsync extends AmazonGlacier {
/**
*
* This operation aborts a multipart upload identified by the upload ID.
*
*
* After the Abort Multipart Upload request succeeds, you cannot upload any
* more parts to the multipart upload or complete the multipart upload.
* Aborting a completed upload fails. However, aborting an already-aborted
* upload will succeed, for a short time. For more information about
* uploading a part and completing a multipart upload, see
* UploadMultipartPart and CompleteMultipartUpload.
*
*
* This operation is idempotent.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Working with Archives in Amazon Glacier and Abort Multipart Upload in the Amazon Glacier Developer Guide.
*
*
* @param abortMultipartUploadRequest
* Provides options to abort a multipart upload identified by the
* upload ID.
*
* For information about the underlying REST API, go to Abort Multipart Upload. For conceptual information, go to Working with Archives in Amazon Glacier.
* @return A Java Future containing the result of the AbortMultipartUpload
* operation returned by the service.
* @sample AmazonGlacierAsync.AbortMultipartUpload
*/
java.util.concurrent.Future abortMultipartUploadAsync(
AbortMultipartUploadRequest abortMultipartUploadRequest);
/**
*
* This operation aborts a multipart upload identified by the upload ID.
*
*
* After the Abort Multipart Upload request succeeds, you cannot upload any
* more parts to the multipart upload or complete the multipart upload.
* Aborting a completed upload fails. However, aborting an already-aborted
* upload will succeed, for a short time. For more information about
* uploading a part and completing a multipart upload, see
* UploadMultipartPart and CompleteMultipartUpload.
*
*
* This operation is idempotent.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Working with Archives in Amazon Glacier and Abort Multipart Upload in the Amazon Glacier Developer Guide.
*
*
* @param abortMultipartUploadRequest
* Provides options to abort a multipart upload identified by the
* upload ID.
*
* For information about the underlying REST API, go to Abort Multipart Upload. For conceptual information, go to Working with Archives in Amazon Glacier.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the AbortMultipartUpload
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.AbortMultipartUpload
*/
java.util.concurrent.Future abortMultipartUploadAsync(
AbortMultipartUploadRequest abortMultipartUploadRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation aborts the vault locking process if the vault lock is not
* in the Locked state. If the vault lock is in the
* Locked state when this operation is requested, the operation
* returns an AccessDeniedException error. Aborting the vault
* locking process removes the vault lock policy from the specified vault.
*
*
* A vault lock is put into the InProgress state by calling
* InitiateVaultLock. A vault lock is put into the
* Locked state by calling CompleteVaultLock. You can
* get the state of a vault lock by calling GetVaultLock. For more
* information about the vault locking process, see Amazon Glacier Vault Lock. For more information about vault lock
* policies, see Amazon Glacier Access Control with Vault Lock Policies.
*
*
* This operation is idempotent. You can successfully invoke this operation
* multiple times, if the vault lock is in the InProgress state
* or if there is no policy associated with the vault.
*
*
* @param abortVaultLockRequest
* The input values for AbortVaultLock.
* @return A Java Future containing the result of the AbortVaultLock
* operation returned by the service.
* @sample AmazonGlacierAsync.AbortVaultLock
*/
java.util.concurrent.Future abortVaultLockAsync(
AbortVaultLockRequest abortVaultLockRequest);
/**
*
* This operation aborts the vault locking process if the vault lock is not
* in the Locked state. If the vault lock is in the
* Locked state when this operation is requested, the operation
* returns an AccessDeniedException error. Aborting the vault
* locking process removes the vault lock policy from the specified vault.
*
*
* A vault lock is put into the InProgress state by calling
* InitiateVaultLock. A vault lock is put into the
* Locked state by calling CompleteVaultLock. You can
* get the state of a vault lock by calling GetVaultLock. For more
* information about the vault locking process, see Amazon Glacier Vault Lock. For more information about vault lock
* policies, see Amazon Glacier Access Control with Vault Lock Policies.
*
*
* This operation is idempotent. You can successfully invoke this operation
* multiple times, if the vault lock is in the InProgress state
* or if there is no policy associated with the vault.
*
*
* @param abortVaultLockRequest
* The input values for AbortVaultLock.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the AbortVaultLock
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.AbortVaultLock
*/
java.util.concurrent.Future abortVaultLockAsync(
AbortVaultLockRequest abortVaultLockRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation adds the specified tags to a vault. Each tag is composed
* of a key and a value. Each vault can have up to 10 tags. If your request
* would cause the tag limit for the vault to be exceeded, the operation
* throws the LimitExceededException error. If a tag already
* exists on the vault under a specified key, the existing key value will be
* overwritten. For more information about tags, see Tagging Amazon Glacier Resources.
*
*
* @param addTagsToVaultRequest
* The input values for AddTagsToVault.
* @return A Java Future containing the result of the AddTagsToVault
* operation returned by the service.
* @sample AmazonGlacierAsync.AddTagsToVault
*/
java.util.concurrent.Future addTagsToVaultAsync(
AddTagsToVaultRequest addTagsToVaultRequest);
/**
*
* This operation adds the specified tags to a vault. Each tag is composed
* of a key and a value. Each vault can have up to 10 tags. If your request
* would cause the tag limit for the vault to be exceeded, the operation
* throws the LimitExceededException error. If a tag already
* exists on the vault under a specified key, the existing key value will be
* overwritten. For more information about tags, see Tagging Amazon Glacier Resources.
*
*
* @param addTagsToVaultRequest
* The input values for AddTagsToVault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the AddTagsToVault
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.AddTagsToVault
*/
java.util.concurrent.Future addTagsToVaultAsync(
AddTagsToVaultRequest addTagsToVaultRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* You call this operation to inform Amazon Glacier that all the archive
* parts have been uploaded and that Amazon Glacier can now assemble the
* archive from the uploaded parts. After assembling and saving the archive
* to the vault, Amazon Glacier returns the URI path of the newly created
* archive resource. Using the URI path, you can then access the archive.
* After you upload an archive, you should save the archive ID returned to
* retrieve the archive at a later point. You can also get the vault
* inventory to obtain a list of archive IDs in a vault. For more
* information, see InitiateJob.
*
*
* In the request, you must include the computed SHA256 tree hash of the
* entire archive you have uploaded. For information about computing a
* SHA256 tree hash, see Computing Checksums. On the server side, Amazon Glacier also
* constructs the SHA256 tree hash of the assembled archive. If the values
* match, Amazon Glacier saves the archive to the vault; otherwise, it
* returns an error, and the operation fails. The ListParts operation
* returns a list of parts uploaded for a specific multipart upload. It
* includes checksum information for each uploaded part that can be used to
* debug a bad checksum issue.
*
*
* Additionally, Amazon Glacier also checks for any missing content ranges
* when assembling the archive, if missing content ranges are found, Amazon
* Glacier returns an error and the operation fails.
*
*
* Complete Multipart Upload is an idempotent operation. After your first
* successful complete multipart upload, if you call the operation again
* within a short period, the operation will succeed and return the same
* archive ID. This is useful in the event you experience a network issue
* that causes an aborted connection or receive a 500 server error, in which
* case you can repeat your Complete Multipart Upload request and get the
* same archive ID without creating duplicate archives. Note, however, that
* after the multipart upload completes, you cannot call the List Parts
* operation and the multipart upload will not appear in List Multipart
* Uploads response, even if idempotent complete is possible.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Complete Multipart Upload in the Amazon Glacier Developer
* Guide.
*
*
* @param completeMultipartUploadRequest
* Provides options to complete a multipart upload operation. This
* informs Amazon Glacier that all the archive parts have been
* uploaded and Amazon Glacier can now assemble the archive from the
* uploaded parts. After assembling and saving the archive to the
* vault, Amazon Glacier returns the URI path of the newly created
* archive resource.
* @return A Java Future containing the result of the
* CompleteMultipartUpload operation returned by the service.
* @sample AmazonGlacierAsync.CompleteMultipartUpload
*/
java.util.concurrent.Future completeMultipartUploadAsync(
CompleteMultipartUploadRequest completeMultipartUploadRequest);
/**
*
* You call this operation to inform Amazon Glacier that all the archive
* parts have been uploaded and that Amazon Glacier can now assemble the
* archive from the uploaded parts. After assembling and saving the archive
* to the vault, Amazon Glacier returns the URI path of the newly created
* archive resource. Using the URI path, you can then access the archive.
* After you upload an archive, you should save the archive ID returned to
* retrieve the archive at a later point. You can also get the vault
* inventory to obtain a list of archive IDs in a vault. For more
* information, see InitiateJob.
*
*
* In the request, you must include the computed SHA256 tree hash of the
* entire archive you have uploaded. For information about computing a
* SHA256 tree hash, see Computing Checksums. On the server side, Amazon Glacier also
* constructs the SHA256 tree hash of the assembled archive. If the values
* match, Amazon Glacier saves the archive to the vault; otherwise, it
* returns an error, and the operation fails. The ListParts operation
* returns a list of parts uploaded for a specific multipart upload. It
* includes checksum information for each uploaded part that can be used to
* debug a bad checksum issue.
*
*
* Additionally, Amazon Glacier also checks for any missing content ranges
* when assembling the archive, if missing content ranges are found, Amazon
* Glacier returns an error and the operation fails.
*
*
* Complete Multipart Upload is an idempotent operation. After your first
* successful complete multipart upload, if you call the operation again
* within a short period, the operation will succeed and return the same
* archive ID. This is useful in the event you experience a network issue
* that causes an aborted connection or receive a 500 server error, in which
* case you can repeat your Complete Multipart Upload request and get the
* same archive ID without creating duplicate archives. Note, however, that
* after the multipart upload completes, you cannot call the List Parts
* operation and the multipart upload will not appear in List Multipart
* Uploads response, even if idempotent complete is possible.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Complete Multipart Upload in the Amazon Glacier Developer
* Guide.
*
*
* @param completeMultipartUploadRequest
* Provides options to complete a multipart upload operation. This
* informs Amazon Glacier that all the archive parts have been
* uploaded and Amazon Glacier can now assemble the archive from the
* uploaded parts. After assembling and saving the archive to the
* vault, Amazon Glacier returns the URI path of the newly created
* archive resource.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the
* CompleteMultipartUpload operation returned by the service.
* @sample AmazonGlacierAsyncHandler.CompleteMultipartUpload
*/
java.util.concurrent.Future completeMultipartUploadAsync(
CompleteMultipartUploadRequest completeMultipartUploadRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation completes the vault locking process by transitioning the
* vault lock from the InProgress state to the
* Locked state, which causes the vault lock policy to become
* unchangeable. A vault lock is put into the InProgress state
* by calling InitiateVaultLock. You can obtain the state of the
* vault lock by calling GetVaultLock. For more information about the
* vault locking process, Amazon Glacier Vault Lock.
*
*
* This operation is idempotent. This request is always successful if the
* vault lock is in the Locked state and the provided lock ID
* matches the lock ID originally used to lock the vault.
*
*
* If an invalid lock ID is passed in the request when the vault lock is in
* the Locked state, the operation returns an
* AccessDeniedException error. If an invalid lock ID is passed
* in the request when the vault lock is in the InProgress
* state, the operation throws an InvalidParameter error.
*
*
* @param completeVaultLockRequest
* The input values for CompleteVaultLock.
* @return A Java Future containing the result of the CompleteVaultLock
* operation returned by the service.
* @sample AmazonGlacierAsync.CompleteVaultLock
*/
java.util.concurrent.Future completeVaultLockAsync(
CompleteVaultLockRequest completeVaultLockRequest);
/**
*
* This operation completes the vault locking process by transitioning the
* vault lock from the InProgress state to the
* Locked state, which causes the vault lock policy to become
* unchangeable. A vault lock is put into the InProgress state
* by calling InitiateVaultLock. You can obtain the state of the
* vault lock by calling GetVaultLock. For more information about the
* vault locking process, Amazon Glacier Vault Lock.
*
*
* This operation is idempotent. This request is always successful if the
* vault lock is in the Locked state and the provided lock ID
* matches the lock ID originally used to lock the vault.
*
*
* If an invalid lock ID is passed in the request when the vault lock is in
* the Locked state, the operation returns an
* AccessDeniedException error. If an invalid lock ID is passed
* in the request when the vault lock is in the InProgress
* state, the operation throws an InvalidParameter error.
*
*
* @param completeVaultLockRequest
* The input values for CompleteVaultLock.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the CompleteVaultLock
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.CompleteVaultLock
*/
java.util.concurrent.Future completeVaultLockAsync(
CompleteVaultLockRequest completeVaultLockRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation creates a new vault with the specified name. The name of
* the vault must be unique within a region for an AWS account. You can
* create up to 1,000 vaults per account. If you need to create more vaults,
* contact Amazon Glacier.
*
*
* You must use the following guidelines when naming a vault.
*
*
*
* -
*
* Names can be between 1 and 255 characters long.
*
*
* -
*
* Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and
* '.' (period).
*
*
*
*
*
* This operation is idempotent.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Creating a Vault in Amazon Glacier and Create Vault in the Amazon Glacier Developer Guide.
*
*
* @param createVaultRequest
* Provides options to create a vault.
* @return A Java Future containing the result of the CreateVault operation
* returned by the service.
* @sample AmazonGlacierAsync.CreateVault
*/
java.util.concurrent.Future createVaultAsync(
CreateVaultRequest createVaultRequest);
/**
*
* This operation creates a new vault with the specified name. The name of
* the vault must be unique within a region for an AWS account. You can
* create up to 1,000 vaults per account. If you need to create more vaults,
* contact Amazon Glacier.
*
*
* You must use the following guidelines when naming a vault.
*
*
*
* -
*
* Names can be between 1 and 255 characters long.
*
*
* -
*
* Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and
* '.' (period).
*
*
*
*
*
* This operation is idempotent.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Creating a Vault in Amazon Glacier and Create Vault in the Amazon Glacier Developer Guide.
*
*
* @param createVaultRequest
* Provides options to create a vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the CreateVault operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.CreateVault
*/
java.util.concurrent.Future createVaultAsync(
CreateVaultRequest createVaultRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation deletes an archive from a vault. Subsequent requests to
* initiate a retrieval of this archive will fail. Archive retrievals that
* are in progress for this archive ID may or may not succeed according to
* the following scenarios:
*
*
* - If the archive retrieval job is actively preparing the data for
* download when Amazon Glacier receives the delete archive request, the
* archival retrieval operation might fail.
* - If the archive retrieval job has successfully prepared the archive
* for download when Amazon Glacier receives the delete archive request, you
* will be able to download the output.
*
*
* This operation is idempotent. Attempting to delete an already-deleted
* archive does not result in an error.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Deleting an Archive in Amazon Glacier and Delete Archive in the Amazon Glacier Developer Guide.
*
*
* @param deleteArchiveRequest
* Provides options for deleting an archive from an Amazon Glacier
* vault.
* @return A Java Future containing the result of the DeleteArchive
* operation returned by the service.
* @sample AmazonGlacierAsync.DeleteArchive
*/
java.util.concurrent.Future deleteArchiveAsync(
DeleteArchiveRequest deleteArchiveRequest);
/**
*
* This operation deletes an archive from a vault. Subsequent requests to
* initiate a retrieval of this archive will fail. Archive retrievals that
* are in progress for this archive ID may or may not succeed according to
* the following scenarios:
*
*
* - If the archive retrieval job is actively preparing the data for
* download when Amazon Glacier receives the delete archive request, the
* archival retrieval operation might fail.
* - If the archive retrieval job has successfully prepared the archive
* for download when Amazon Glacier receives the delete archive request, you
* will be able to download the output.
*
*
* This operation is idempotent. Attempting to delete an already-deleted
* archive does not result in an error.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Deleting an Archive in Amazon Glacier and Delete Archive in the Amazon Glacier Developer Guide.
*
*
* @param deleteArchiveRequest
* Provides options for deleting an archive from an Amazon Glacier
* vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the DeleteArchive
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.DeleteArchive
*/
java.util.concurrent.Future deleteArchiveAsync(
DeleteArchiveRequest deleteArchiveRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation deletes a vault. Amazon Glacier will delete a vault only
* if there are no archives in the vault as of the last inventory and there
* have been no writes to the vault since the last inventory. If either of
* these conditions is not satisfied, the vault deletion fails (that is, the
* vault is not removed) and Amazon Glacier returns an error. You can use
* DescribeVault to return the number of archives in a vault, and you
* can use Initiate a Job (POST jobs) to initiate a new inventory retrieval for
* a vault. The inventory contains the archive IDs you use to delete
* archives using Delete Archive (DELETE archive).
*
*
* This operation is idempotent.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Deleting a Vault in Amazon Glacier and Delete Vault in the Amazon Glacier Developer Guide.
*
*
* @param deleteVaultRequest
* Provides options for deleting a vault from Amazon Glacier.
* @return A Java Future containing the result of the DeleteVault operation
* returned by the service.
* @sample AmazonGlacierAsync.DeleteVault
*/
java.util.concurrent.Future deleteVaultAsync(
DeleteVaultRequest deleteVaultRequest);
/**
*
* This operation deletes a vault. Amazon Glacier will delete a vault only
* if there are no archives in the vault as of the last inventory and there
* have been no writes to the vault since the last inventory. If either of
* these conditions is not satisfied, the vault deletion fails (that is, the
* vault is not removed) and Amazon Glacier returns an error. You can use
* DescribeVault to return the number of archives in a vault, and you
* can use Initiate a Job (POST jobs) to initiate a new inventory retrieval for
* a vault. The inventory contains the archive IDs you use to delete
* archives using Delete Archive (DELETE archive).
*
*
* This operation is idempotent.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Deleting a Vault in Amazon Glacier and Delete Vault in the Amazon Glacier Developer Guide.
*
*
* @param deleteVaultRequest
* Provides options for deleting a vault from Amazon Glacier.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the DeleteVault operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.DeleteVault
*/
java.util.concurrent.Future deleteVaultAsync(
DeleteVaultRequest deleteVaultRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation deletes the access policy associated with the specified
* vault. The operation is eventually consistent; that is, it might take
* some time for Amazon Glacier to completely remove the access policy, and
* you might still see the effect of the policy for a short time after you
* send the delete request.
*
*
* This operation is idempotent. You can invoke delete multiple times, even
* if there is no policy associated with the vault. For more information
* about vault access policies, see Amazon Glacier Access Control with Vault Access Policies.
*
*
* @param deleteVaultAccessPolicyRequest
* DeleteVaultAccessPolicy input.
* @return A Java Future containing the result of the
* DeleteVaultAccessPolicy operation returned by the service.
* @sample AmazonGlacierAsync.DeleteVaultAccessPolicy
*/
java.util.concurrent.Future deleteVaultAccessPolicyAsync(
DeleteVaultAccessPolicyRequest deleteVaultAccessPolicyRequest);
/**
*
* This operation deletes the access policy associated with the specified
* vault. The operation is eventually consistent; that is, it might take
* some time for Amazon Glacier to completely remove the access policy, and
* you might still see the effect of the policy for a short time after you
* send the delete request.
*
*
* This operation is idempotent. You can invoke delete multiple times, even
* if there is no policy associated with the vault. For more information
* about vault access policies, see Amazon Glacier Access Control with Vault Access Policies.
*
*
* @param deleteVaultAccessPolicyRequest
* DeleteVaultAccessPolicy input.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the
* DeleteVaultAccessPolicy operation returned by the service.
* @sample AmazonGlacierAsyncHandler.DeleteVaultAccessPolicy
*/
java.util.concurrent.Future deleteVaultAccessPolicyAsync(
DeleteVaultAccessPolicyRequest deleteVaultAccessPolicyRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation deletes the notification configuration set for a vault.
* The operation is eventually consistent; that is, it might take some time
* for Amazon Glacier to completely disable the notifications and you might
* still receive some notifications for a short time after you send the
* delete request.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Configuring Vault Notifications in Amazon Glacier and Delete Vault Notification Configuration in the Amazon Glacier
* Developer Guide.
*
*
* @param deleteVaultNotificationsRequest
* Provides options for deleting a vault notification configuration
* from an Amazon Glacier vault.
* @return A Java Future containing the result of the
* DeleteVaultNotifications operation returned by the service.
* @sample AmazonGlacierAsync.DeleteVaultNotifications
*/
java.util.concurrent.Future deleteVaultNotificationsAsync(
DeleteVaultNotificationsRequest deleteVaultNotificationsRequest);
/**
*
* This operation deletes the notification configuration set for a vault.
* The operation is eventually consistent; that is, it might take some time
* for Amazon Glacier to completely disable the notifications and you might
* still receive some notifications for a short time after you send the
* delete request.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Configuring Vault Notifications in Amazon Glacier and Delete Vault Notification Configuration in the Amazon Glacier
* Developer Guide.
*
*
* @param deleteVaultNotificationsRequest
* Provides options for deleting a vault notification configuration
* from an Amazon Glacier vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the
* DeleteVaultNotifications operation returned by the service.
* @sample AmazonGlacierAsyncHandler.DeleteVaultNotifications
*/
java.util.concurrent.Future deleteVaultNotificationsAsync(
DeleteVaultNotificationsRequest deleteVaultNotificationsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation returns information about a job you previously initiated,
* including the job initiation date, the user who initiated the job, the
* job status code/message and the Amazon SNS topic to notify after Amazon
* Glacier completes the job. For more information about initiating a job,
* see InitiateJob.
*
*
*
* This operation enables you to check the status of your job. However, it
* is strongly recommended that you set up an Amazon SNS topic and specify
* it in your initiate job request so that Amazon Glacier can notify the
* topic after it completes the job.
*
*
*
* A job ID will not expire for at least 24 hours after Amazon Glacier
* completes the job.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For information about the underlying REST API, go to Working with Archives in Amazon Glacier in the Amazon Glacier
* Developer Guide.
*
*
* @param describeJobRequest
* Provides options for retrieving a job description.
* @return A Java Future containing the result of the DescribeJob operation
* returned by the service.
* @sample AmazonGlacierAsync.DescribeJob
*/
java.util.concurrent.Future describeJobAsync(
DescribeJobRequest describeJobRequest);
/**
*
* This operation returns information about a job you previously initiated,
* including the job initiation date, the user who initiated the job, the
* job status code/message and the Amazon SNS topic to notify after Amazon
* Glacier completes the job. For more information about initiating a job,
* see InitiateJob.
*
*
*
* This operation enables you to check the status of your job. However, it
* is strongly recommended that you set up an Amazon SNS topic and specify
* it in your initiate job request so that Amazon Glacier can notify the
* topic after it completes the job.
*
*
*
* A job ID will not expire for at least 24 hours after Amazon Glacier
* completes the job.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For information about the underlying REST API, go to Working with Archives in Amazon Glacier in the Amazon Glacier
* Developer Guide.
*
*
* @param describeJobRequest
* Provides options for retrieving a job description.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the DescribeJob operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.DescribeJob
*/
java.util.concurrent.Future describeJobAsync(
DescribeJobRequest describeJobRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation returns information about a vault, including the vault's
* Amazon Resource Name (ARN), the date the vault was created, the number of
* archives it contains, and the total size of all the archives in the
* vault. The number of archives and their total size are as of the last
* inventory generation. This means that if you add or remove an archive
* from a vault, and then immediately use Describe Vault, the change in
* contents will not be immediately reflected. If you want to retrieve the
* latest inventory of the vault, use InitiateJob. Amazon Glacier
* generates vault inventories approximately daily. For more information,
* see Downloading a Vault Inventory in Amazon Glacier.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Retrieving Vault Metadata in Amazon Glacier and Describe Vault in the Amazon Glacier Developer Guide.
*
*
* @param describeVaultRequest
* Provides options for retrieving metadata for a specific vault in
* Amazon Glacier.
* @return A Java Future containing the result of the DescribeVault
* operation returned by the service.
* @sample AmazonGlacierAsync.DescribeVault
*/
java.util.concurrent.Future describeVaultAsync(
DescribeVaultRequest describeVaultRequest);
/**
*
* This operation returns information about a vault, including the vault's
* Amazon Resource Name (ARN), the date the vault was created, the number of
* archives it contains, and the total size of all the archives in the
* vault. The number of archives and their total size are as of the last
* inventory generation. This means that if you add or remove an archive
* from a vault, and then immediately use Describe Vault, the change in
* contents will not be immediately reflected. If you want to retrieve the
* latest inventory of the vault, use InitiateJob. Amazon Glacier
* generates vault inventories approximately daily. For more information,
* see Downloading a Vault Inventory in Amazon Glacier.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Retrieving Vault Metadata in Amazon Glacier and Describe Vault in the Amazon Glacier Developer Guide.
*
*
* @param describeVaultRequest
* Provides options for retrieving metadata for a specific vault in
* Amazon Glacier.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the DescribeVault
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.DescribeVault
*/
java.util.concurrent.Future describeVaultAsync(
DescribeVaultRequest describeVaultRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation returns the current data retrieval policy for the account
* and region specified in the GET request. For more information about data
* retrieval policies, see Amazon Glacier Data Retrieval Policies.
*
*
* @param getDataRetrievalPolicyRequest
* Input for GetDataRetrievalPolicy.
* @return A Java Future containing the result of the GetDataRetrievalPolicy
* operation returned by the service.
* @sample AmazonGlacierAsync.GetDataRetrievalPolicy
*/
java.util.concurrent.Future getDataRetrievalPolicyAsync(
GetDataRetrievalPolicyRequest getDataRetrievalPolicyRequest);
/**
*
* This operation returns the current data retrieval policy for the account
* and region specified in the GET request. For more information about data
* retrieval policies, see Amazon Glacier Data Retrieval Policies.
*
*
* @param getDataRetrievalPolicyRequest
* Input for GetDataRetrievalPolicy.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetDataRetrievalPolicy
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.GetDataRetrievalPolicy
*/
java.util.concurrent.Future getDataRetrievalPolicyAsync(
GetDataRetrievalPolicyRequest getDataRetrievalPolicyRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation downloads the output of the job you initiated using
* InitiateJob. Depending on the job type you specified when you
* initiated the job, the output will be either the content of an archive or
* a vault inventory.
*
*
* A job ID will not expire for at least 24 hours after Amazon Glacier
* completes the job. That is, you can download the job output within the 24
* hours period after Amazon Glacier completes the job.
*
*
* If the job output is large, then you can use the Range
* request header to retrieve a portion of the output. This allows you to
* download the entire output in smaller chunks of bytes. For example,
* suppose you have 1 GB of job output you want to download and you decide
* to download 128 MB chunks of data at a time, which is a total of eight
* Get Job Output requests. You use the following process to download the
* job output:
*
*
* -
*
* Download a 128 MB chunk of output by specifying the appropriate byte
* range using the Range header.
*
*
* -
*
* Along with the data, the response includes a SHA256 tree hash of the
* payload. You compute the checksum of the payload on the client and
* compare it with the checksum you received in the response to ensure you
* received all the expected data.
*
*
* -
*
* Repeat steps 1 and 2 for all the eight 128 MB chunks of output data, each
* time specifying the appropriate byte range.
*
*
* -
*
* After downloading all the parts of the job output, you have a list of
* eight checksum values. Compute the tree hash of these values to find the
* checksum of the entire output. Using the DescribeJob API, obtain
* job information of the job that provided you the output. The response
* includes the checksum of the entire archive stored in Amazon Glacier. You
* compare this value with the checksum you computed to ensure you have
* downloaded the entire archive content with no errors.
*
*
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Downloading a Vault Inventory, Downloading an Archive, and Get Job Output
*
*
* @param getJobOutputRequest
* Provides options for downloading output of an Amazon Glacier job.
* @return A Java Future containing the result of the GetJobOutput operation
* returned by the service.
* @sample AmazonGlacierAsync.GetJobOutput
*/
java.util.concurrent.Future getJobOutputAsync(
GetJobOutputRequest getJobOutputRequest);
/**
*
* This operation downloads the output of the job you initiated using
* InitiateJob. Depending on the job type you specified when you
* initiated the job, the output will be either the content of an archive or
* a vault inventory.
*
*
* A job ID will not expire for at least 24 hours after Amazon Glacier
* completes the job. That is, you can download the job output within the 24
* hours period after Amazon Glacier completes the job.
*
*
* If the job output is large, then you can use the Range
* request header to retrieve a portion of the output. This allows you to
* download the entire output in smaller chunks of bytes. For example,
* suppose you have 1 GB of job output you want to download and you decide
* to download 128 MB chunks of data at a time, which is a total of eight
* Get Job Output requests. You use the following process to download the
* job output:
*
*
* -
*
* Download a 128 MB chunk of output by specifying the appropriate byte
* range using the Range header.
*
*
* -
*
* Along with the data, the response includes a SHA256 tree hash of the
* payload. You compute the checksum of the payload on the client and
* compare it with the checksum you received in the response to ensure you
* received all the expected data.
*
*
* -
*
* Repeat steps 1 and 2 for all the eight 128 MB chunks of output data, each
* time specifying the appropriate byte range.
*
*
* -
*
* After downloading all the parts of the job output, you have a list of
* eight checksum values. Compute the tree hash of these values to find the
* checksum of the entire output. Using the DescribeJob API, obtain
* job information of the job that provided you the output. The response
* includes the checksum of the entire archive stored in Amazon Glacier. You
* compare this value with the checksum you computed to ensure you have
* downloaded the entire archive content with no errors.
*
*
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Downloading a Vault Inventory, Downloading an Archive, and Get Job Output
*
*
* @param getJobOutputRequest
* Provides options for downloading output of an Amazon Glacier job.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetJobOutput operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.GetJobOutput
*/
java.util.concurrent.Future getJobOutputAsync(
GetJobOutputRequest getJobOutputRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation retrieves the access-policy subresource set
* on the vault; for more information on setting this subresource, see Set Vault Access Policy (PUT access-policy). If there is no access
* policy set on the vault, the operation returns a
* 404 Not found error. For more information about vault access
* policies, see Amazon Glacier Access Control with Vault Access Policies.
*
*
* @param getVaultAccessPolicyRequest
* Input for GetVaultAccessPolicy.
* @return A Java Future containing the result of the GetVaultAccessPolicy
* operation returned by the service.
* @sample AmazonGlacierAsync.GetVaultAccessPolicy
*/
java.util.concurrent.Future getVaultAccessPolicyAsync(
GetVaultAccessPolicyRequest getVaultAccessPolicyRequest);
/**
*
* This operation retrieves the access-policy subresource set
* on the vault; for more information on setting this subresource, see Set Vault Access Policy (PUT access-policy). If there is no access
* policy set on the vault, the operation returns a
* 404 Not found error. For more information about vault access
* policies, see Amazon Glacier Access Control with Vault Access Policies.
*
*
* @param getVaultAccessPolicyRequest
* Input for GetVaultAccessPolicy.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetVaultAccessPolicy
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.GetVaultAccessPolicy
*/
java.util.concurrent.Future getVaultAccessPolicyAsync(
GetVaultAccessPolicyRequest getVaultAccessPolicyRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation retrieves the following attributes from the
* lock-policy subresource set on the specified vault:
*
* -
*
* The vault lock policy set on the vault.
*
*
* -
*
* The state of the vault lock, which is either InProgess or
* Locked.
*
*
* -
*
* When the lock ID expires. The lock ID is used to complete the vault
* locking process.
*
*
* -
*
* When the vault lock was initiated and put into the
* InProgress state.
*
*
*
*
*
* A vault lock is put into the InProgress state by calling
* InitiateVaultLock. A vault lock is put into the
* Locked state by calling CompleteVaultLock. You can
* abort the vault locking process by calling AbortVaultLock. For
* more information about the vault locking process, Amazon Glacier Vault Lock.
*
*
* If there is no vault lock policy set on the vault, the operation returns
* a 404 Not found error. For more information about vault lock
* policies, Amazon Glacier Access Control with Vault Lock Policies.
*
*
* @param getVaultLockRequest
* The input values for GetVaultLock.
* @return A Java Future containing the result of the GetVaultLock operation
* returned by the service.
* @sample AmazonGlacierAsync.GetVaultLock
*/
java.util.concurrent.Future getVaultLockAsync(
GetVaultLockRequest getVaultLockRequest);
/**
*
* This operation retrieves the following attributes from the
* lock-policy subresource set on the specified vault:
*
* -
*
* The vault lock policy set on the vault.
*
*
* -
*
* The state of the vault lock, which is either InProgess or
* Locked.
*
*
* -
*
* When the lock ID expires. The lock ID is used to complete the vault
* locking process.
*
*
* -
*
* When the vault lock was initiated and put into the
* InProgress state.
*
*
*
*
*
* A vault lock is put into the InProgress state by calling
* InitiateVaultLock. A vault lock is put into the
* Locked state by calling CompleteVaultLock. You can
* abort the vault locking process by calling AbortVaultLock. For
* more information about the vault locking process, Amazon Glacier Vault Lock.
*
*
* If there is no vault lock policy set on the vault, the operation returns
* a 404 Not found error. For more information about vault lock
* policies, Amazon Glacier Access Control with Vault Lock Policies.
*
*
* @param getVaultLockRequest
* The input values for GetVaultLock.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetVaultLock operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.GetVaultLock
*/
java.util.concurrent.Future getVaultLockAsync(
GetVaultLockRequest getVaultLockRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation retrieves the
* notification-configuration subresource of the
* specified vault.
*
*
* For information about setting a notification configuration on a vault,
* see SetVaultNotifications. If a notification configuration for a
* vault is not set, the operation returns a
* 404 Not Found error. For more information about
* vault notifications, see Configuring Vault Notifications in Amazon Glacier.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Configuring Vault Notifications in Amazon Glacier and Get Vault Notification Configuration in the Amazon Glacier
* Developer Guide.
*
*
* @param getVaultNotificationsRequest
* Provides options for retrieving the notification configuration set
* on an Amazon Glacier vault.
* @return A Java Future containing the result of the GetVaultNotifications
* operation returned by the service.
* @sample AmazonGlacierAsync.GetVaultNotifications
*/
java.util.concurrent.Future getVaultNotificationsAsync(
GetVaultNotificationsRequest getVaultNotificationsRequest);
/**
*
* This operation retrieves the
* notification-configuration subresource of the
* specified vault.
*
*
* For information about setting a notification configuration on a vault,
* see SetVaultNotifications. If a notification configuration for a
* vault is not set, the operation returns a
* 404 Not Found error. For more information about
* vault notifications, see Configuring Vault Notifications in Amazon Glacier.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Configuring Vault Notifications in Amazon Glacier and Get Vault Notification Configuration in the Amazon Glacier
* Developer Guide.
*
*
* @param getVaultNotificationsRequest
* Provides options for retrieving the notification configuration set
* on an Amazon Glacier vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the GetVaultNotifications
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.GetVaultNotifications
*/
java.util.concurrent.Future getVaultNotificationsAsync(
GetVaultNotificationsRequest getVaultNotificationsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation initiates a job of the specified type. In this release,
* you can initiate a job to retrieve either an archive or a vault inventory
* (a list of archives in a vault).
*
*
* Retrieving data from Amazon Glacier is a two-step process:
*
*
* -
*
* Initiate a retrieval job.
*
*
*
* A data retrieval policy can cause your initiate retrieval job request to
* fail with a PolicyEnforcedException exception. For more information about
* data retrieval policies, see Amazon Glacier Data Retrieval Policies. For more information about
* the PolicyEnforcedException exception, see Error Responses.
*
*
* -
*
* After the job completes, download the bytes.
*
*
*
*
* The retrieval request is executed asynchronously. When you initiate a
* retrieval job, Amazon Glacier creates a job and returns a job ID in the
* response. When Amazon Glacier completes the job, you can get the job
* output (archive or inventory data). For information about getting job
* output, see GetJobOutput operation.
*
*
* The job must complete before you can get its output. To determine when a
* job is complete, you have the following options:
*
*
* -
*
* Use Amazon SNS Notification You can specify an Amazon Simple
* Notification Service (Amazon SNS) topic to which Amazon Glacier can post
* a notification after the job is completed. You can specify an SNS topic
* per job request. The notification is sent only after Amazon Glacier
* completes the job. In addition to specifying an SNS topic per job
* request, you can configure vault notifications for a vault so that job
* notifications are always sent. For more information, see
* SetVaultNotifications.
*
*
* -
*
* Get job details You can make a DescribeJob request to
* obtain job status information while a job is in progress. However, it is
* more efficient to use an Amazon SNS notification to determine when a job
* is complete.
*
*
*
*
*
* The information you get via notification is same that you get by calling
* DescribeJob.
*
*
*
* If for a specific event, you add both the notification configuration on
* the vault and also specify an SNS topic in your initiate job request,
* Amazon Glacier sends both notifications. For more information, see
* SetVaultNotifications.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* About the Vault Inventory
*
*
* Amazon Glacier prepares an inventory for each vault periodically, every
* 24 hours. When you initiate a job for a vault inventory, Amazon Glacier
* returns the last inventory for the vault. The inventory data you get
* might be up to a day or two days old. Also, the initiate inventory job
* might take some time to complete before you can download the vault
* inventory. So you do not want to retrieve a vault inventory for each
* vault operation. However, in some scenarios, you might find the vault
* inventory useful. For example, when you upload an archive, you can
* provide an archive description but not an archive name. Amazon Glacier
* provides you a unique archive ID, an opaque string of characters. So, you
* might maintain your own database that maps archive names to their
* corresponding Amazon Glacier assigned archive IDs. You might find the
* vault inventory useful in the event you need to reconcile information in
* your database with the actual vault inventory.
*
*
* Range Inventory Retrieval
*
*
* You can limit the number of inventory items retrieved by filtering on the
* archive creation date or by setting a limit.
*
*
* Filtering by Archive Creation Date
*
*
* You can retrieve inventory items for archives created between
* StartDate and EndDate by specifying values for
* these parameters in the InitiateJob request. Archives created on
* or after the StartDate and before the EndDate
* will be returned. If you only provide the StartDate without
* the EndDate, you will retrieve the inventory for all
* archives created on or after the StartDate. If you only
* provide the EndDate without the StartDate, you
* will get back the inventory for all archives created before the
* EndDate.
*
*
* Limiting Inventory Items per Retrieval
*
*
* You can limit the number of inventory items returned by setting the
* Limit parameter in the InitiateJob request. The
* inventory job output will contain inventory items up to the specified
* Limit. If there are more inventory items available, the
* result is paginated. After a job is complete you can use the
* DescribeJob operation to get a marker that you use in a subsequent
* InitiateJob request. The marker will indicate the starting point
* to retrieve the next set of inventory items. You can page through your
* entire inventory by repeatedly making InitiateJob requests with
* the marker from the previous DescribeJob output, until you get a
* marker from DescribeJob that returns null, indicating that there
* are no more inventory items available.
*
*
* You can use the Limit parameter together with the date range
* parameters.
*
*
* About Ranged Archive Retrieval
*
*
* You can initiate an archive retrieval for the whole archive or a range of
* the archive. In the case of ranged archive retrieval, you specify a byte
* range to return or the whole archive. The range specified must be
* megabyte (MB) aligned, that is the range start value must be divisible by
* 1 MB and range end value plus 1 must be divisible by 1 MB or equal the
* end of the archive. If the ranged archive retrieval is not megabyte
* aligned, this operation returns a 400 response. Furthermore, to ensure
* you get checksum values for data you download using Get Job Output API,
* the range must be tree hash aligned.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Initiate a Job and Downloading a Vault Inventory
*
*
* @param initiateJobRequest
* Provides options for initiating an Amazon Glacier job.
* @return A Java Future containing the result of the InitiateJob operation
* returned by the service.
* @sample AmazonGlacierAsync.InitiateJob
*/
java.util.concurrent.Future initiateJobAsync(
InitiateJobRequest initiateJobRequest);
/**
*
* This operation initiates a job of the specified type. In this release,
* you can initiate a job to retrieve either an archive or a vault inventory
* (a list of archives in a vault).
*
*
* Retrieving data from Amazon Glacier is a two-step process:
*
*
* -
*
* Initiate a retrieval job.
*
*
*
* A data retrieval policy can cause your initiate retrieval job request to
* fail with a PolicyEnforcedException exception. For more information about
* data retrieval policies, see Amazon Glacier Data Retrieval Policies. For more information about
* the PolicyEnforcedException exception, see Error Responses.
*
*
* -
*
* After the job completes, download the bytes.
*
*
*
*
* The retrieval request is executed asynchronously. When you initiate a
* retrieval job, Amazon Glacier creates a job and returns a job ID in the
* response. When Amazon Glacier completes the job, you can get the job
* output (archive or inventory data). For information about getting job
* output, see GetJobOutput operation.
*
*
* The job must complete before you can get its output. To determine when a
* job is complete, you have the following options:
*
*
* -
*
* Use Amazon SNS Notification You can specify an Amazon Simple
* Notification Service (Amazon SNS) topic to which Amazon Glacier can post
* a notification after the job is completed. You can specify an SNS topic
* per job request. The notification is sent only after Amazon Glacier
* completes the job. In addition to specifying an SNS topic per job
* request, you can configure vault notifications for a vault so that job
* notifications are always sent. For more information, see
* SetVaultNotifications.
*
*
* -
*
* Get job details You can make a DescribeJob request to
* obtain job status information while a job is in progress. However, it is
* more efficient to use an Amazon SNS notification to determine when a job
* is complete.
*
*
*
*
*
* The information you get via notification is same that you get by calling
* DescribeJob.
*
*
*
* If for a specific event, you add both the notification configuration on
* the vault and also specify an SNS topic in your initiate job request,
* Amazon Glacier sends both notifications. For more information, see
* SetVaultNotifications.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* About the Vault Inventory
*
*
* Amazon Glacier prepares an inventory for each vault periodically, every
* 24 hours. When you initiate a job for a vault inventory, Amazon Glacier
* returns the last inventory for the vault. The inventory data you get
* might be up to a day or two days old. Also, the initiate inventory job
* might take some time to complete before you can download the vault
* inventory. So you do not want to retrieve a vault inventory for each
* vault operation. However, in some scenarios, you might find the vault
* inventory useful. For example, when you upload an archive, you can
* provide an archive description but not an archive name. Amazon Glacier
* provides you a unique archive ID, an opaque string of characters. So, you
* might maintain your own database that maps archive names to their
* corresponding Amazon Glacier assigned archive IDs. You might find the
* vault inventory useful in the event you need to reconcile information in
* your database with the actual vault inventory.
*
*
* Range Inventory Retrieval
*
*
* You can limit the number of inventory items retrieved by filtering on the
* archive creation date or by setting a limit.
*
*
* Filtering by Archive Creation Date
*
*
* You can retrieve inventory items for archives created between
* StartDate and EndDate by specifying values for
* these parameters in the InitiateJob request. Archives created on
* or after the StartDate and before the EndDate
* will be returned. If you only provide the StartDate without
* the EndDate, you will retrieve the inventory for all
* archives created on or after the StartDate. If you only
* provide the EndDate without the StartDate, you
* will get back the inventory for all archives created before the
* EndDate.
*
*
* Limiting Inventory Items per Retrieval
*
*
* You can limit the number of inventory items returned by setting the
* Limit parameter in the InitiateJob request. The
* inventory job output will contain inventory items up to the specified
* Limit. If there are more inventory items available, the
* result is paginated. After a job is complete you can use the
* DescribeJob operation to get a marker that you use in a subsequent
* InitiateJob request. The marker will indicate the starting point
* to retrieve the next set of inventory items. You can page through your
* entire inventory by repeatedly making InitiateJob requests with
* the marker from the previous DescribeJob output, until you get a
* marker from DescribeJob that returns null, indicating that there
* are no more inventory items available.
*
*
* You can use the Limit parameter together with the date range
* parameters.
*
*
* About Ranged Archive Retrieval
*
*
* You can initiate an archive retrieval for the whole archive or a range of
* the archive. In the case of ranged archive retrieval, you specify a byte
* range to return or the whole archive. The range specified must be
* megabyte (MB) aligned, that is the range start value must be divisible by
* 1 MB and range end value plus 1 must be divisible by 1 MB or equal the
* end of the archive. If the ranged archive retrieval is not megabyte
* aligned, this operation returns a 400 response. Furthermore, to ensure
* you get checksum values for data you download using Get Job Output API,
* the range must be tree hash aligned.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Initiate a Job and Downloading a Vault Inventory
*
*
* @param initiateJobRequest
* Provides options for initiating an Amazon Glacier job.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the InitiateJob operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.InitiateJob
*/
java.util.concurrent.Future initiateJobAsync(
InitiateJobRequest initiateJobRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation initiates a multipart upload. Amazon Glacier creates a
* multipart upload resource and returns its ID in the response. The
* multipart upload ID is used in subsequent requests to upload parts of an
* archive (see UploadMultipartPart).
*
*
* When you initiate a multipart upload, you specify the part size in number
* of bytes. The part size must be a megabyte (1024 KB) multiplied by a
* power of 2-for example, 1048576 (1 MB), 2097152 (2 MB), 4194304 (4 MB),
* 8388608 (8 MB), and so on. The minimum allowable part size is 1 MB, and
* the maximum is 4 GB.
*
*
* Every part you upload to this resource (see UploadMultipartPart),
* except the last one, must have the same size. The last one can be the
* same size or smaller. For example, suppose you want to upload a 16.2 MB
* file. If you initiate the multipart upload with a part size of 4 MB, you
* will upload four parts of 4 MB each and one part of 0.2 MB.
*
*
*
* You don't need to know the size of the archive when you start a multipart
* upload because Amazon Glacier does not require you to specify the overall
* archive size.
*
*
*
* After you complete the multipart upload, Amazon Glacier removes the
* multipart upload resource referenced by the ID. Amazon Glacier also
* removes the multipart upload resource if you cancel the multipart upload
* or it may be removed if there is no activity for a period of 24 hours.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Initiate Multipart Upload in the Amazon Glacier Developer
* Guide.
*
*
* @param initiateMultipartUploadRequest
* Provides options for initiating a multipart upload to an Amazon
* Glacier vault.
* @return A Java Future containing the result of the
* InitiateMultipartUpload operation returned by the service.
* @sample AmazonGlacierAsync.InitiateMultipartUpload
*/
java.util.concurrent.Future initiateMultipartUploadAsync(
InitiateMultipartUploadRequest initiateMultipartUploadRequest);
/**
*
* This operation initiates a multipart upload. Amazon Glacier creates a
* multipart upload resource and returns its ID in the response. The
* multipart upload ID is used in subsequent requests to upload parts of an
* archive (see UploadMultipartPart).
*
*
* When you initiate a multipart upload, you specify the part size in number
* of bytes. The part size must be a megabyte (1024 KB) multiplied by a
* power of 2-for example, 1048576 (1 MB), 2097152 (2 MB), 4194304 (4 MB),
* 8388608 (8 MB), and so on. The minimum allowable part size is 1 MB, and
* the maximum is 4 GB.
*
*
* Every part you upload to this resource (see UploadMultipartPart),
* except the last one, must have the same size. The last one can be the
* same size or smaller. For example, suppose you want to upload a 16.2 MB
* file. If you initiate the multipart upload with a part size of 4 MB, you
* will upload four parts of 4 MB each and one part of 0.2 MB.
*
*
*
* You don't need to know the size of the archive when you start a multipart
* upload because Amazon Glacier does not require you to specify the overall
* archive size.
*
*
*
* After you complete the multipart upload, Amazon Glacier removes the
* multipart upload resource referenced by the ID. Amazon Glacier also
* removes the multipart upload resource if you cancel the multipart upload
* or it may be removed if there is no activity for a period of 24 hours.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Initiate Multipart Upload in the Amazon Glacier Developer
* Guide.
*
*
* @param initiateMultipartUploadRequest
* Provides options for initiating a multipart upload to an Amazon
* Glacier vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the
* InitiateMultipartUpload operation returned by the service.
* @sample AmazonGlacierAsyncHandler.InitiateMultipartUpload
*/
java.util.concurrent.Future initiateMultipartUploadAsync(
InitiateMultipartUploadRequest initiateMultipartUploadRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation initiates the vault locking process by doing the
* following:
*
* -
*
* Installing a vault lock policy on the specified vault.
*
*
* -
*
* Setting the lock state of vault lock to InProgress.
*
*
* -
*
* Returning a lock ID, which is used to complete the vault locking process.
*
*
*
*
*
* You can set one vault lock policy for each vault and this policy can be
* up to 20 KB in size. For more information about vault lock policies, see
* Amazon Glacier Access Control with Vault Lock Policies.
*
*
* You must complete the vault locking process within 24 hours after the
* vault lock enters the InProgress state. After the 24 hour
* window ends, the lock ID expires, the vault automatically exits the
* InProgress state, and the vault lock policy is removed from
* the vault. You call CompleteVaultLock to complete the vault
* locking process by setting the state of the vault lock to
* Locked.
*
*
* After a vault lock is in the Locked state, you cannot
* initiate a new vault lock for the vault.
*
*
* You can abort the vault locking process by calling AbortVaultLock.
* You can get the state of the vault lock by calling GetVaultLock.
* For more information about the vault locking process, Amazon Glacier Vault Lock.
*
*
* If this operation is called when the vault lock is in the
* InProgress state, the operation returns an
* AccessDeniedException error. When the vault lock is in the
* InProgress state you must call AbortVaultLock before
* you can initiate a new vault lock policy.
*
*
* @param initiateVaultLockRequest
* The input values for InitiateVaultLock.
* @return A Java Future containing the result of the InitiateVaultLock
* operation returned by the service.
* @sample AmazonGlacierAsync.InitiateVaultLock
*/
java.util.concurrent.Future initiateVaultLockAsync(
InitiateVaultLockRequest initiateVaultLockRequest);
/**
*
* This operation initiates the vault locking process by doing the
* following:
*
* -
*
* Installing a vault lock policy on the specified vault.
*
*
* -
*
* Setting the lock state of vault lock to InProgress.
*
*
* -
*
* Returning a lock ID, which is used to complete the vault locking process.
*
*
*
*
*
* You can set one vault lock policy for each vault and this policy can be
* up to 20 KB in size. For more information about vault lock policies, see
* Amazon Glacier Access Control with Vault Lock Policies.
*
*
* You must complete the vault locking process within 24 hours after the
* vault lock enters the InProgress state. After the 24 hour
* window ends, the lock ID expires, the vault automatically exits the
* InProgress state, and the vault lock policy is removed from
* the vault. You call CompleteVaultLock to complete the vault
* locking process by setting the state of the vault lock to
* Locked.
*
*
* After a vault lock is in the Locked state, you cannot
* initiate a new vault lock for the vault.
*
*
* You can abort the vault locking process by calling AbortVaultLock.
* You can get the state of the vault lock by calling GetVaultLock.
* For more information about the vault locking process, Amazon Glacier Vault Lock.
*
*
* If this operation is called when the vault lock is in the
* InProgress state, the operation returns an
* AccessDeniedException error. When the vault lock is in the
* InProgress state you must call AbortVaultLock before
* you can initiate a new vault lock policy.
*
*
* @param initiateVaultLockRequest
* The input values for InitiateVaultLock.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the InitiateVaultLock
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.InitiateVaultLock
*/
java.util.concurrent.Future initiateVaultLockAsync(
InitiateVaultLockRequest initiateVaultLockRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation lists jobs for a vault, including jobs that are
* in-progress and jobs that have recently finished.
*
*
*
* Amazon Glacier retains recently completed jobs for a period before
* deleting them; however, it eventually removes completed jobs. The output
* of completed jobs can be retrieved. Retaining completed jobs for a period
* of time after they have completed enables you to get a job output in the
* event you miss the job completion notification or your first attempt to
* download it fails. For example, suppose you start an archive retrieval
* job to download an archive. After the job completes, you start to
* download the archive but encounter a network error. In this scenario, you
* can retry and download the archive while the job exists.
*
*
*
* To retrieve an archive or retrieve a vault inventory from Amazon Glacier,
* you first initiate a job, and after the job completes, you download the
* data. For an archive retrieval, the output is the archive data, and for
* an inventory retrieval, it is the inventory list. The List Job operation
* returns a list of these jobs sorted by job initiation time.
*
*
* This List Jobs operation supports pagination. By default, this operation
* returns up to 1,000 jobs in the response. You should always check the
* response for a marker at which to continue the list; if
* there are no more items the marker is null. To
* return a list of jobs that begins at a specific job, set the
* marker request parameter to the value you obtained from a
* previous List Jobs request. You can also limit the number of jobs
* returned in the response by specifying the limit parameter
* in the request.
*
*
* Additionally, you can filter the jobs list returned by specifying an
* optional statuscode (InProgress, Succeeded, or Failed) and
* completed (true, false) parameter. The
* statuscode allows you to specify that only jobs that match a
* specified status are returned. The completed parameter
* allows you to specify that only jobs in a specific completion state are
* returned.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For the underlying REST API, go to List Jobs
*
*
* @param listJobsRequest
* Provides options for retrieving a job list for an Amazon Glacier
* vault.
* @return A Java Future containing the result of the ListJobs operation
* returned by the service.
* @sample AmazonGlacierAsync.ListJobs
*/
java.util.concurrent.Future listJobsAsync(
ListJobsRequest listJobsRequest);
/**
*
* This operation lists jobs for a vault, including jobs that are
* in-progress and jobs that have recently finished.
*
*
*
* Amazon Glacier retains recently completed jobs for a period before
* deleting them; however, it eventually removes completed jobs. The output
* of completed jobs can be retrieved. Retaining completed jobs for a period
* of time after they have completed enables you to get a job output in the
* event you miss the job completion notification or your first attempt to
* download it fails. For example, suppose you start an archive retrieval
* job to download an archive. After the job completes, you start to
* download the archive but encounter a network error. In this scenario, you
* can retry and download the archive while the job exists.
*
*
*
* To retrieve an archive or retrieve a vault inventory from Amazon Glacier,
* you first initiate a job, and after the job completes, you download the
* data. For an archive retrieval, the output is the archive data, and for
* an inventory retrieval, it is the inventory list. The List Job operation
* returns a list of these jobs sorted by job initiation time.
*
*
* This List Jobs operation supports pagination. By default, this operation
* returns up to 1,000 jobs in the response. You should always check the
* response for a marker at which to continue the list; if
* there are no more items the marker is null. To
* return a list of jobs that begins at a specific job, set the
* marker request parameter to the value you obtained from a
* previous List Jobs request. You can also limit the number of jobs
* returned in the response by specifying the limit parameter
* in the request.
*
*
* Additionally, you can filter the jobs list returned by specifying an
* optional statuscode (InProgress, Succeeded, or Failed) and
* completed (true, false) parameter. The
* statuscode allows you to specify that only jobs that match a
* specified status are returned. The completed parameter
* allows you to specify that only jobs in a specific completion state are
* returned.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For the underlying REST API, go to List Jobs
*
*
* @param listJobsRequest
* Provides options for retrieving a job list for an Amazon Glacier
* vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the ListJobs operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.ListJobs
*/
java.util.concurrent.Future listJobsAsync(
ListJobsRequest listJobsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation lists in-progress multipart uploads for the specified
* vault. An in-progress multipart upload is a multipart upload that has
* been initiated by an InitiateMultipartUpload request, but has not
* yet been completed or aborted. The list returned in the List Multipart
* Upload response has no guaranteed order.
*
*
* The List Multipart Uploads operation supports pagination. By default,
* this operation returns up to 1,000 multipart uploads in the response. You
* should always check the response for a marker at which to
* continue the list; if there are no more items the marker is
* null. To return a list of multipart uploads that begins at a
* specific upload, set the marker request parameter to the
* value you obtained from a previous List Multipart Upload request. You can
* also limit the number of uploads returned in the response by specifying
* the limit parameter in the request.
*
*
* Note the difference between this operation and listing parts
* (ListParts). The List Multipart Uploads operation lists all
* multipart uploads for a vault and does not require a multipart upload ID.
* The List Parts operation requires a multipart upload ID since parts are
* associated with a single upload.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Working with Archives in Amazon Glacier and List Multipart Uploads in the Amazon Glacier Developer
* Guide.
*
*
* @param listMultipartUploadsRequest
* Provides options for retrieving list of in-progress multipart
* uploads for an Amazon Glacier vault.
* @return A Java Future containing the result of the ListMultipartUploads
* operation returned by the service.
* @sample AmazonGlacierAsync.ListMultipartUploads
*/
java.util.concurrent.Future listMultipartUploadsAsync(
ListMultipartUploadsRequest listMultipartUploadsRequest);
/**
*
* This operation lists in-progress multipart uploads for the specified
* vault. An in-progress multipart upload is a multipart upload that has
* been initiated by an InitiateMultipartUpload request, but has not
* yet been completed or aborted. The list returned in the List Multipart
* Upload response has no guaranteed order.
*
*
* The List Multipart Uploads operation supports pagination. By default,
* this operation returns up to 1,000 multipart uploads in the response. You
* should always check the response for a marker at which to
* continue the list; if there are no more items the marker is
* null. To return a list of multipart uploads that begins at a
* specific upload, set the marker request parameter to the
* value you obtained from a previous List Multipart Upload request. You can
* also limit the number of uploads returned in the response by specifying
* the limit parameter in the request.
*
*
* Note the difference between this operation and listing parts
* (ListParts). The List Multipart Uploads operation lists all
* multipart uploads for a vault and does not require a multipart upload ID.
* The List Parts operation requires a multipart upload ID since parts are
* associated with a single upload.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Working with Archives in Amazon Glacier and List Multipart Uploads in the Amazon Glacier Developer
* Guide.
*
*
* @param listMultipartUploadsRequest
* Provides options for retrieving list of in-progress multipart
* uploads for an Amazon Glacier vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the ListMultipartUploads
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.ListMultipartUploads
*/
java.util.concurrent.Future listMultipartUploadsAsync(
ListMultipartUploadsRequest listMultipartUploadsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation lists the parts of an archive that have been uploaded in a
* specific multipart upload. You can make this request at any time during
* an in-progress multipart upload before you complete the upload (see
* CompleteMultipartUpload. List Parts returns an error for completed
* uploads. The list returned in the List Parts response is sorted by part
* range.
*
*
* The List Parts operation supports pagination. By default, this operation
* returns up to 1,000 uploaded parts in the response. You should always
* check the response for a marker at which to
* continue the list; if there are no more items the
* marker is null. To
* return a list of parts that begins at a specific part, set the
* marker request parameter to the value you obtained from a
* previous List Parts request. You can also limit the number of parts
* returned in the response by specifying the limit parameter
* in the request.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Working with Archives in Amazon Glacier and List Parts in the Amazon Glacier Developer Guide.
*
*
* @param listPartsRequest
* Provides options for retrieving a list of parts of an archive that
* have been uploaded in a specific multipart upload.
* @return A Java Future containing the result of the ListParts operation
* returned by the service.
* @sample AmazonGlacierAsync.ListParts
*/
java.util.concurrent.Future listPartsAsync(
ListPartsRequest listPartsRequest);
/**
*
* This operation lists the parts of an archive that have been uploaded in a
* specific multipart upload. You can make this request at any time during
* an in-progress multipart upload before you complete the upload (see
* CompleteMultipartUpload. List Parts returns an error for completed
* uploads. The list returned in the List Parts response is sorted by part
* range.
*
*
* The List Parts operation supports pagination. By default, this operation
* returns up to 1,000 uploaded parts in the response. You should always
* check the response for a marker at which to
* continue the list; if there are no more items the
* marker is null. To
* return a list of parts that begins at a specific part, set the
* marker request parameter to the value you obtained from a
* previous List Parts request. You can also limit the number of parts
* returned in the response by specifying the limit parameter
* in the request.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and the underlying REST API, go to Working with Archives in Amazon Glacier and List Parts in the Amazon Glacier Developer Guide.
*
*
* @param listPartsRequest
* Provides options for retrieving a list of parts of an archive that
* have been uploaded in a specific multipart upload.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the ListParts operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.ListParts
*/
java.util.concurrent.Future listPartsAsync(
ListPartsRequest listPartsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation lists all the tags attached to a vault. The operation
* returns an empty map if there are no tags. For more information about
* tags, see Tagging Amazon Glacier Resources.
*
*
* @param listTagsForVaultRequest
* The input value for ListTagsForVaultInput.
* @return A Java Future containing the result of the ListTagsForVault
* operation returned by the service.
* @sample AmazonGlacierAsync.ListTagsForVault
*/
java.util.concurrent.Future listTagsForVaultAsync(
ListTagsForVaultRequest listTagsForVaultRequest);
/**
*
* This operation lists all the tags attached to a vault. The operation
* returns an empty map if there are no tags. For more information about
* tags, see Tagging Amazon Glacier Resources.
*
*
* @param listTagsForVaultRequest
* The input value for ListTagsForVaultInput.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the ListTagsForVault
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.ListTagsForVault
*/
java.util.concurrent.Future listTagsForVaultAsync(
ListTagsForVaultRequest listTagsForVaultRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation lists all vaults owned by the calling user's account. The
* list returned in the response is ASCII-sorted by vault name.
*
*
* By default, this operation returns up to 1,000 items. If there are more
* vaults to list, the response marker field
* contains the vault Amazon Resource Name (ARN) at which to continue the
* list with a new List Vaults request; otherwise, the
* marker field is null.
* To return a list of vaults that begins at a specific vault, set the
* marker request parameter to the vault ARN you
* obtained from a previous List Vaults request. You can also limit the
* number of vaults returned in the response by specifying the
* limit parameter in the request.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Retrieving Vault Metadata in Amazon Glacier and List Vaults in the Amazon Glacier Developer Guide.
*
*
* @param listVaultsRequest
* Provides options to retrieve the vault list owned by the calling
* user's account. The list provides metadata information for each
* vault.
* @return A Java Future containing the result of the ListVaults operation
* returned by the service.
* @sample AmazonGlacierAsync.ListVaults
*/
java.util.concurrent.Future listVaultsAsync(
ListVaultsRequest listVaultsRequest);
/**
*
* This operation lists all vaults owned by the calling user's account. The
* list returned in the response is ASCII-sorted by vault name.
*
*
* By default, this operation returns up to 1,000 items. If there are more
* vaults to list, the response marker field
* contains the vault Amazon Resource Name (ARN) at which to continue the
* list with a new List Vaults request; otherwise, the
* marker field is null.
* To return a list of vaults that begins at a specific vault, set the
* marker request parameter to the vault ARN you
* obtained from a previous List Vaults request. You can also limit the
* number of vaults returned in the response by specifying the
* limit parameter in the request.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Retrieving Vault Metadata in Amazon Glacier and List Vaults in the Amazon Glacier Developer Guide.
*
*
* @param listVaultsRequest
* Provides options to retrieve the vault list owned by the calling
* user's account. The list provides metadata information for each
* vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the ListVaults operation
* returned by the service.
* @sample AmazonGlacierAsyncHandler.ListVaults
*/
java.util.concurrent.Future listVaultsAsync(
ListVaultsRequest listVaultsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation removes one or more tags from the set of tags attached to
* a vault. For more information about tags, see Tagging Amazon Glacier Resources. This operation is idempotent. The
* operation will be successful, even if there are no tags attached to the
* vault.
*
*
* @param removeTagsFromVaultRequest
* The input value for RemoveTagsFromVaultInput.
* @return A Java Future containing the result of the RemoveTagsFromVault
* operation returned by the service.
* @sample AmazonGlacierAsync.RemoveTagsFromVault
*/
java.util.concurrent.Future removeTagsFromVaultAsync(
RemoveTagsFromVaultRequest removeTagsFromVaultRequest);
/**
*
* This operation removes one or more tags from the set of tags attached to
* a vault. For more information about tags, see Tagging Amazon Glacier Resources. This operation is idempotent. The
* operation will be successful, even if there are no tags attached to the
* vault.
*
*
* @param removeTagsFromVaultRequest
* The input value for RemoveTagsFromVaultInput.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the RemoveTagsFromVault
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.RemoveTagsFromVault
*/
java.util.concurrent.Future removeTagsFromVaultAsync(
RemoveTagsFromVaultRequest removeTagsFromVaultRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation sets and then enacts a data retrieval policy in the region
* specified in the PUT request. You can set one policy per region for an
* AWS account. The policy is enacted within a few minutes of a successful
* PUT operation.
*
*
* The set policy operation does not affect retrieval jobs that were in
* progress before the policy was enacted. For more information about data
* retrieval policies, see Amazon Glacier Data Retrieval Policies.
*
*
* @param setDataRetrievalPolicyRequest
* SetDataRetrievalPolicy input.
* @return A Java Future containing the result of the SetDataRetrievalPolicy
* operation returned by the service.
* @sample AmazonGlacierAsync.SetDataRetrievalPolicy
*/
java.util.concurrent.Future setDataRetrievalPolicyAsync(
SetDataRetrievalPolicyRequest setDataRetrievalPolicyRequest);
/**
*
* This operation sets and then enacts a data retrieval policy in the region
* specified in the PUT request. You can set one policy per region for an
* AWS account. The policy is enacted within a few minutes of a successful
* PUT operation.
*
*
* The set policy operation does not affect retrieval jobs that were in
* progress before the policy was enacted. For more information about data
* retrieval policies, see Amazon Glacier Data Retrieval Policies.
*
*
* @param setDataRetrievalPolicyRequest
* SetDataRetrievalPolicy input.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the SetDataRetrievalPolicy
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.SetDataRetrievalPolicy
*/
java.util.concurrent.Future setDataRetrievalPolicyAsync(
SetDataRetrievalPolicyRequest setDataRetrievalPolicyRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation configures an access policy for a vault and will overwrite
* an existing policy. To configure a vault access policy, send a PUT
* request to the access-policy subresource of the vault. An
* access policy is specific to a vault and is also called a vault
* subresource. You can set one access policy per vault and the policy can
* be up to 20 KB in size. For more information about vault access policies,
* see Amazon Glacier Access Control with Vault Access Policies.
*
*
* @param setVaultAccessPolicyRequest
* SetVaultAccessPolicy input.
* @return A Java Future containing the result of the SetVaultAccessPolicy
* operation returned by the service.
* @sample AmazonGlacierAsync.SetVaultAccessPolicy
*/
java.util.concurrent.Future setVaultAccessPolicyAsync(
SetVaultAccessPolicyRequest setVaultAccessPolicyRequest);
/**
*
* This operation configures an access policy for a vault and will overwrite
* an existing policy. To configure a vault access policy, send a PUT
* request to the access-policy subresource of the vault. An
* access policy is specific to a vault and is also called a vault
* subresource. You can set one access policy per vault and the policy can
* be up to 20 KB in size. For more information about vault access policies,
* see Amazon Glacier Access Control with Vault Access Policies.
*
*
* @param setVaultAccessPolicyRequest
* SetVaultAccessPolicy input.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the SetVaultAccessPolicy
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.SetVaultAccessPolicy
*/
java.util.concurrent.Future setVaultAccessPolicyAsync(
SetVaultAccessPolicyRequest setVaultAccessPolicyRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation configures notifications that will be sent when specific
* events happen to a vault. By default, you don't get any notifications.
*
*
* To configure vault notifications, send a PUT request to the
* notification-configuration subresource of the
* vault. The request should include a JSON document that provides an Amazon
* SNS topic and specific events for which you want Amazon Glacier to send
* notifications to the topic.
*
*
* Amazon SNS topics must grant permission to the vault to be allowed to
* publish notifications to the topic. You can configure a vault to publish
* a notification for the following vault events:
*
*
* - ArchiveRetrievalCompleted This event occurs when a job that
* was initiated for an archive retrieval is completed (InitiateJob).
* The status of the completed job can be "Succeeded" or "Failed". The
* notification sent to the SNS topic is the same output as returned from
* DescribeJob.
* - InventoryRetrievalCompleted This event occurs when a job that
* was initiated for an inventory retrieval is completed
* (InitiateJob). The status of the completed job can be "Succeeded"
* or "Failed". The notification sent to the SNS topic is the same output as
* returned from DescribeJob.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Configuring Vault Notifications in Amazon Glacier and Set Vault Notification Configuration in the Amazon Glacier
* Developer Guide.
*
*
* @param setVaultNotificationsRequest
* Provides options to configure notifications that will be sent when
* specific events happen to a vault.
* @return A Java Future containing the result of the SetVaultNotifications
* operation returned by the service.
* @sample AmazonGlacierAsync.SetVaultNotifications
*/
java.util.concurrent.Future setVaultNotificationsAsync(
SetVaultNotificationsRequest setVaultNotificationsRequest);
/**
*
* This operation configures notifications that will be sent when specific
* events happen to a vault. By default, you don't get any notifications.
*
*
* To configure vault notifications, send a PUT request to the
* notification-configuration subresource of the
* vault. The request should include a JSON document that provides an Amazon
* SNS topic and specific events for which you want Amazon Glacier to send
* notifications to the topic.
*
*
* Amazon SNS topics must grant permission to the vault to be allowed to
* publish notifications to the topic. You can configure a vault to publish
* a notification for the following vault events:
*
*
* - ArchiveRetrievalCompleted This event occurs when a job that
* was initiated for an archive retrieval is completed (InitiateJob).
* The status of the completed job can be "Succeeded" or "Failed". The
* notification sent to the SNS topic is the same output as returned from
* DescribeJob.
* - InventoryRetrievalCompleted This event occurs when a job that
* was initiated for an inventory retrieval is completed
* (InitiateJob). The status of the completed job can be "Succeeded"
* or "Failed". The notification sent to the SNS topic is the same output as
* returned from DescribeJob.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Configuring Vault Notifications in Amazon Glacier and Set Vault Notification Configuration in the Amazon Glacier
* Developer Guide.
*
*
* @param setVaultNotificationsRequest
* Provides options to configure notifications that will be sent when
* specific events happen to a vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the SetVaultNotifications
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.SetVaultNotifications
*/
java.util.concurrent.Future setVaultNotificationsAsync(
SetVaultNotificationsRequest setVaultNotificationsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation adds an archive to a vault. This is a synchronous
* operation, and for a successful upload, your data is durably persisted.
* Amazon Glacier returns the archive ID in the
* x-amz-archive-id header of the response.
*
*
* You must use the archive ID to access your data in Amazon Glacier. After
* you upload an archive, you should save the archive ID returned so that
* you can retrieve or delete the archive later. Besides saving the archive
* ID, you can also index it and give it a friendly name to allow for better
* searching. You can also use the optional archive description field to
* specify how the archive is referred to in an external index of archives,
* such as you might create in Amazon DynamoDB. You can also get the vault
* inventory to obtain a list of archive IDs in a vault. For more
* information, see InitiateJob.
*
*
* You must provide a SHA256 tree hash of the data you are uploading. For
* information about computing a SHA256 tree hash, see Computing Checksums.
*
*
* You can optionally specify an archive description of up to 1,024
* printable ASCII characters. You can get the archive description when you
* either retrieve the archive or get the vault inventory. For more
* information, see InitiateJob. Amazon Glacier does not interpret
* the description in any way. An archive description does not need to be
* unique. You cannot use the description to retrieve or sort the archive
* list.
*
*
* Archives are immutable. After you upload an archive, you cannot edit the
* archive or its description.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading an Archive in Amazon Glacier and Upload Archive in the Amazon Glacier Developer Guide.
*
*
* @param uploadArchiveRequest
* Provides options to add an archive to a vault.
* @return A Java Future containing the result of the UploadArchive
* operation returned by the service.
* @sample AmazonGlacierAsync.UploadArchive
*/
java.util.concurrent.Future uploadArchiveAsync(
UploadArchiveRequest uploadArchiveRequest);
/**
*
* This operation adds an archive to a vault. This is a synchronous
* operation, and for a successful upload, your data is durably persisted.
* Amazon Glacier returns the archive ID in the
* x-amz-archive-id header of the response.
*
*
* You must use the archive ID to access your data in Amazon Glacier. After
* you upload an archive, you should save the archive ID returned so that
* you can retrieve or delete the archive later. Besides saving the archive
* ID, you can also index it and give it a friendly name to allow for better
* searching. You can also use the optional archive description field to
* specify how the archive is referred to in an external index of archives,
* such as you might create in Amazon DynamoDB. You can also get the vault
* inventory to obtain a list of archive IDs in a vault. For more
* information, see InitiateJob.
*
*
* You must provide a SHA256 tree hash of the data you are uploading. For
* information about computing a SHA256 tree hash, see Computing Checksums.
*
*
* You can optionally specify an archive description of up to 1,024
* printable ASCII characters. You can get the archive description when you
* either retrieve the archive or get the vault inventory. For more
* information, see InitiateJob. Amazon Glacier does not interpret
* the description in any way. An archive description does not need to be
* unique. You cannot use the description to retrieve or sort the archive
* list.
*
*
* Archives are immutable. After you upload an archive, you cannot edit the
* archive or its description.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading an Archive in Amazon Glacier and Upload Archive in the Amazon Glacier Developer Guide.
*
*
* @param uploadArchiveRequest
* Provides options to add an archive to a vault.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the UploadArchive
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.UploadArchive
*/
java.util.concurrent.Future uploadArchiveAsync(
UploadArchiveRequest uploadArchiveRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* This operation uploads a part of an archive. You can upload archive parts
* in any order. You can also upload them in parallel. You can upload up to
* 10,000 parts for a multipart upload.
*
*
* Amazon Glacier rejects your upload part request if any of the following
* conditions is true:
*
*
* -
*
* SHA256 tree hash does not matchTo ensure that part data is not
* corrupted in transmission, you compute a SHA256 tree hash of the part and
* include it in your request. Upon receiving the part data, Amazon Glacier
* also computes a SHA256 tree hash. If these hash values don't match, the
* operation fails. For information about computing a SHA256 tree hash, see
* Computing Checksums.
*
*
* -
*
* Part size does not matchThe size of each part except the last must
* match the size specified in the corresponding
* InitiateMultipartUpload request. The size of the last part must be
* the same size as, or smaller than, the specified size.
*
*
*
* If you upload a part whose size is smaller than the part size you
* specified in your initiate multipart upload request and that part is not
* the last part, then the upload part request will succeed. However, the
* subsequent Complete Multipart Upload request will fail.
*
*
* - Range does not alignThe byte range value in the request does
* not align with the part size specified in the corresponding initiate
* request. For example, if you specify a part size of 4194304 bytes (4 MB),
* then 0 to 4194303 bytes (4 MB - 1) and 4194304 (4 MB) to 8388607 (8 MB -
* 1) are valid part ranges. However, if you set a range value of 2 MB to 6
* MB, the range does not align with the part size and the upload will fail.
*
*
*
* This operation is idempotent. If you upload the same part multiple times,
* the data included in the most recent request overwrites the previously
* uploaded data.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Upload Part in the Amazon Glacier Developer Guide.
*
*
* @param uploadMultipartPartRequest
* Provides options to upload a part of an archive in a multipart
* upload operation.
* @return A Java Future containing the result of the UploadMultipartPart
* operation returned by the service.
* @sample AmazonGlacierAsync.UploadMultipartPart
*/
java.util.concurrent.Future uploadMultipartPartAsync(
UploadMultipartPartRequest uploadMultipartPartRequest);
/**
*
* This operation uploads a part of an archive. You can upload archive parts
* in any order. You can also upload them in parallel. You can upload up to
* 10,000 parts for a multipart upload.
*
*
* Amazon Glacier rejects your upload part request if any of the following
* conditions is true:
*
*
* -
*
* SHA256 tree hash does not matchTo ensure that part data is not
* corrupted in transmission, you compute a SHA256 tree hash of the part and
* include it in your request. Upon receiving the part data, Amazon Glacier
* also computes a SHA256 tree hash. If these hash values don't match, the
* operation fails. For information about computing a SHA256 tree hash, see
* Computing Checksums.
*
*
* -
*
* Part size does not matchThe size of each part except the last must
* match the size specified in the corresponding
* InitiateMultipartUpload request. The size of the last part must be
* the same size as, or smaller than, the specified size.
*
*
*
* If you upload a part whose size is smaller than the part size you
* specified in your initiate multipart upload request and that part is not
* the last part, then the upload part request will succeed. However, the
* subsequent Complete Multipart Upload request will fail.
*
*
* - Range does not alignThe byte range value in the request does
* not align with the part size specified in the corresponding initiate
* request. For example, if you specify a part size of 4194304 bytes (4 MB),
* then 0 to 4194303 bytes (4 MB - 1) and 4194304 (4 MB) to 8388607 (8 MB -
* 1) are valid part ranges. However, if you set a range value of 2 MB to 6
* MB, the range does not align with the part size and the upload will fail.
*
*
*
* This operation is idempotent. If you upload the same part multiple times,
* the data included in the most recent request overwrites the previously
* uploaded data.
*
*
* An AWS account has full permission to perform all operations (actions).
* However, AWS Identity and Access Management (IAM) users don't have any
* permissions by default. You must grant them explicit permission to
* perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM).
*
*
* For conceptual information and underlying REST API, go to Uploading Large Archives in Parts (Multipart Upload) and Upload Part in the Amazon Glacier Developer Guide.
*
*
* @param uploadMultipartPartRequest
* Provides options to upload a part of an archive in a multipart
* upload operation.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the
* request. Users can provide an implementation of the callback
* methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the UploadMultipartPart
* operation returned by the service.
* @sample AmazonGlacierAsyncHandler.UploadMultipartPart
*/
java.util.concurrent.Future uploadMultipartPartAsync(
UploadMultipartPartRequest uploadMultipartPartRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}