2900 lines
219 KiB
C++
2900 lines
219 KiB
C++
/**
|
|
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
|
* SPDX-License-Identifier: Apache-2.0.
|
|
*/
|
|
|
|
#pragma once
|
|
#include <aws/glacier/Glacier_EXPORTS.h>
|
|
#include <aws/glacier/GlacierErrors.h>
|
|
#include <aws/core/client/AWSError.h>
|
|
#include <aws/core/client/ClientConfiguration.h>
|
|
#include <aws/core/client/AWSClient.h>
|
|
#include <aws/core/utils/memory/stl/AWSString.h>
|
|
#include <aws/core/utils/json/JsonSerializer.h>
|
|
#include <aws/glacier/model/CompleteMultipartUploadResult.h>
|
|
#include <aws/glacier/model/CreateVaultResult.h>
|
|
#include <aws/glacier/model/DescribeJobResult.h>
|
|
#include <aws/glacier/model/DescribeVaultResult.h>
|
|
#include <aws/glacier/model/GetDataRetrievalPolicyResult.h>
|
|
#include <aws/glacier/model/GetJobOutputResult.h>
|
|
#include <aws/glacier/model/GetVaultAccessPolicyResult.h>
|
|
#include <aws/glacier/model/GetVaultLockResult.h>
|
|
#include <aws/glacier/model/GetVaultNotificationsResult.h>
|
|
#include <aws/glacier/model/InitiateJobResult.h>
|
|
#include <aws/glacier/model/InitiateMultipartUploadResult.h>
|
|
#include <aws/glacier/model/InitiateVaultLockResult.h>
|
|
#include <aws/glacier/model/ListJobsResult.h>
|
|
#include <aws/glacier/model/ListMultipartUploadsResult.h>
|
|
#include <aws/glacier/model/ListPartsResult.h>
|
|
#include <aws/glacier/model/ListProvisionedCapacityResult.h>
|
|
#include <aws/glacier/model/ListTagsForVaultResult.h>
|
|
#include <aws/glacier/model/ListVaultsResult.h>
|
|
#include <aws/glacier/model/PurchaseProvisionedCapacityResult.h>
|
|
#include <aws/glacier/model/UploadArchiveResult.h>
|
|
#include <aws/glacier/model/UploadMultipartPartResult.h>
|
|
#include <aws/core/NoResult.h>
|
|
#include <aws/core/client/AsyncCallerContext.h>
|
|
#include <aws/core/http/HttpTypes.h>
|
|
#include <future>
|
|
#include <functional>
|
|
|
|
namespace Aws
|
|
{
|
|
|
|
namespace Http
|
|
{
|
|
class HttpClient;
|
|
class HttpClientFactory;
|
|
} // namespace Http
|
|
|
|
namespace Utils
|
|
{
|
|
template< typename R, typename E> class Outcome;
|
|
namespace Threading
|
|
{
|
|
class Executor;
|
|
} // namespace Threading
|
|
} // namespace Utils
|
|
|
|
namespace Auth
|
|
{
|
|
class AWSCredentials;
|
|
class AWSCredentialsProvider;
|
|
} // namespace Auth
|
|
|
|
namespace Client
|
|
{
|
|
class RetryStrategy;
|
|
} // namespace Client
|
|
|
|
namespace Glacier
|
|
{
|
|
|
|
namespace Model
|
|
{
|
|
class AbortMultipartUploadRequest;
|
|
class AbortVaultLockRequest;
|
|
class AddTagsToVaultRequest;
|
|
class CompleteMultipartUploadRequest;
|
|
class CompleteVaultLockRequest;
|
|
class CreateVaultRequest;
|
|
class DeleteArchiveRequest;
|
|
class DeleteVaultRequest;
|
|
class DeleteVaultAccessPolicyRequest;
|
|
class DeleteVaultNotificationsRequest;
|
|
class DescribeJobRequest;
|
|
class DescribeVaultRequest;
|
|
class GetDataRetrievalPolicyRequest;
|
|
class GetJobOutputRequest;
|
|
class GetVaultAccessPolicyRequest;
|
|
class GetVaultLockRequest;
|
|
class GetVaultNotificationsRequest;
|
|
class InitiateJobRequest;
|
|
class InitiateMultipartUploadRequest;
|
|
class InitiateVaultLockRequest;
|
|
class ListJobsRequest;
|
|
class ListMultipartUploadsRequest;
|
|
class ListPartsRequest;
|
|
class ListProvisionedCapacityRequest;
|
|
class ListTagsForVaultRequest;
|
|
class ListVaultsRequest;
|
|
class PurchaseProvisionedCapacityRequest;
|
|
class RemoveTagsFromVaultRequest;
|
|
class SetDataRetrievalPolicyRequest;
|
|
class SetVaultAccessPolicyRequest;
|
|
class SetVaultNotificationsRequest;
|
|
class UploadArchiveRequest;
|
|
class UploadMultipartPartRequest;
|
|
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> AbortMultipartUploadOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> AbortVaultLockOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> AddTagsToVaultOutcome;
|
|
typedef Aws::Utils::Outcome<CompleteMultipartUploadResult, GlacierError> CompleteMultipartUploadOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> CompleteVaultLockOutcome;
|
|
typedef Aws::Utils::Outcome<CreateVaultResult, GlacierError> CreateVaultOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> DeleteArchiveOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> DeleteVaultOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> DeleteVaultAccessPolicyOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> DeleteVaultNotificationsOutcome;
|
|
typedef Aws::Utils::Outcome<DescribeJobResult, GlacierError> DescribeJobOutcome;
|
|
typedef Aws::Utils::Outcome<DescribeVaultResult, GlacierError> DescribeVaultOutcome;
|
|
typedef Aws::Utils::Outcome<GetDataRetrievalPolicyResult, GlacierError> GetDataRetrievalPolicyOutcome;
|
|
typedef Aws::Utils::Outcome<GetJobOutputResult, GlacierError> GetJobOutputOutcome;
|
|
typedef Aws::Utils::Outcome<GetVaultAccessPolicyResult, GlacierError> GetVaultAccessPolicyOutcome;
|
|
typedef Aws::Utils::Outcome<GetVaultLockResult, GlacierError> GetVaultLockOutcome;
|
|
typedef Aws::Utils::Outcome<GetVaultNotificationsResult, GlacierError> GetVaultNotificationsOutcome;
|
|
typedef Aws::Utils::Outcome<InitiateJobResult, GlacierError> InitiateJobOutcome;
|
|
typedef Aws::Utils::Outcome<InitiateMultipartUploadResult, GlacierError> InitiateMultipartUploadOutcome;
|
|
typedef Aws::Utils::Outcome<InitiateVaultLockResult, GlacierError> InitiateVaultLockOutcome;
|
|
typedef Aws::Utils::Outcome<ListJobsResult, GlacierError> ListJobsOutcome;
|
|
typedef Aws::Utils::Outcome<ListMultipartUploadsResult, GlacierError> ListMultipartUploadsOutcome;
|
|
typedef Aws::Utils::Outcome<ListPartsResult, GlacierError> ListPartsOutcome;
|
|
typedef Aws::Utils::Outcome<ListProvisionedCapacityResult, GlacierError> ListProvisionedCapacityOutcome;
|
|
typedef Aws::Utils::Outcome<ListTagsForVaultResult, GlacierError> ListTagsForVaultOutcome;
|
|
typedef Aws::Utils::Outcome<ListVaultsResult, GlacierError> ListVaultsOutcome;
|
|
typedef Aws::Utils::Outcome<PurchaseProvisionedCapacityResult, GlacierError> PurchaseProvisionedCapacityOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> RemoveTagsFromVaultOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> SetDataRetrievalPolicyOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> SetVaultAccessPolicyOutcome;
|
|
typedef Aws::Utils::Outcome<Aws::NoResult, GlacierError> SetVaultNotificationsOutcome;
|
|
typedef Aws::Utils::Outcome<UploadArchiveResult, GlacierError> UploadArchiveOutcome;
|
|
typedef Aws::Utils::Outcome<UploadMultipartPartResult, GlacierError> UploadMultipartPartOutcome;
|
|
|
|
typedef std::future<AbortMultipartUploadOutcome> AbortMultipartUploadOutcomeCallable;
|
|
typedef std::future<AbortVaultLockOutcome> AbortVaultLockOutcomeCallable;
|
|
typedef std::future<AddTagsToVaultOutcome> AddTagsToVaultOutcomeCallable;
|
|
typedef std::future<CompleteMultipartUploadOutcome> CompleteMultipartUploadOutcomeCallable;
|
|
typedef std::future<CompleteVaultLockOutcome> CompleteVaultLockOutcomeCallable;
|
|
typedef std::future<CreateVaultOutcome> CreateVaultOutcomeCallable;
|
|
typedef std::future<DeleteArchiveOutcome> DeleteArchiveOutcomeCallable;
|
|
typedef std::future<DeleteVaultOutcome> DeleteVaultOutcomeCallable;
|
|
typedef std::future<DeleteVaultAccessPolicyOutcome> DeleteVaultAccessPolicyOutcomeCallable;
|
|
typedef std::future<DeleteVaultNotificationsOutcome> DeleteVaultNotificationsOutcomeCallable;
|
|
typedef std::future<DescribeJobOutcome> DescribeJobOutcomeCallable;
|
|
typedef std::future<DescribeVaultOutcome> DescribeVaultOutcomeCallable;
|
|
typedef std::future<GetDataRetrievalPolicyOutcome> GetDataRetrievalPolicyOutcomeCallable;
|
|
typedef std::future<GetJobOutputOutcome> GetJobOutputOutcomeCallable;
|
|
typedef std::future<GetVaultAccessPolicyOutcome> GetVaultAccessPolicyOutcomeCallable;
|
|
typedef std::future<GetVaultLockOutcome> GetVaultLockOutcomeCallable;
|
|
typedef std::future<GetVaultNotificationsOutcome> GetVaultNotificationsOutcomeCallable;
|
|
typedef std::future<InitiateJobOutcome> InitiateJobOutcomeCallable;
|
|
typedef std::future<InitiateMultipartUploadOutcome> InitiateMultipartUploadOutcomeCallable;
|
|
typedef std::future<InitiateVaultLockOutcome> InitiateVaultLockOutcomeCallable;
|
|
typedef std::future<ListJobsOutcome> ListJobsOutcomeCallable;
|
|
typedef std::future<ListMultipartUploadsOutcome> ListMultipartUploadsOutcomeCallable;
|
|
typedef std::future<ListPartsOutcome> ListPartsOutcomeCallable;
|
|
typedef std::future<ListProvisionedCapacityOutcome> ListProvisionedCapacityOutcomeCallable;
|
|
typedef std::future<ListTagsForVaultOutcome> ListTagsForVaultOutcomeCallable;
|
|
typedef std::future<ListVaultsOutcome> ListVaultsOutcomeCallable;
|
|
typedef std::future<PurchaseProvisionedCapacityOutcome> PurchaseProvisionedCapacityOutcomeCallable;
|
|
typedef std::future<RemoveTagsFromVaultOutcome> RemoveTagsFromVaultOutcomeCallable;
|
|
typedef std::future<SetDataRetrievalPolicyOutcome> SetDataRetrievalPolicyOutcomeCallable;
|
|
typedef std::future<SetVaultAccessPolicyOutcome> SetVaultAccessPolicyOutcomeCallable;
|
|
typedef std::future<SetVaultNotificationsOutcome> SetVaultNotificationsOutcomeCallable;
|
|
typedef std::future<UploadArchiveOutcome> UploadArchiveOutcomeCallable;
|
|
typedef std::future<UploadMultipartPartOutcome> UploadMultipartPartOutcomeCallable;
|
|
} // namespace Model
|
|
|
|
class GlacierClient;
|
|
|
|
typedef std::function<void(const GlacierClient*, const Model::AbortMultipartUploadRequest&, const Model::AbortMultipartUploadOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > AbortMultipartUploadResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::AbortVaultLockRequest&, const Model::AbortVaultLockOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > AbortVaultLockResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::AddTagsToVaultRequest&, const Model::AddTagsToVaultOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > AddTagsToVaultResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::CompleteMultipartUploadRequest&, const Model::CompleteMultipartUploadOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > CompleteMultipartUploadResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::CompleteVaultLockRequest&, const Model::CompleteVaultLockOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > CompleteVaultLockResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::CreateVaultRequest&, const Model::CreateVaultOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > CreateVaultResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::DeleteArchiveRequest&, const Model::DeleteArchiveOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > DeleteArchiveResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::DeleteVaultRequest&, const Model::DeleteVaultOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > DeleteVaultResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::DeleteVaultAccessPolicyRequest&, const Model::DeleteVaultAccessPolicyOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > DeleteVaultAccessPolicyResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::DeleteVaultNotificationsRequest&, const Model::DeleteVaultNotificationsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > DeleteVaultNotificationsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::DescribeJobRequest&, const Model::DescribeJobOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > DescribeJobResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::DescribeVaultRequest&, const Model::DescribeVaultOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > DescribeVaultResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::GetDataRetrievalPolicyRequest&, const Model::GetDataRetrievalPolicyOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > GetDataRetrievalPolicyResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::GetJobOutputRequest&, Model::GetJobOutputOutcome, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > GetJobOutputResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::GetVaultAccessPolicyRequest&, const Model::GetVaultAccessPolicyOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > GetVaultAccessPolicyResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::GetVaultLockRequest&, const Model::GetVaultLockOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > GetVaultLockResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::GetVaultNotificationsRequest&, const Model::GetVaultNotificationsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > GetVaultNotificationsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::InitiateJobRequest&, const Model::InitiateJobOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > InitiateJobResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::InitiateMultipartUploadRequest&, const Model::InitiateMultipartUploadOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > InitiateMultipartUploadResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::InitiateVaultLockRequest&, const Model::InitiateVaultLockOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > InitiateVaultLockResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::ListJobsRequest&, const Model::ListJobsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > ListJobsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::ListMultipartUploadsRequest&, const Model::ListMultipartUploadsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > ListMultipartUploadsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::ListPartsRequest&, const Model::ListPartsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > ListPartsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::ListProvisionedCapacityRequest&, const Model::ListProvisionedCapacityOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > ListProvisionedCapacityResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::ListTagsForVaultRequest&, const Model::ListTagsForVaultOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > ListTagsForVaultResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::ListVaultsRequest&, const Model::ListVaultsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > ListVaultsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::PurchaseProvisionedCapacityRequest&, const Model::PurchaseProvisionedCapacityOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > PurchaseProvisionedCapacityResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::RemoveTagsFromVaultRequest&, const Model::RemoveTagsFromVaultOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > RemoveTagsFromVaultResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::SetDataRetrievalPolicyRequest&, const Model::SetDataRetrievalPolicyOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > SetDataRetrievalPolicyResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::SetVaultAccessPolicyRequest&, const Model::SetVaultAccessPolicyOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > SetVaultAccessPolicyResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::SetVaultNotificationsRequest&, const Model::SetVaultNotificationsOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > SetVaultNotificationsResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::UploadArchiveRequest&, const Model::UploadArchiveOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > UploadArchiveResponseReceivedHandler;
|
|
typedef std::function<void(const GlacierClient*, const Model::UploadMultipartPartRequest&, const Model::UploadMultipartPartOutcome&, const std::shared_ptr<const Aws::Client::AsyncCallerContext>&) > UploadMultipartPartResponseReceivedHandler;
|
|
|
|
/**
|
|
* <p> Amazon S3 Glacier (Glacier) is a storage solution for "cold data."</p>
|
|
* <p>Glacier is an extremely low-cost storage service that provides secure,
|
|
* durable, and easy-to-use storage for data backup and archival. With Glacier,
|
|
* customers can store their data cost effectively for months, years, or decades.
|
|
* 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.</p> <p>Glacier is a great
|
|
* storage choice when low storage cost is paramount and your data is rarely
|
|
* retrieved. If your application requires fast or frequent access to your data,
|
|
* consider using Amazon S3. For more information, see <a
|
|
* href="http://aws.amazon.com/s3/">Amazon Simple Storage Service (Amazon
|
|
* S3)</a>.</p> <p>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 Glacier.</p> <p>If
|
|
* you are a first-time user of Glacier, we recommend that you begin by reading the
|
|
* following sections in the <i>Amazon S3 Glacier Developer Guide</i>:</p> <ul>
|
|
* <li> <p> <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/introduction.html">What
|
|
* is Amazon S3 Glacier</a> - 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.</p> </li> <li> <p> <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/amazon-glacier-getting-started.html">Getting
|
|
* Started with Amazon S3 Glacier</a> - 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.</p> </li>
|
|
* </ul>
|
|
*/
|
|
class AWS_GLACIER_API GlacierClient : public Aws::Client::AWSJsonClient
|
|
{
|
|
public:
|
|
typedef Aws::Client::AWSJsonClient BASECLASS;
|
|
|
|
/**
|
|
* Initializes client to use DefaultCredentialProviderChain, with default http client factory, and optional client config. If client config
|
|
* is not specified, it will be initialized to default values.
|
|
*/
|
|
GlacierClient(const Aws::Client::ClientConfiguration& clientConfiguration = Aws::Client::ClientConfiguration());
|
|
|
|
/**
|
|
* Initializes client to use SimpleAWSCredentialsProvider, with default http client factory, and optional client config. If client config
|
|
* is not specified, it will be initialized to default values.
|
|
*/
|
|
GlacierClient(const Aws::Auth::AWSCredentials& credentials, const Aws::Client::ClientConfiguration& clientConfiguration = Aws::Client::ClientConfiguration());
|
|
|
|
/**
|
|
* Initializes client to use specified credentials provider with specified client config. If http client factory is not supplied,
|
|
* the default http client factory will be used
|
|
*/
|
|
GlacierClient(const std::shared_ptr<Aws::Auth::AWSCredentialsProvider>& credentialsProvider,
|
|
const Aws::Client::ClientConfiguration& clientConfiguration = Aws::Client::ClientConfiguration());
|
|
|
|
virtual ~GlacierClient();
|
|
|
|
|
|
/**
|
|
* <p>This operation aborts a multipart upload identified by the upload ID.</p>
|
|
* <p>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 <a>UploadMultipartPart</a> and
|
|
* <a>CompleteMultipartUpload</a>.</p> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-abort-upload.html">Abort
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AbortMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::AbortMultipartUploadOutcome AbortMultipartUpload(const Model::AbortMultipartUploadRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation aborts a multipart upload identified by the upload ID.</p>
|
|
* <p>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 <a>UploadMultipartPart</a> and
|
|
* <a>CompleteMultipartUpload</a>.</p> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-abort-upload.html">Abort
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AbortMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::AbortMultipartUploadOutcomeCallable AbortMultipartUploadCallable(const Model::AbortMultipartUploadRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation aborts a multipart upload identified by the upload ID.</p>
|
|
* <p>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 <a>UploadMultipartPart</a> and
|
|
* <a>CompleteMultipartUpload</a>.</p> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-abort-upload.html">Abort
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AbortMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void AbortMultipartUploadAsync(const Model::AbortMultipartUploadRequest& request, const AbortMultipartUploadResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation aborts the vault locking process if the vault lock is not in
|
|
* the <code>Locked</code> state. If the vault lock is in the <code>Locked</code>
|
|
* state when this operation is requested, the operation returns an
|
|
* <code>AccessDeniedException</code> error. Aborting the vault locking process
|
|
* removes the vault lock policy from the specified vault. </p> <p>A vault lock is
|
|
* put into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>.
|
|
* A vault lock is put into the <code>Locked</code> state by calling
|
|
* <a>CompleteVaultLock</a>. You can get the state of a vault lock by calling
|
|
* <a>GetVaultLock</a>. For more information about the vault locking process, see
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. For more information about vault lock policies, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p> <p>This operation is
|
|
* idempotent. You can successfully invoke this operation multiple times, if the
|
|
* vault lock is in the <code>InProgress</code> state or if there is no policy
|
|
* associated with the vault.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AbortVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::AbortVaultLockOutcome AbortVaultLock(const Model::AbortVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation aborts the vault locking process if the vault lock is not in
|
|
* the <code>Locked</code> state. If the vault lock is in the <code>Locked</code>
|
|
* state when this operation is requested, the operation returns an
|
|
* <code>AccessDeniedException</code> error. Aborting the vault locking process
|
|
* removes the vault lock policy from the specified vault. </p> <p>A vault lock is
|
|
* put into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>.
|
|
* A vault lock is put into the <code>Locked</code> state by calling
|
|
* <a>CompleteVaultLock</a>. You can get the state of a vault lock by calling
|
|
* <a>GetVaultLock</a>. For more information about the vault locking process, see
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. For more information about vault lock policies, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p> <p>This operation is
|
|
* idempotent. You can successfully invoke this operation multiple times, if the
|
|
* vault lock is in the <code>InProgress</code> state or if there is no policy
|
|
* associated with the vault.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AbortVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::AbortVaultLockOutcomeCallable AbortVaultLockCallable(const Model::AbortVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation aborts the vault locking process if the vault lock is not in
|
|
* the <code>Locked</code> state. If the vault lock is in the <code>Locked</code>
|
|
* state when this operation is requested, the operation returns an
|
|
* <code>AccessDeniedException</code> error. Aborting the vault locking process
|
|
* removes the vault lock policy from the specified vault. </p> <p>A vault lock is
|
|
* put into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>.
|
|
* A vault lock is put into the <code>Locked</code> state by calling
|
|
* <a>CompleteVaultLock</a>. You can get the state of a vault lock by calling
|
|
* <a>GetVaultLock</a>. For more information about the vault locking process, see
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. For more information about vault lock policies, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p> <p>This operation is
|
|
* idempotent. You can successfully invoke this operation multiple times, if the
|
|
* vault lock is in the <code>InProgress</code> state or if there is no policy
|
|
* associated with the vault.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AbortVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void AbortVaultLockAsync(const Model::AbortVaultLockRequest& request, const AbortVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <code>LimitExceededException</code> 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AddTagsToVault">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::AddTagsToVaultOutcome AddTagsToVault(const Model::AddTagsToVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <code>LimitExceededException</code> 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AddTagsToVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::AddTagsToVaultOutcomeCallable AddTagsToVaultCallable(const Model::AddTagsToVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <code>LimitExceededException</code> 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/AddTagsToVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void AddTagsToVaultAsync(const Model::AddTagsToVaultRequest& request, const AddTagsToVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>You call this operation to inform Amazon S3 Glacier (Glacier) that all the
|
|
* archive parts have been uploaded and that Glacier can now assemble the archive
|
|
* from the uploaded parts. After assembling and saving the archive to the vault,
|
|
* 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 <a>InitiateJob</a>.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>. On the server side, Glacier also constructs the SHA256 tree hash
|
|
* of the assembled archive. If the values match, Glacier saves the archive to the
|
|
* vault; otherwise, it returns an error, and the operation fails. The
|
|
* <a>ListParts</a> 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.</p> <p>Additionally, Glacier also
|
|
* checks for any missing content ranges when assembling the archive, if missing
|
|
* content ranges are found, Glacier returns an error and the operation fails.</p>
|
|
* <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-complete-upload.html">Complete
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CompleteMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::CompleteMultipartUploadOutcome CompleteMultipartUpload(const Model::CompleteMultipartUploadRequest& request) const;
|
|
|
|
/**
|
|
* <p>You call this operation to inform Amazon S3 Glacier (Glacier) that all the
|
|
* archive parts have been uploaded and that Glacier can now assemble the archive
|
|
* from the uploaded parts. After assembling and saving the archive to the vault,
|
|
* 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 <a>InitiateJob</a>.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>. On the server side, Glacier also constructs the SHA256 tree hash
|
|
* of the assembled archive. If the values match, Glacier saves the archive to the
|
|
* vault; otherwise, it returns an error, and the operation fails. The
|
|
* <a>ListParts</a> 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.</p> <p>Additionally, Glacier also
|
|
* checks for any missing content ranges when assembling the archive, if missing
|
|
* content ranges are found, Glacier returns an error and the operation fails.</p>
|
|
* <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-complete-upload.html">Complete
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CompleteMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::CompleteMultipartUploadOutcomeCallable CompleteMultipartUploadCallable(const Model::CompleteMultipartUploadRequest& request) const;
|
|
|
|
/**
|
|
* <p>You call this operation to inform Amazon S3 Glacier (Glacier) that all the
|
|
* archive parts have been uploaded and that Glacier can now assemble the archive
|
|
* from the uploaded parts. After assembling and saving the archive to the vault,
|
|
* 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 <a>InitiateJob</a>.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>. On the server side, Glacier also constructs the SHA256 tree hash
|
|
* of the assembled archive. If the values match, Glacier saves the archive to the
|
|
* vault; otherwise, it returns an error, and the operation fails. The
|
|
* <a>ListParts</a> 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.</p> <p>Additionally, Glacier also
|
|
* checks for any missing content ranges when assembling the archive, if missing
|
|
* content ranges are found, Glacier returns an error and the operation fails.</p>
|
|
* <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-complete-upload.html">Complete
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CompleteMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void CompleteMultipartUploadAsync(const Model::CompleteMultipartUploadRequest& request, const CompleteMultipartUploadResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation completes the vault locking process by transitioning the vault
|
|
* lock from the <code>InProgress</code> state to the <code>Locked</code> state,
|
|
* which causes the vault lock policy to become unchangeable. A vault lock is put
|
|
* into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>. You
|
|
* can obtain the state of the vault lock by calling <a>GetVaultLock</a>. For more
|
|
* information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. </p> <p>This operation is idempotent. This request is
|
|
* always successful if the vault lock is in the <code>Locked</code> state and the
|
|
* provided lock ID matches the lock ID originally used to lock the vault.</p>
|
|
* <p>If an invalid lock ID is passed in the request when the vault lock is in the
|
|
* <code>Locked</code> state, the operation returns an
|
|
* <code>AccessDeniedException</code> error. If an invalid lock ID is passed in the
|
|
* request when the vault lock is in the <code>InProgress</code> state, the
|
|
* operation throws an <code>InvalidParameter</code> error.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CompleteVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::CompleteVaultLockOutcome CompleteVaultLock(const Model::CompleteVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation completes the vault locking process by transitioning the vault
|
|
* lock from the <code>InProgress</code> state to the <code>Locked</code> state,
|
|
* which causes the vault lock policy to become unchangeable. A vault lock is put
|
|
* into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>. You
|
|
* can obtain the state of the vault lock by calling <a>GetVaultLock</a>. For more
|
|
* information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. </p> <p>This operation is idempotent. This request is
|
|
* always successful if the vault lock is in the <code>Locked</code> state and the
|
|
* provided lock ID matches the lock ID originally used to lock the vault.</p>
|
|
* <p>If an invalid lock ID is passed in the request when the vault lock is in the
|
|
* <code>Locked</code> state, the operation returns an
|
|
* <code>AccessDeniedException</code> error. If an invalid lock ID is passed in the
|
|
* request when the vault lock is in the <code>InProgress</code> state, the
|
|
* operation throws an <code>InvalidParameter</code> error.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CompleteVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::CompleteVaultLockOutcomeCallable CompleteVaultLockCallable(const Model::CompleteVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation completes the vault locking process by transitioning the vault
|
|
* lock from the <code>InProgress</code> state to the <code>Locked</code> state,
|
|
* which causes the vault lock policy to become unchangeable. A vault lock is put
|
|
* into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>. You
|
|
* can obtain the state of the vault lock by calling <a>GetVaultLock</a>. For more
|
|
* information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. </p> <p>This operation is idempotent. This request is
|
|
* always successful if the vault lock is in the <code>Locked</code> state and the
|
|
* provided lock ID matches the lock ID originally used to lock the vault.</p>
|
|
* <p>If an invalid lock ID is passed in the request when the vault lock is in the
|
|
* <code>Locked</code> state, the operation returns an
|
|
* <code>AccessDeniedException</code> error. If an invalid lock ID is passed in the
|
|
* request when the vault lock is in the <code>InProgress</code> state, the
|
|
* operation throws an <code>InvalidParameter</code> error.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CompleteVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void CompleteVaultLockAsync(const Model::CompleteVaultLockRequest& request, const CompleteVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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 S3
|
|
* Glacier.</p> <p>You must use the following guidelines when naming a vault.</p>
|
|
* <ul> <li> <p>Names can be between 1 and 255 characters long.</p> </li> <li>
|
|
* <p>Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and '.'
|
|
* (period).</p> </li> </ul> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/creating-vaults.html">Creating
|
|
* a Vault in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-put.html">Create
|
|
* Vault </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CreateVault">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::CreateVaultOutcome CreateVault(const Model::CreateVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 S3
|
|
* Glacier.</p> <p>You must use the following guidelines when naming a vault.</p>
|
|
* <ul> <li> <p>Names can be between 1 and 255 characters long.</p> </li> <li>
|
|
* <p>Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and '.'
|
|
* (period).</p> </li> </ul> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/creating-vaults.html">Creating
|
|
* a Vault in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-put.html">Create
|
|
* Vault </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CreateVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::CreateVaultOutcomeCallable CreateVaultCallable(const Model::CreateVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 S3
|
|
* Glacier.</p> <p>You must use the following guidelines when naming a vault.</p>
|
|
* <ul> <li> <p>Names can be between 1 and 255 characters long.</p> </li> <li>
|
|
* <p>Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and '.'
|
|
* (period).</p> </li> </ul> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/creating-vaults.html">Creating
|
|
* a Vault in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-put.html">Create
|
|
* Vault </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/CreateVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void CreateVaultAsync(const Model::CreateVaultRequest& request, const CreateVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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:</p> <ul> <li> <p>If the archive retrieval job is actively preparing
|
|
* the data for download when Amazon S3 Glacier receives the delete archive
|
|
* request, the archival retrieval operation might fail.</p> </li> <li> <p>If the
|
|
* archive retrieval job has successfully prepared the archive for download when
|
|
* Amazon S3 Glacier receives the delete archive request, you will be able to
|
|
* download the output.</p> </li> </ul> <p>This operation is idempotent. Attempting
|
|
* to delete an already-deleted archive does not result in an error.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/deleting-an-archive.html">Deleting
|
|
* an Archive in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html">Delete
|
|
* Archive</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteArchive">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::DeleteArchiveOutcome DeleteArchive(const Model::DeleteArchiveRequest& request) const;
|
|
|
|
/**
|
|
* <p>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:</p> <ul> <li> <p>If the archive retrieval job is actively preparing
|
|
* the data for download when Amazon S3 Glacier receives the delete archive
|
|
* request, the archival retrieval operation might fail.</p> </li> <li> <p>If the
|
|
* archive retrieval job has successfully prepared the archive for download when
|
|
* Amazon S3 Glacier receives the delete archive request, you will be able to
|
|
* download the output.</p> </li> </ul> <p>This operation is idempotent. Attempting
|
|
* to delete an already-deleted archive does not result in an error.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/deleting-an-archive.html">Deleting
|
|
* an Archive in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html">Delete
|
|
* Archive</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteArchive">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::DeleteArchiveOutcomeCallable DeleteArchiveCallable(const Model::DeleteArchiveRequest& request) const;
|
|
|
|
/**
|
|
* <p>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:</p> <ul> <li> <p>If the archive retrieval job is actively preparing
|
|
* the data for download when Amazon S3 Glacier receives the delete archive
|
|
* request, the archival retrieval operation might fail.</p> </li> <li> <p>If the
|
|
* archive retrieval job has successfully prepared the archive for download when
|
|
* Amazon S3 Glacier receives the delete archive request, you will be able to
|
|
* download the output.</p> </li> </ul> <p>This operation is idempotent. Attempting
|
|
* to delete an already-deleted archive does not result in an error.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/deleting-an-archive.html">Deleting
|
|
* an Archive in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html">Delete
|
|
* Archive</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteArchive">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void DeleteArchiveAsync(const Model::DeleteArchiveRequest& request, const DeleteArchiveResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation deletes a vault. Amazon S3 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 S3 Glacier returns an error. You can use <a>DescribeVault</a> to
|
|
* return the number of archives in a vault, and you can use <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html">Initiate
|
|
* a Job (POST jobs)</a> to initiate a new inventory retrieval for a vault. The
|
|
* inventory contains the archive IDs you use to delete archives using <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html">Delete
|
|
* Archive (DELETE archive)</a>.</p> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/deleting-vaults.html">Deleting
|
|
* a Vault in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-delete.html">Delete
|
|
* Vault </a> in the <i>Amazon S3 Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVault">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::DeleteVaultOutcome DeleteVault(const Model::DeleteVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation deletes a vault. Amazon S3 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 S3 Glacier returns an error. You can use <a>DescribeVault</a> to
|
|
* return the number of archives in a vault, and you can use <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html">Initiate
|
|
* a Job (POST jobs)</a> to initiate a new inventory retrieval for a vault. The
|
|
* inventory contains the archive IDs you use to delete archives using <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html">Delete
|
|
* Archive (DELETE archive)</a>.</p> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/deleting-vaults.html">Deleting
|
|
* a Vault in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-delete.html">Delete
|
|
* Vault </a> in the <i>Amazon S3 Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::DeleteVaultOutcomeCallable DeleteVaultCallable(const Model::DeleteVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation deletes a vault. Amazon S3 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 S3 Glacier returns an error. You can use <a>DescribeVault</a> to
|
|
* return the number of archives in a vault, and you can use <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html">Initiate
|
|
* a Job (POST jobs)</a> to initiate a new inventory retrieval for a vault. The
|
|
* inventory contains the archive IDs you use to delete archives using <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-delete.html">Delete
|
|
* Archive (DELETE archive)</a>.</p> <p>This operation is idempotent.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/deleting-vaults.html">Deleting
|
|
* a Vault in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-delete.html">Delete
|
|
* Vault </a> in the <i>Amazon S3 Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void DeleteVaultAsync(const Model::DeleteVaultRequest& request, const DeleteVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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 S3 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::DeleteVaultAccessPolicyOutcome DeleteVaultAccessPolicy(const Model::DeleteVaultAccessPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 S3 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::DeleteVaultAccessPolicyOutcomeCallable DeleteVaultAccessPolicyCallable(const Model::DeleteVaultAccessPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 S3 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void DeleteVaultAccessPolicyAsync(const Model::DeleteVaultAccessPolicyRequest& request, const DeleteVaultAccessPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation deletes the notification configuration set for a vault. The
|
|
* operation is eventually consistent; that is, it might take some time for Amazon
|
|
* S3 Glacier to completely disable the notifications and you might still receive
|
|
* some notifications for a short time after you send the delete request.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-delete.html">Delete
|
|
* Vault Notification Configuration </a> in the Amazon S3 Glacier Developer Guide.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::DeleteVaultNotificationsOutcome DeleteVaultNotifications(const Model::DeleteVaultNotificationsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation deletes the notification configuration set for a vault. The
|
|
* operation is eventually consistent; that is, it might take some time for Amazon
|
|
* S3 Glacier to completely disable the notifications and you might still receive
|
|
* some notifications for a short time after you send the delete request.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-delete.html">Delete
|
|
* Vault Notification Configuration </a> in the Amazon S3 Glacier Developer Guide.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::DeleteVaultNotificationsOutcomeCallable DeleteVaultNotificationsCallable(const Model::DeleteVaultNotificationsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation deletes the notification configuration set for a vault. The
|
|
* operation is eventually consistent; that is, it might take some time for Amazon
|
|
* S3 Glacier to completely disable the notifications and you might still receive
|
|
* some notifications for a short time after you send the delete request.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-delete.html">Delete
|
|
* Vault Notification Configuration </a> in the Amazon S3 Glacier Developer Guide.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DeleteVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void DeleteVaultNotificationsAsync(const Model::DeleteVaultNotificationsRequest& request, const DeleteVaultNotificationsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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 S3 Glacier
|
|
* (Glacier) completes the job. For more information about initiating a job, see
|
|
* <a>InitiateJob</a>. </p> <p>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 Glacier can
|
|
* notify the topic after it completes the job.</p> <p>A job ID will not
|
|
* expire for at least 24 hours after Glacier completes the job.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For more
|
|
* information about using this operation, see the documentation for the underlying
|
|
* REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-describe-job-get.html">Describe
|
|
* Job</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DescribeJob">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::DescribeJobOutcome DescribeJob(const Model::DescribeJobRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 S3 Glacier
|
|
* (Glacier) completes the job. For more information about initiating a job, see
|
|
* <a>InitiateJob</a>. </p> <p>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 Glacier can
|
|
* notify the topic after it completes the job.</p> <p>A job ID will not
|
|
* expire for at least 24 hours after Glacier completes the job.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For more
|
|
* information about using this operation, see the documentation for the underlying
|
|
* REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-describe-job-get.html">Describe
|
|
* Job</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DescribeJob">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::DescribeJobOutcomeCallable DescribeJobCallable(const Model::DescribeJobRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 S3 Glacier
|
|
* (Glacier) completes the job. For more information about initiating a job, see
|
|
* <a>InitiateJob</a>. </p> <p>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 Glacier can
|
|
* notify the topic after it completes the job.</p> <p>A job ID will not
|
|
* expire for at least 24 hours after Glacier completes the job.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For more
|
|
* information about using this operation, see the documentation for the underlying
|
|
* REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-describe-job-get.html">Describe
|
|
* Job</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DescribeJob">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void DescribeJobAsync(const Model::DescribeJobRequest& request, const DescribeJobResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <a>InitiateJob</a>. Amazon S3 Glacier generates vault inventories approximately
|
|
* daily. For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html">Downloading
|
|
* a Vault Inventory in Amazon S3 Glacier</a>. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/retrieving-vault-info.html">Retrieving
|
|
* Vault Metadata in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-get.html">Describe
|
|
* Vault </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DescribeVault">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::DescribeVaultOutcome DescribeVault(const Model::DescribeVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <a>InitiateJob</a>. Amazon S3 Glacier generates vault inventories approximately
|
|
* daily. For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html">Downloading
|
|
* a Vault Inventory in Amazon S3 Glacier</a>. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/retrieving-vault-info.html">Retrieving
|
|
* Vault Metadata in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-get.html">Describe
|
|
* Vault </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DescribeVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::DescribeVaultOutcomeCallable DescribeVaultCallable(const Model::DescribeVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <a>InitiateJob</a>. Amazon S3 Glacier generates vault inventories approximately
|
|
* daily. For more information, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html">Downloading
|
|
* a Vault Inventory in Amazon S3 Glacier</a>. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/retrieving-vault-info.html">Retrieving
|
|
* Vault Metadata in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-get.html">Describe
|
|
* Vault </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/DescribeVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void DescribeVaultAsync(const Model::DescribeVaultRequest& request, const DescribeVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/data-retrieval-policy.html">Amazon
|
|
* Glacier Data Retrieval Policies</a>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetDataRetrievalPolicy">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::GetDataRetrievalPolicyOutcome GetDataRetrievalPolicy(const Model::GetDataRetrievalPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/data-retrieval-policy.html">Amazon
|
|
* Glacier Data Retrieval Policies</a>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetDataRetrievalPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::GetDataRetrievalPolicyOutcomeCallable GetDataRetrievalPolicyCallable(const Model::GetDataRetrievalPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/data-retrieval-policy.html">Amazon
|
|
* Glacier Data Retrieval Policies</a>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetDataRetrievalPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void GetDataRetrievalPolicyAsync(const Model::GetDataRetrievalPolicyRequest& request, const GetDataRetrievalPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation downloads the output of the job you initiated using
|
|
* <a>InitiateJob</a>. 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.</p> <p>You can download all the job output or download a portion of
|
|
* the output by specifying a byte range. In the case of an archive retrieval job,
|
|
* depending on the byte range you specify, Amazon S3 Glacier (Glacier) returns the
|
|
* checksum for the portion of the data. You can compute the checksum on the client
|
|
* and verify that the values match to ensure the portion you downloaded is the
|
|
* correct data.</p> <p>A job ID will not expire for at least 24 hours after
|
|
* Glacier completes the job. That a byte range. For both archive and inventory
|
|
* retrieval jobs, you should verify the downloaded size against the size returned
|
|
* in the headers from the <b>Get Job Output</b> response.</p> <p>For archive
|
|
* retrieval jobs, you should also verify that the size is what you expected. If
|
|
* you download a portion of the output, the expected size is based on the range of
|
|
* bytes you specified. For example, if you specify a range of
|
|
* <code>bytes=0-1048575</code>, you should verify your download size is 1,048,576
|
|
* bytes. If you download an entire archive, the expected size is the size of the
|
|
* archive when you uploaded it to Amazon S3 Glacier The expected size is also
|
|
* returned in the headers from the <b>Get Job Output</b> response.</p> <p>In the
|
|
* case of an archive retrieval job, depending on the byte range you specify,
|
|
* Glacier returns the checksum for the portion of the data. To ensure the portion
|
|
* you downloaded is the correct data, compute the checksum on the client, verify
|
|
* that the values match, and verify that the size is what you expected.</p> <p>A
|
|
* job ID does not expire for at least 24 hours after Glacier completes the job.
|
|
* That is, you can download the job output within the 24 hours period after Amazon
|
|
* Glacier completes the job.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html">Downloading
|
|
* a Vault Inventory</a>, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/downloading-an-archive.html">Downloading
|
|
* an Archive</a>, and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-job-output-get.html">Get
|
|
* Job Output </a> </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetJobOutput">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::GetJobOutputOutcome GetJobOutput(const Model::GetJobOutputRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation downloads the output of the job you initiated using
|
|
* <a>InitiateJob</a>. 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.</p> <p>You can download all the job output or download a portion of
|
|
* the output by specifying a byte range. In the case of an archive retrieval job,
|
|
* depending on the byte range you specify, Amazon S3 Glacier (Glacier) returns the
|
|
* checksum for the portion of the data. You can compute the checksum on the client
|
|
* and verify that the values match to ensure the portion you downloaded is the
|
|
* correct data.</p> <p>A job ID will not expire for at least 24 hours after
|
|
* Glacier completes the job. That a byte range. For both archive and inventory
|
|
* retrieval jobs, you should verify the downloaded size against the size returned
|
|
* in the headers from the <b>Get Job Output</b> response.</p> <p>For archive
|
|
* retrieval jobs, you should also verify that the size is what you expected. If
|
|
* you download a portion of the output, the expected size is based on the range of
|
|
* bytes you specified. For example, if you specify a range of
|
|
* <code>bytes=0-1048575</code>, you should verify your download size is 1,048,576
|
|
* bytes. If you download an entire archive, the expected size is the size of the
|
|
* archive when you uploaded it to Amazon S3 Glacier The expected size is also
|
|
* returned in the headers from the <b>Get Job Output</b> response.</p> <p>In the
|
|
* case of an archive retrieval job, depending on the byte range you specify,
|
|
* Glacier returns the checksum for the portion of the data. To ensure the portion
|
|
* you downloaded is the correct data, compute the checksum on the client, verify
|
|
* that the values match, and verify that the size is what you expected.</p> <p>A
|
|
* job ID does not expire for at least 24 hours after Glacier completes the job.
|
|
* That is, you can download the job output within the 24 hours period after Amazon
|
|
* Glacier completes the job.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html">Downloading
|
|
* a Vault Inventory</a>, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/downloading-an-archive.html">Downloading
|
|
* an Archive</a>, and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-job-output-get.html">Get
|
|
* Job Output </a> </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetJobOutput">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::GetJobOutputOutcomeCallable GetJobOutputCallable(const Model::GetJobOutputRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation downloads the output of the job you initiated using
|
|
* <a>InitiateJob</a>. 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.</p> <p>You can download all the job output or download a portion of
|
|
* the output by specifying a byte range. In the case of an archive retrieval job,
|
|
* depending on the byte range you specify, Amazon S3 Glacier (Glacier) returns the
|
|
* checksum for the portion of the data. You can compute the checksum on the client
|
|
* and verify that the values match to ensure the portion you downloaded is the
|
|
* correct data.</p> <p>A job ID will not expire for at least 24 hours after
|
|
* Glacier completes the job. That a byte range. For both archive and inventory
|
|
* retrieval jobs, you should verify the downloaded size against the size returned
|
|
* in the headers from the <b>Get Job Output</b> response.</p> <p>For archive
|
|
* retrieval jobs, you should also verify that the size is what you expected. If
|
|
* you download a portion of the output, the expected size is based on the range of
|
|
* bytes you specified. For example, if you specify a range of
|
|
* <code>bytes=0-1048575</code>, you should verify your download size is 1,048,576
|
|
* bytes. If you download an entire archive, the expected size is the size of the
|
|
* archive when you uploaded it to Amazon S3 Glacier The expected size is also
|
|
* returned in the headers from the <b>Get Job Output</b> response.</p> <p>In the
|
|
* case of an archive retrieval job, depending on the byte range you specify,
|
|
* Glacier returns the checksum for the portion of the data. To ensure the portion
|
|
* you downloaded is the correct data, compute the checksum on the client, verify
|
|
* that the values match, and verify that the size is what you expected.</p> <p>A
|
|
* job ID does not expire for at least 24 hours after Glacier completes the job.
|
|
* That is, you can download the job output within the 24 hours period after Amazon
|
|
* Glacier completes the job.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html">Downloading
|
|
* a Vault Inventory</a>, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/downloading-an-archive.html">Downloading
|
|
* an Archive</a>, and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-job-output-get.html">Get
|
|
* Job Output </a> </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetJobOutput">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void GetJobOutputAsync(const Model::GetJobOutputRequest& request, const GetJobOutputResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the <code>access-policy</code> subresource set on
|
|
* the vault; for more information on setting this subresource, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-SetVaultAccessPolicy.html">Set
|
|
* Vault Access Policy (PUT access-policy)</a>. If there is no access policy set on
|
|
* the vault, the operation returns a <code>404 Not found</code> error. For more
|
|
* information about vault access policies, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::GetVaultAccessPolicyOutcome GetVaultAccessPolicy(const Model::GetVaultAccessPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the <code>access-policy</code> subresource set on
|
|
* the vault; for more information on setting this subresource, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-SetVaultAccessPolicy.html">Set
|
|
* Vault Access Policy (PUT access-policy)</a>. If there is no access policy set on
|
|
* the vault, the operation returns a <code>404 Not found</code> error. For more
|
|
* information about vault access policies, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::GetVaultAccessPolicyOutcomeCallable GetVaultAccessPolicyCallable(const Model::GetVaultAccessPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the <code>access-policy</code> subresource set on
|
|
* the vault; for more information on setting this subresource, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-SetVaultAccessPolicy.html">Set
|
|
* Vault Access Policy (PUT access-policy)</a>. If there is no access policy set on
|
|
* the vault, the operation returns a <code>404 Not found</code> error. For more
|
|
* information about vault access policies, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void GetVaultAccessPolicyAsync(const Model::GetVaultAccessPolicyRequest& request, const GetVaultAccessPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the following attributes from the
|
|
* <code>lock-policy</code> subresource set on the specified vault: </p> <ul> <li>
|
|
* <p>The vault lock policy set on the vault.</p> </li> <li> <p>The state of the
|
|
* vault lock, which is either <code>InProgess</code> or <code>Locked</code>.</p>
|
|
* </li> <li> <p>When the lock ID expires. The lock ID is used to complete the
|
|
* vault locking process.</p> </li> <li> <p>When the vault lock was initiated and
|
|
* put into the <code>InProgress</code> state.</p> </li> </ul> <p>A vault lock is
|
|
* put into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>.
|
|
* A vault lock is put into the <code>Locked</code> state by calling
|
|
* <a>CompleteVaultLock</a>. You can abort the vault locking process by calling
|
|
* <a>AbortVaultLock</a>. For more information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. </p> <p>If there is no vault lock policy set on the
|
|
* vault, the operation returns a <code>404 Not found</code> error. For more
|
|
* information about vault lock policies, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::GetVaultLockOutcome GetVaultLock(const Model::GetVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the following attributes from the
|
|
* <code>lock-policy</code> subresource set on the specified vault: </p> <ul> <li>
|
|
* <p>The vault lock policy set on the vault.</p> </li> <li> <p>The state of the
|
|
* vault lock, which is either <code>InProgess</code> or <code>Locked</code>.</p>
|
|
* </li> <li> <p>When the lock ID expires. The lock ID is used to complete the
|
|
* vault locking process.</p> </li> <li> <p>When the vault lock was initiated and
|
|
* put into the <code>InProgress</code> state.</p> </li> </ul> <p>A vault lock is
|
|
* put into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>.
|
|
* A vault lock is put into the <code>Locked</code> state by calling
|
|
* <a>CompleteVaultLock</a>. You can abort the vault locking process by calling
|
|
* <a>AbortVaultLock</a>. For more information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. </p> <p>If there is no vault lock policy set on the
|
|
* vault, the operation returns a <code>404 Not found</code> error. For more
|
|
* information about vault lock policies, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::GetVaultLockOutcomeCallable GetVaultLockCallable(const Model::GetVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the following attributes from the
|
|
* <code>lock-policy</code> subresource set on the specified vault: </p> <ul> <li>
|
|
* <p>The vault lock policy set on the vault.</p> </li> <li> <p>The state of the
|
|
* vault lock, which is either <code>InProgess</code> or <code>Locked</code>.</p>
|
|
* </li> <li> <p>When the lock ID expires. The lock ID is used to complete the
|
|
* vault locking process.</p> </li> <li> <p>When the vault lock was initiated and
|
|
* put into the <code>InProgress</code> state.</p> </li> </ul> <p>A vault lock is
|
|
* put into the <code>InProgress</code> state by calling <a>InitiateVaultLock</a>.
|
|
* A vault lock is put into the <code>Locked</code> state by calling
|
|
* <a>CompleteVaultLock</a>. You can abort the vault locking process by calling
|
|
* <a>AbortVaultLock</a>. For more information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>. </p> <p>If there is no vault lock policy set on the
|
|
* vault, the operation returns a <code>404 Not found</code> error. For more
|
|
* information about vault lock policies, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void GetVaultLockAsync(const Model::GetVaultLockRequest& request, const GetVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the <code>notification-configuration</code>
|
|
* subresource of the specified vault.</p> <p>For information about setting a
|
|
* notification configuration on a vault, see <a>SetVaultNotifications</a>. If a
|
|
* notification configuration for a vault is not set, the operation returns a
|
|
* <code>404 Not Found</code> error. For more information about vault
|
|
* notifications, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a>. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-get.html">Get
|
|
* Vault Notification Configuration </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::GetVaultNotificationsOutcome GetVaultNotifications(const Model::GetVaultNotificationsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the <code>notification-configuration</code>
|
|
* subresource of the specified vault.</p> <p>For information about setting a
|
|
* notification configuration on a vault, see <a>SetVaultNotifications</a>. If a
|
|
* notification configuration for a vault is not set, the operation returns a
|
|
* <code>404 Not Found</code> error. For more information about vault
|
|
* notifications, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a>. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-get.html">Get
|
|
* Vault Notification Configuration </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::GetVaultNotificationsOutcomeCallable GetVaultNotificationsCallable(const Model::GetVaultNotificationsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation retrieves the <code>notification-configuration</code>
|
|
* subresource of the specified vault.</p> <p>For information about setting a
|
|
* notification configuration on a vault, see <a>SetVaultNotifications</a>. If a
|
|
* notification configuration for a vault is not set, the operation returns a
|
|
* <code>404 Not Found</code> error. For more information about vault
|
|
* notifications, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a>. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-get.html">Get
|
|
* Vault Notification Configuration </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/GetVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void GetVaultNotificationsAsync(const Model::GetVaultNotificationsRequest& request, const GetVaultNotificationsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation initiates a job of the specified type, which can be a select,
|
|
* an archival retrieval, or a vault retrieval. For more information about using
|
|
* this operation, see the documentation for the underlying REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html">Initiate
|
|
* a Job</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateJob">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::InitiateJobOutcome InitiateJob(const Model::InitiateJobRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation initiates a job of the specified type, which can be a select,
|
|
* an archival retrieval, or a vault retrieval. For more information about using
|
|
* this operation, see the documentation for the underlying REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html">Initiate
|
|
* a Job</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateJob">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::InitiateJobOutcomeCallable InitiateJobCallable(const Model::InitiateJobRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation initiates a job of the specified type, which can be a select,
|
|
* an archival retrieval, or a vault retrieval. For more information about using
|
|
* this operation, see the documentation for the underlying REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-initiate-job-post.html">Initiate
|
|
* a Job</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateJob">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void InitiateJobAsync(const Model::InitiateJobRequest& request, const InitiateJobResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation initiates a multipart upload. Amazon S3 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
|
|
* <a>UploadMultipartPart</a>).</p> <p>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.</p> <p>Every part you upload to this resource (see
|
|
* <a>UploadMultipartPart</a>), 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. </p>
|
|
* <p>You don't need to know the size of the archive when you start a
|
|
* multipart upload because Amazon S3 Glacier does not require you to specify the
|
|
* overall archive size.</p> <p>After you complete the multipart upload,
|
|
* Amazon S3 Glacier (Glacier) removes the multipart upload resource referenced by
|
|
* the ID. 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-initiate-upload.html">Initiate
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::InitiateMultipartUploadOutcome InitiateMultipartUpload(const Model::InitiateMultipartUploadRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation initiates a multipart upload. Amazon S3 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
|
|
* <a>UploadMultipartPart</a>).</p> <p>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.</p> <p>Every part you upload to this resource (see
|
|
* <a>UploadMultipartPart</a>), 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. </p>
|
|
* <p>You don't need to know the size of the archive when you start a
|
|
* multipart upload because Amazon S3 Glacier does not require you to specify the
|
|
* overall archive size.</p> <p>After you complete the multipart upload,
|
|
* Amazon S3 Glacier (Glacier) removes the multipart upload resource referenced by
|
|
* the ID. 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-initiate-upload.html">Initiate
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::InitiateMultipartUploadOutcomeCallable InitiateMultipartUploadCallable(const Model::InitiateMultipartUploadRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation initiates a multipart upload. Amazon S3 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
|
|
* <a>UploadMultipartPart</a>).</p> <p>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.</p> <p>Every part you upload to this resource (see
|
|
* <a>UploadMultipartPart</a>), 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. </p>
|
|
* <p>You don't need to know the size of the archive when you start a
|
|
* multipart upload because Amazon S3 Glacier does not require you to specify the
|
|
* overall archive size.</p> <p>After you complete the multipart upload,
|
|
* Amazon S3 Glacier (Glacier) removes the multipart upload resource referenced by
|
|
* the ID. 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-initiate-upload.html">Initiate
|
|
* Multipart Upload</a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateMultipartUpload">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void InitiateMultipartUploadAsync(const Model::InitiateMultipartUploadRequest& request, const InitiateMultipartUploadResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation initiates the vault locking process by doing the
|
|
* following:</p> <ul> <li> <p>Installing a vault lock policy on the specified
|
|
* vault.</p> </li> <li> <p>Setting the lock state of vault lock to
|
|
* <code>InProgress</code>.</p> </li> <li> <p>Returning a lock ID, which is used to
|
|
* complete the vault locking process.</p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p> <p>You must complete
|
|
* the vault locking process within 24 hours after the vault lock enters the
|
|
* <code>InProgress</code> state. After the 24 hour window ends, the lock ID
|
|
* expires, the vault automatically exits the <code>InProgress</code> state, and
|
|
* the vault lock policy is removed from the vault. You call
|
|
* <a>CompleteVaultLock</a> to complete the vault locking process by setting the
|
|
* state of the vault lock to <code>Locked</code>. </p> <p>After a vault lock is in
|
|
* the <code>Locked</code> state, you cannot initiate a new vault lock for the
|
|
* vault.</p> <p>You can abort the vault locking process by calling
|
|
* <a>AbortVaultLock</a>. You can get the state of the vault lock by calling
|
|
* <a>GetVaultLock</a>. For more information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>.</p> <p>If this operation is called when the vault lock
|
|
* is in the <code>InProgress</code> state, the operation returns an
|
|
* <code>AccessDeniedException</code> error. When the vault lock is in the
|
|
* <code>InProgress</code> state you must call <a>AbortVaultLock</a> before you can
|
|
* initiate a new vault lock policy. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::InitiateVaultLockOutcome InitiateVaultLock(const Model::InitiateVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation initiates the vault locking process by doing the
|
|
* following:</p> <ul> <li> <p>Installing a vault lock policy on the specified
|
|
* vault.</p> </li> <li> <p>Setting the lock state of vault lock to
|
|
* <code>InProgress</code>.</p> </li> <li> <p>Returning a lock ID, which is used to
|
|
* complete the vault locking process.</p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p> <p>You must complete
|
|
* the vault locking process within 24 hours after the vault lock enters the
|
|
* <code>InProgress</code> state. After the 24 hour window ends, the lock ID
|
|
* expires, the vault automatically exits the <code>InProgress</code> state, and
|
|
* the vault lock policy is removed from the vault. You call
|
|
* <a>CompleteVaultLock</a> to complete the vault locking process by setting the
|
|
* state of the vault lock to <code>Locked</code>. </p> <p>After a vault lock is in
|
|
* the <code>Locked</code> state, you cannot initiate a new vault lock for the
|
|
* vault.</p> <p>You can abort the vault locking process by calling
|
|
* <a>AbortVaultLock</a>. You can get the state of the vault lock by calling
|
|
* <a>GetVaultLock</a>. For more information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>.</p> <p>If this operation is called when the vault lock
|
|
* is in the <code>InProgress</code> state, the operation returns an
|
|
* <code>AccessDeniedException</code> error. When the vault lock is in the
|
|
* <code>InProgress</code> state you must call <a>AbortVaultLock</a> before you can
|
|
* initiate a new vault lock policy. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::InitiateVaultLockOutcomeCallable InitiateVaultLockCallable(const Model::InitiateVaultLockRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation initiates the vault locking process by doing the
|
|
* following:</p> <ul> <li> <p>Installing a vault lock policy on the specified
|
|
* vault.</p> </li> <li> <p>Setting the lock state of vault lock to
|
|
* <code>InProgress</code>.</p> </li> <li> <p>Returning a lock ID, which is used to
|
|
* complete the vault locking process.</p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock-policy.html">Amazon
|
|
* Glacier Access Control with Vault Lock Policies</a>. </p> <p>You must complete
|
|
* the vault locking process within 24 hours after the vault lock enters the
|
|
* <code>InProgress</code> state. After the 24 hour window ends, the lock ID
|
|
* expires, the vault automatically exits the <code>InProgress</code> state, and
|
|
* the vault lock policy is removed from the vault. You call
|
|
* <a>CompleteVaultLock</a> to complete the vault locking process by setting the
|
|
* state of the vault lock to <code>Locked</code>. </p> <p>After a vault lock is in
|
|
* the <code>Locked</code> state, you cannot initiate a new vault lock for the
|
|
* vault.</p> <p>You can abort the vault locking process by calling
|
|
* <a>AbortVaultLock</a>. You can get the state of the vault lock by calling
|
|
* <a>GetVaultLock</a>. For more information about the vault locking process, <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-lock.html">Amazon
|
|
* Glacier Vault Lock</a>.</p> <p>If this operation is called when the vault lock
|
|
* is in the <code>InProgress</code> state, the operation returns an
|
|
* <code>AccessDeniedException</code> error. When the vault lock is in the
|
|
* <code>InProgress</code> state you must call <a>AbortVaultLock</a> before you can
|
|
* initiate a new vault lock policy. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/InitiateVaultLock">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void InitiateVaultLockAsync(const Model::InitiateVaultLockRequest& request, const InitiateVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation lists jobs for a vault, including jobs that are in-progress
|
|
* and jobs that have recently finished. The List Job operation returns a list of
|
|
* these jobs sorted by job initiation time.</p> <p>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.</p>
|
|
* <p>The List Jobs operation supports pagination. You should always check
|
|
* the response <code>Marker</code> field. If there are no more jobs to list, the
|
|
* <code>Marker</code> field is set to <code>null</code>. If there are more jobs to
|
|
* list, the <code>Marker</code> field is set to a non-null value, which you can
|
|
* use to continue the pagination of the list. To return a list of jobs that begins
|
|
* at a specific job, set the marker request parameter to the <code>Marker</code>
|
|
* value for that job that you obtained from a previous List Jobs request.</p>
|
|
* <p>You can set a maximum limit for the number of jobs returned in the response
|
|
* by specifying the <code>limit</code> parameter in the request. The default limit
|
|
* is 50. The number of jobs returned might be fewer than the limit, but the number
|
|
* of returned jobs never exceeds the limit.</p> <p>Additionally, you can filter
|
|
* the jobs list returned by specifying the optional <code>statuscode</code>
|
|
* parameter or <code>completed</code> parameter, or both. Using the
|
|
* <code>statuscode</code> parameter, you can specify to return only jobs that
|
|
* match either the <code>InProgress</code>, <code>Succeeded</code>, or
|
|
* <code>Failed</code> status. Using the <code>completed</code> parameter, you can
|
|
* specify to return only jobs that were completed (<code>true</code>) or jobs that
|
|
* were not completed (<code>false</code>).</p> <p>For more information about using
|
|
* this operation, see the documentation for the underlying REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-jobs-get.html">List
|
|
* Jobs</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListJobs">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::ListJobsOutcome ListJobs(const Model::ListJobsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation lists jobs for a vault, including jobs that are in-progress
|
|
* and jobs that have recently finished. The List Job operation returns a list of
|
|
* these jobs sorted by job initiation time.</p> <p>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.</p>
|
|
* <p>The List Jobs operation supports pagination. You should always check
|
|
* the response <code>Marker</code> field. If there are no more jobs to list, the
|
|
* <code>Marker</code> field is set to <code>null</code>. If there are more jobs to
|
|
* list, the <code>Marker</code> field is set to a non-null value, which you can
|
|
* use to continue the pagination of the list. To return a list of jobs that begins
|
|
* at a specific job, set the marker request parameter to the <code>Marker</code>
|
|
* value for that job that you obtained from a previous List Jobs request.</p>
|
|
* <p>You can set a maximum limit for the number of jobs returned in the response
|
|
* by specifying the <code>limit</code> parameter in the request. The default limit
|
|
* is 50. The number of jobs returned might be fewer than the limit, but the number
|
|
* of returned jobs never exceeds the limit.</p> <p>Additionally, you can filter
|
|
* the jobs list returned by specifying the optional <code>statuscode</code>
|
|
* parameter or <code>completed</code> parameter, or both. Using the
|
|
* <code>statuscode</code> parameter, you can specify to return only jobs that
|
|
* match either the <code>InProgress</code>, <code>Succeeded</code>, or
|
|
* <code>Failed</code> status. Using the <code>completed</code> parameter, you can
|
|
* specify to return only jobs that were completed (<code>true</code>) or jobs that
|
|
* were not completed (<code>false</code>).</p> <p>For more information about using
|
|
* this operation, see the documentation for the underlying REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-jobs-get.html">List
|
|
* Jobs</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListJobs">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::ListJobsOutcomeCallable ListJobsCallable(const Model::ListJobsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation lists jobs for a vault, including jobs that are in-progress
|
|
* and jobs that have recently finished. The List Job operation returns a list of
|
|
* these jobs sorted by job initiation time.</p> <p>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.</p>
|
|
* <p>The List Jobs operation supports pagination. You should always check
|
|
* the response <code>Marker</code> field. If there are no more jobs to list, the
|
|
* <code>Marker</code> field is set to <code>null</code>. If there are more jobs to
|
|
* list, the <code>Marker</code> field is set to a non-null value, which you can
|
|
* use to continue the pagination of the list. To return a list of jobs that begins
|
|
* at a specific job, set the marker request parameter to the <code>Marker</code>
|
|
* value for that job that you obtained from a previous List Jobs request.</p>
|
|
* <p>You can set a maximum limit for the number of jobs returned in the response
|
|
* by specifying the <code>limit</code> parameter in the request. The default limit
|
|
* is 50. The number of jobs returned might be fewer than the limit, but the number
|
|
* of returned jobs never exceeds the limit.</p> <p>Additionally, you can filter
|
|
* the jobs list returned by specifying the optional <code>statuscode</code>
|
|
* parameter or <code>completed</code> parameter, or both. Using the
|
|
* <code>statuscode</code> parameter, you can specify to return only jobs that
|
|
* match either the <code>InProgress</code>, <code>Succeeded</code>, or
|
|
* <code>Failed</code> status. Using the <code>completed</code> parameter, you can
|
|
* specify to return only jobs that were completed (<code>true</code>) or jobs that
|
|
* were not completed (<code>false</code>).</p> <p>For more information about using
|
|
* this operation, see the documentation for the underlying REST API <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-jobs-get.html">List
|
|
* Jobs</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListJobs">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void ListJobsAsync(const Model::ListJobsRequest& request, const ListJobsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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 <a>InitiateMultipartUpload</a> request, but has not yet been completed or
|
|
* aborted. The list returned in the List Multipart Upload response has no
|
|
* guaranteed order. </p> <p>The List Multipart Uploads operation supports
|
|
* pagination. By default, this operation returns up to 50 multipart uploads in the
|
|
* response. You should always check the response for a <code>marker</code> at
|
|
* which to continue the list; if there are no more items the <code>marker</code>
|
|
* is <code>null</code>. To return a list of multipart uploads that begins at a
|
|
* specific upload, set the <code>marker</code> 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 <code>limit</code>
|
|
* parameter in the request.</p> <p>Note the difference between this operation and
|
|
* listing parts (<a>ListParts</a>). 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-list-uploads.html">List
|
|
* Multipart Uploads </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListMultipartUploads">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::ListMultipartUploadsOutcome ListMultipartUploads(const Model::ListMultipartUploadsRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 <a>InitiateMultipartUpload</a> request, but has not yet been completed or
|
|
* aborted. The list returned in the List Multipart Upload response has no
|
|
* guaranteed order. </p> <p>The List Multipart Uploads operation supports
|
|
* pagination. By default, this operation returns up to 50 multipart uploads in the
|
|
* response. You should always check the response for a <code>marker</code> at
|
|
* which to continue the list; if there are no more items the <code>marker</code>
|
|
* is <code>null</code>. To return a list of multipart uploads that begins at a
|
|
* specific upload, set the <code>marker</code> 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 <code>limit</code>
|
|
* parameter in the request.</p> <p>Note the difference between this operation and
|
|
* listing parts (<a>ListParts</a>). 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-list-uploads.html">List
|
|
* Multipart Uploads </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListMultipartUploads">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::ListMultipartUploadsOutcomeCallable ListMultipartUploadsCallable(const Model::ListMultipartUploadsRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 <a>InitiateMultipartUpload</a> request, but has not yet been completed or
|
|
* aborted. The list returned in the List Multipart Upload response has no
|
|
* guaranteed order. </p> <p>The List Multipart Uploads operation supports
|
|
* pagination. By default, this operation returns up to 50 multipart uploads in the
|
|
* response. You should always check the response for a <code>marker</code> at
|
|
* which to continue the list; if there are no more items the <code>marker</code>
|
|
* is <code>null</code>. To return a list of multipart uploads that begins at a
|
|
* specific upload, set the <code>marker</code> 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 <code>limit</code>
|
|
* parameter in the request.</p> <p>Note the difference between this operation and
|
|
* listing parts (<a>ListParts</a>). 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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-list-uploads.html">List
|
|
* Multipart Uploads </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListMultipartUploads">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void ListMultipartUploadsAsync(const Model::ListMultipartUploadsRequest& request, const ListMultipartUploadsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <a>CompleteMultipartUpload</a>. List Parts returns an error for completed
|
|
* uploads. The list returned in the List Parts response is sorted by part range.
|
|
* </p> <p>The List Parts operation supports pagination. By default, this operation
|
|
* returns up to 50 uploaded parts in the response. You should always check the
|
|
* response for a <code>marker</code> at which to continue the list; if there are
|
|
* no more items the <code>marker</code> is <code>null</code>. To return a list of
|
|
* parts that begins at a specific part, set the <code>marker</code> 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
|
|
* <code>limit</code> parameter in the request. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-list-parts.html">List
|
|
* Parts</a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListParts">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::ListPartsOutcome ListParts(const Model::ListPartsRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <a>CompleteMultipartUpload</a>. List Parts returns an error for completed
|
|
* uploads. The list returned in the List Parts response is sorted by part range.
|
|
* </p> <p>The List Parts operation supports pagination. By default, this operation
|
|
* returns up to 50 uploaded parts in the response. You should always check the
|
|
* response for a <code>marker</code> at which to continue the list; if there are
|
|
* no more items the <code>marker</code> is <code>null</code>. To return a list of
|
|
* parts that begins at a specific part, set the <code>marker</code> 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
|
|
* <code>limit</code> parameter in the request. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-list-parts.html">List
|
|
* Parts</a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListParts">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::ListPartsOutcomeCallable ListPartsCallable(const Model::ListPartsRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <a>CompleteMultipartUpload</a>. List Parts returns an error for completed
|
|
* uploads. The list returned in the List Parts response is sorted by part range.
|
|
* </p> <p>The List Parts operation supports pagination. By default, this operation
|
|
* returns up to 50 uploaded parts in the response. You should always check the
|
|
* response for a <code>marker</code> at which to continue the list; if there are
|
|
* no more items the <code>marker</code> is <code>null</code>. To return a list of
|
|
* parts that begins at a specific part, set the <code>marker</code> 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
|
|
* <code>limit</code> parameter in the request. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and the underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-archives.html">Working
|
|
* with Archives in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-multipart-list-parts.html">List
|
|
* Parts</a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListParts">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void ListPartsAsync(const Model::ListPartsRequest& request, const ListPartsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation lists the provisioned capacity units for the specified AWS
|
|
* account.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListProvisionedCapacity">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::ListProvisionedCapacityOutcome ListProvisionedCapacity(const Model::ListProvisionedCapacityRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation lists the provisioned capacity units for the specified AWS
|
|
* account.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListProvisionedCapacity">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::ListProvisionedCapacityOutcomeCallable ListProvisionedCapacityCallable(const Model::ListProvisionedCapacityRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation lists the provisioned capacity units for the specified AWS
|
|
* account.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListProvisionedCapacity">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void ListProvisionedCapacityAsync(const Model::ListProvisionedCapacityRequest& request, const ListProvisionedCapacityResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListTagsForVault">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::ListTagsForVaultOutcome ListTagsForVault(const Model::ListTagsForVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListTagsForVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::ListTagsForVaultOutcomeCallable ListTagsForVaultCallable(const Model::ListTagsForVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>.</p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListTagsForVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void ListTagsForVaultAsync(const Model::ListTagsForVaultRequest& request, const ListTagsForVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation lists all vaults owned by the calling user's account. The list
|
|
* returned in the response is ASCII-sorted by vault name.</p> <p>By default, this
|
|
* operation returns up to 10 items. If there are more vaults to list, the response
|
|
* <code>marker</code> field contains the vault Amazon Resource Name (ARN) at which
|
|
* to continue the list with a new List Vaults request; otherwise, the
|
|
* <code>marker</code> field is <code>null</code>. To return a list of vaults that
|
|
* begins at a specific vault, set the <code>marker</code> 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
|
|
* <code>limit</code> parameter in the request. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/retrieving-vault-info.html">Retrieving
|
|
* Vault Metadata in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vaults-get.html">List
|
|
* Vaults </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListVaults">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::ListVaultsOutcome ListVaults(const Model::ListVaultsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation lists all vaults owned by the calling user's account. The list
|
|
* returned in the response is ASCII-sorted by vault name.</p> <p>By default, this
|
|
* operation returns up to 10 items. If there are more vaults to list, the response
|
|
* <code>marker</code> field contains the vault Amazon Resource Name (ARN) at which
|
|
* to continue the list with a new List Vaults request; otherwise, the
|
|
* <code>marker</code> field is <code>null</code>. To return a list of vaults that
|
|
* begins at a specific vault, set the <code>marker</code> 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
|
|
* <code>limit</code> parameter in the request. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/retrieving-vault-info.html">Retrieving
|
|
* Vault Metadata in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vaults-get.html">List
|
|
* Vaults </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListVaults">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::ListVaultsOutcomeCallable ListVaultsCallable(const Model::ListVaultsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation lists all vaults owned by the calling user's account. The list
|
|
* returned in the response is ASCII-sorted by vault name.</p> <p>By default, this
|
|
* operation returns up to 10 items. If there are more vaults to list, the response
|
|
* <code>marker</code> field contains the vault Amazon Resource Name (ARN) at which
|
|
* to continue the list with a new List Vaults request; otherwise, the
|
|
* <code>marker</code> field is <code>null</code>. To return a list of vaults that
|
|
* begins at a specific vault, set the <code>marker</code> 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
|
|
* <code>limit</code> parameter in the request. </p> <p>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
|
|
* <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/retrieving-vault-info.html">Retrieving
|
|
* Vault Metadata in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vaults-get.html">List
|
|
* Vaults </a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/ListVaults">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void ListVaultsAsync(const Model::ListVaultsRequest& request, const ListVaultsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation purchases a provisioned capacity unit for an AWS account.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/PurchaseProvisionedCapacity">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::PurchaseProvisionedCapacityOutcome PurchaseProvisionedCapacity(const Model::PurchaseProvisionedCapacityRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation purchases a provisioned capacity unit for an AWS account.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/PurchaseProvisionedCapacity">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::PurchaseProvisionedCapacityOutcomeCallable PurchaseProvisionedCapacityCallable(const Model::PurchaseProvisionedCapacityRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation purchases a provisioned capacity unit for an AWS account.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/PurchaseProvisionedCapacity">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void PurchaseProvisionedCapacityAsync(const Model::PurchaseProvisionedCapacityRequest& request, const PurchaseProvisionedCapacityResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation removes one or more tags from the set of tags attached to a
|
|
* vault. For more information about tags, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>. This operation is idempotent. The operation
|
|
* will be successful, even if there are no tags attached to the vault.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/RemoveTagsFromVault">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::RemoveTagsFromVaultOutcome RemoveTagsFromVault(const Model::RemoveTagsFromVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation removes one or more tags from the set of tags attached to a
|
|
* vault. For more information about tags, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>. This operation is idempotent. The operation
|
|
* will be successful, even if there are no tags attached to the vault.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/RemoveTagsFromVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::RemoveTagsFromVaultOutcomeCallable RemoveTagsFromVaultCallable(const Model::RemoveTagsFromVaultRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation removes one or more tags from the set of tags attached to a
|
|
* vault. For more information about tags, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/tagging.html">Tagging
|
|
* Amazon S3 Glacier Resources</a>. This operation is idempotent. The operation
|
|
* will be successful, even if there are no tags attached to the vault.
|
|
* </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/RemoveTagsFromVault">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void RemoveTagsFromVaultAsync(const Model::RemoveTagsFromVaultRequest& request, const RemoveTagsFromVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/data-retrieval-policy.html">Amazon
|
|
* Glacier Data Retrieval Policies</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetDataRetrievalPolicy">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::SetDataRetrievalPolicyOutcome SetDataRetrievalPolicy(const Model::SetDataRetrievalPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/data-retrieval-policy.html">Amazon
|
|
* Glacier Data Retrieval Policies</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetDataRetrievalPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::SetDataRetrievalPolicyOutcomeCallable SetDataRetrievalPolicyCallable(const Model::SetDataRetrievalPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/data-retrieval-policy.html">Amazon
|
|
* Glacier Data Retrieval Policies</a>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetDataRetrievalPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void SetDataRetrievalPolicyAsync(const Model::SetDataRetrievalPolicyRequest& request, const SetDataRetrievalPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <code>access-policy</code> 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::SetVaultAccessPolicyOutcome SetVaultAccessPolicy(const Model::SetVaultAccessPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <code>access-policy</code> 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::SetVaultAccessPolicyOutcomeCallable SetVaultAccessPolicyCallable(const Model::SetVaultAccessPolicyRequest& request) const;
|
|
|
|
/**
|
|
* <p>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
|
|
* <code>access-policy</code> 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html">Amazon
|
|
* Glacier Access Control with Vault Access Policies</a>. </p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetVaultAccessPolicy">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void SetVaultAccessPolicyAsync(const Model::SetVaultAccessPolicyRequest& request, const SetVaultAccessPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation configures notifications that will be sent when specific
|
|
* events happen to a vault. By default, you don't get any notifications.</p> <p>To
|
|
* configure vault notifications, send a PUT request to the
|
|
* <code>notification-configuration</code> 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 S3 Glacier to send notifications to the
|
|
* topic.</p> <p>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:</p> <ul> <li> <p>
|
|
* <b>ArchiveRetrievalCompleted</b> This event occurs when a job that was initiated
|
|
* for an archive retrieval is completed (<a>InitiateJob</a>). 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 <a>DescribeJob</a>. </p> </li> <li>
|
|
* <p> <b>InventoryRetrievalCompleted</b> This event occurs when a job that was
|
|
* initiated for an inventory retrieval is completed (<a>InitiateJob</a>). 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 <a>DescribeJob</a>.
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-put.html">Set
|
|
* Vault Notification Configuration </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::SetVaultNotificationsOutcome SetVaultNotifications(const Model::SetVaultNotificationsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation configures notifications that will be sent when specific
|
|
* events happen to a vault. By default, you don't get any notifications.</p> <p>To
|
|
* configure vault notifications, send a PUT request to the
|
|
* <code>notification-configuration</code> 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 S3 Glacier to send notifications to the
|
|
* topic.</p> <p>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:</p> <ul> <li> <p>
|
|
* <b>ArchiveRetrievalCompleted</b> This event occurs when a job that was initiated
|
|
* for an archive retrieval is completed (<a>InitiateJob</a>). 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 <a>DescribeJob</a>. </p> </li> <li>
|
|
* <p> <b>InventoryRetrievalCompleted</b> This event occurs when a job that was
|
|
* initiated for an inventory retrieval is completed (<a>InitiateJob</a>). 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 <a>DescribeJob</a>.
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-put.html">Set
|
|
* Vault Notification Configuration </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::SetVaultNotificationsOutcomeCallable SetVaultNotificationsCallable(const Model::SetVaultNotificationsRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation configures notifications that will be sent when specific
|
|
* events happen to a vault. By default, you don't get any notifications.</p> <p>To
|
|
* configure vault notifications, send a PUT request to the
|
|
* <code>notification-configuration</code> 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 S3 Glacier to send notifications to the
|
|
* topic.</p> <p>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:</p> <ul> <li> <p>
|
|
* <b>ArchiveRetrievalCompleted</b> This event occurs when a job that was initiated
|
|
* for an archive retrieval is completed (<a>InitiateJob</a>). 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 <a>DescribeJob</a>. </p> </li> <li>
|
|
* <p> <b>InventoryRetrievalCompleted</b> This event occurs when a job that was
|
|
* initiated for an inventory retrieval is completed (<a>InitiateJob</a>). 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 <a>DescribeJob</a>.
|
|
* </p> </li> </ul> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p>For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/configuring-notifications.html">Configuring
|
|
* Vault Notifications in Amazon S3 Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-vault-notifications-put.html">Set
|
|
* Vault Notification Configuration </a> in the <i>Amazon Glacier Developer
|
|
* Guide</i>. </p><p><h3>See Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/SetVaultNotifications">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void SetVaultNotificationsAsync(const Model::SetVaultNotificationsRequest& request, const SetVaultNotificationsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>This operation adds an archive to a vault. This is a synchronous operation,
|
|
* and for a successful upload, your data is durably persisted. Amazon S3 Glacier
|
|
* returns the archive ID in the <code>x-amz-archive-id</code> header of the
|
|
* response. </p> <p>You must use the archive ID to access your data in Amazon S3
|
|
* 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 <a>InitiateJob</a>.
|
|
* </p> <p>You must provide a SHA256 tree hash of the data you are uploading. For
|
|
* information about computing a SHA256 tree hash, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>. </p> <p>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 <a>InitiateJob</a>. 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. </p>
|
|
* <p>Archives are immutable. After you upload an archive, you cannot edit the
|
|
* archive or its description.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-an-archive.html">Uploading
|
|
* an Archive in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-post.html">Upload
|
|
* Archive</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/UploadArchive">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::UploadArchiveOutcome UploadArchive(const Model::UploadArchiveRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation adds an archive to a vault. This is a synchronous operation,
|
|
* and for a successful upload, your data is durably persisted. Amazon S3 Glacier
|
|
* returns the archive ID in the <code>x-amz-archive-id</code> header of the
|
|
* response. </p> <p>You must use the archive ID to access your data in Amazon S3
|
|
* 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 <a>InitiateJob</a>.
|
|
* </p> <p>You must provide a SHA256 tree hash of the data you are uploading. For
|
|
* information about computing a SHA256 tree hash, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>. </p> <p>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 <a>InitiateJob</a>. 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. </p>
|
|
* <p>Archives are immutable. After you upload an archive, you cannot edit the
|
|
* archive or its description.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-an-archive.html">Uploading
|
|
* an Archive in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-post.html">Upload
|
|
* Archive</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/UploadArchive">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::UploadArchiveOutcomeCallable UploadArchiveCallable(const Model::UploadArchiveRequest& request) const;
|
|
|
|
/**
|
|
* <p>This operation adds an archive to a vault. This is a synchronous operation,
|
|
* and for a successful upload, your data is durably persisted. Amazon S3 Glacier
|
|
* returns the archive ID in the <code>x-amz-archive-id</code> header of the
|
|
* response. </p> <p>You must use the archive ID to access your data in Amazon S3
|
|
* 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 <a>InitiateJob</a>.
|
|
* </p> <p>You must provide a SHA256 tree hash of the data you are uploading. For
|
|
* information about computing a SHA256 tree hash, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>. </p> <p>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 <a>InitiateJob</a>. 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. </p>
|
|
* <p>Archives are immutable. After you upload an archive, you cannot edit the
|
|
* archive or its description.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-an-archive.html">Uploading
|
|
* an Archive in Amazon Glacier</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-archive-post.html">Upload
|
|
* Archive</a> in the <i>Amazon Glacier Developer Guide</i>. </p><p><h3>See
|
|
* Also:</h3> <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/UploadArchive">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void UploadArchiveAsync(const Model::UploadArchiveRequest& request, const UploadArchiveResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
/**
|
|
* <p>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.</p> <p>Amazon Glacier rejects your upload part
|
|
* request if any of the following conditions is true:</p> <ul> <li> <p> <b>SHA256
|
|
* tree hash does not match</b>To 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 S3 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>.</p> </li> <li> <p> <b>Part size does not match</b>The size of
|
|
* each part except the last must match the size specified in the corresponding
|
|
* <a>InitiateMultipartUpload</a> request. The size of the last part must be the
|
|
* same size as, or smaller than, the specified size.</p> <p>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.</p> </li> <li> <p> <b>Range does not align</b>The
|
|
* 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. </p> </li> </ul> <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-upload-part.html">Upload
|
|
* Part </a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/UploadMultipartPart">AWS
|
|
* API Reference</a></p>
|
|
*/
|
|
virtual Model::UploadMultipartPartOutcome UploadMultipartPart(const Model::UploadMultipartPartRequest& request) const;
|
|
|
|
/**
|
|
* <p>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.</p> <p>Amazon Glacier rejects your upload part
|
|
* request if any of the following conditions is true:</p> <ul> <li> <p> <b>SHA256
|
|
* tree hash does not match</b>To 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 S3 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>.</p> </li> <li> <p> <b>Part size does not match</b>The size of
|
|
* each part except the last must match the size specified in the corresponding
|
|
* <a>InitiateMultipartUpload</a> request. The size of the last part must be the
|
|
* same size as, or smaller than, the specified size.</p> <p>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.</p> </li> <li> <p> <b>Range does not align</b>The
|
|
* 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. </p> </li> </ul> <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-upload-part.html">Upload
|
|
* Part </a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/UploadMultipartPart">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* returns a future to the operation so that it can be executed in parallel to other requests.
|
|
*/
|
|
virtual Model::UploadMultipartPartOutcomeCallable UploadMultipartPartCallable(const Model::UploadMultipartPartRequest& request) const;
|
|
|
|
/**
|
|
* <p>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.</p> <p>Amazon Glacier rejects your upload part
|
|
* request if any of the following conditions is true:</p> <ul> <li> <p> <b>SHA256
|
|
* tree hash does not match</b>To 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 S3 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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/checksum-calculations.html">Computing
|
|
* Checksums</a>.</p> </li> <li> <p> <b>Part size does not match</b>The size of
|
|
* each part except the last must match the size specified in the corresponding
|
|
* <a>InitiateMultipartUpload</a> request. The size of the last part must be the
|
|
* same size as, or smaller than, the specified size.</p> <p>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.</p> </li> <li> <p> <b>Range does not align</b>The
|
|
* 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. </p> </li> </ul> <p>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.</p> <p>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 <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html">Access
|
|
* Control Using AWS Identity and Access Management (IAM)</a>.</p> <p> For
|
|
* conceptual information and underlying REST API, see <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/uploading-archive-mpu.html">Uploading
|
|
* Large Archives in Parts (Multipart Upload)</a> and <a
|
|
* href="https://docs.aws.amazon.com/amazonglacier/latest/dev/api-upload-part.html">Upload
|
|
* Part </a> in the <i>Amazon Glacier Developer Guide</i>.</p><p><h3>See Also:</h3>
|
|
* <a
|
|
* href="http://docs.aws.amazon.com/goto/WebAPI/glacier-2012-06-01/UploadMultipartPart">AWS
|
|
* API Reference</a></p>
|
|
*
|
|
* Queues the request into a thread executor and triggers associated callback when operation has finished.
|
|
*/
|
|
virtual void UploadMultipartPartAsync(const Model::UploadMultipartPartRequest& request, const UploadMultipartPartResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context = nullptr) const;
|
|
|
|
|
|
void OverrideEndpoint(const Aws::String& endpoint);
|
|
private:
|
|
void init(const Aws::Client::ClientConfiguration& clientConfiguration);
|
|
void AbortMultipartUploadAsyncHelper(const Model::AbortMultipartUploadRequest& request, const AbortMultipartUploadResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void AbortVaultLockAsyncHelper(const Model::AbortVaultLockRequest& request, const AbortVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void AddTagsToVaultAsyncHelper(const Model::AddTagsToVaultRequest& request, const AddTagsToVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void CompleteMultipartUploadAsyncHelper(const Model::CompleteMultipartUploadRequest& request, const CompleteMultipartUploadResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void CompleteVaultLockAsyncHelper(const Model::CompleteVaultLockRequest& request, const CompleteVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void CreateVaultAsyncHelper(const Model::CreateVaultRequest& request, const CreateVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void DeleteArchiveAsyncHelper(const Model::DeleteArchiveRequest& request, const DeleteArchiveResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void DeleteVaultAsyncHelper(const Model::DeleteVaultRequest& request, const DeleteVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void DeleteVaultAccessPolicyAsyncHelper(const Model::DeleteVaultAccessPolicyRequest& request, const DeleteVaultAccessPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void DeleteVaultNotificationsAsyncHelper(const Model::DeleteVaultNotificationsRequest& request, const DeleteVaultNotificationsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void DescribeJobAsyncHelper(const Model::DescribeJobRequest& request, const DescribeJobResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void DescribeVaultAsyncHelper(const Model::DescribeVaultRequest& request, const DescribeVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void GetDataRetrievalPolicyAsyncHelper(const Model::GetDataRetrievalPolicyRequest& request, const GetDataRetrievalPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void GetJobOutputAsyncHelper(const Model::GetJobOutputRequest& request, const GetJobOutputResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void GetVaultAccessPolicyAsyncHelper(const Model::GetVaultAccessPolicyRequest& request, const GetVaultAccessPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void GetVaultLockAsyncHelper(const Model::GetVaultLockRequest& request, const GetVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void GetVaultNotificationsAsyncHelper(const Model::GetVaultNotificationsRequest& request, const GetVaultNotificationsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void InitiateJobAsyncHelper(const Model::InitiateJobRequest& request, const InitiateJobResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void InitiateMultipartUploadAsyncHelper(const Model::InitiateMultipartUploadRequest& request, const InitiateMultipartUploadResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void InitiateVaultLockAsyncHelper(const Model::InitiateVaultLockRequest& request, const InitiateVaultLockResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void ListJobsAsyncHelper(const Model::ListJobsRequest& request, const ListJobsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void ListMultipartUploadsAsyncHelper(const Model::ListMultipartUploadsRequest& request, const ListMultipartUploadsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void ListPartsAsyncHelper(const Model::ListPartsRequest& request, const ListPartsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void ListProvisionedCapacityAsyncHelper(const Model::ListProvisionedCapacityRequest& request, const ListProvisionedCapacityResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void ListTagsForVaultAsyncHelper(const Model::ListTagsForVaultRequest& request, const ListTagsForVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void ListVaultsAsyncHelper(const Model::ListVaultsRequest& request, const ListVaultsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void PurchaseProvisionedCapacityAsyncHelper(const Model::PurchaseProvisionedCapacityRequest& request, const PurchaseProvisionedCapacityResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void RemoveTagsFromVaultAsyncHelper(const Model::RemoveTagsFromVaultRequest& request, const RemoveTagsFromVaultResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void SetDataRetrievalPolicyAsyncHelper(const Model::SetDataRetrievalPolicyRequest& request, const SetDataRetrievalPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void SetVaultAccessPolicyAsyncHelper(const Model::SetVaultAccessPolicyRequest& request, const SetVaultAccessPolicyResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void SetVaultNotificationsAsyncHelper(const Model::SetVaultNotificationsRequest& request, const SetVaultNotificationsResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void UploadArchiveAsyncHelper(const Model::UploadArchiveRequest& request, const UploadArchiveResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
void UploadMultipartPartAsyncHelper(const Model::UploadMultipartPartRequest& request, const UploadMultipartPartResponseReceivedHandler& handler, const std::shared_ptr<const Aws::Client::AsyncCallerContext>& context) const;
|
|
|
|
Aws::String m_uri;
|
|
Aws::String m_configScheme;
|
|
std::shared_ptr<Aws::Utils::Threading::Executor> m_executor;
|
|
};
|
|
|
|
} // namespace Glacier
|
|
} // namespace Aws
|