408 lines
18 KiB
C++
408 lines
18 KiB
C++
/**
|
|
* Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
|
* SPDX-License-Identifier: Apache-2.0.
|
|
*/
|
|
|
|
#pragma once
|
|
#include <aws/s3/S3_EXPORTS.h>
|
|
#include <aws/s3/S3Request.h>
|
|
#include <aws/core/utils/memory/stl/AWSString.h>
|
|
#include <aws/s3/model/ObjectLockRetention.h>
|
|
#include <aws/s3/model/RequestPayer.h>
|
|
#include <aws/core/utils/memory/stl/AWSMap.h>
|
|
#include <utility>
|
|
|
|
namespace Aws
|
|
{
|
|
namespace Http
|
|
{
|
|
class URI;
|
|
} //namespace Http
|
|
namespace S3
|
|
{
|
|
namespace Model
|
|
{
|
|
|
|
/**
|
|
*/
|
|
class AWS_S3_API PutObjectRetentionRequest : public S3Request
|
|
{
|
|
public:
|
|
PutObjectRetentionRequest();
|
|
|
|
// Service request name is the Operation name which will send this request out,
|
|
// each operation should has unique request name, so that we can get operation's name from this request.
|
|
// Note: this is not true for response, multiple operations may have the same response name,
|
|
// so we can not get operation's name from response.
|
|
inline virtual const char* GetServiceRequestName() const override { return "PutObjectRetention"; }
|
|
|
|
Aws::String SerializePayload() const override;
|
|
|
|
void AddQueryStringParameters(Aws::Http::URI& uri) const override;
|
|
|
|
Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override;
|
|
|
|
inline bool ShouldComputeContentMd5() const override { return true; }
|
|
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline const Aws::String& GetBucket() const{ return m_bucket; }
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline bool BucketHasBeenSet() const { return m_bucketHasBeenSet; }
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline void SetBucket(const Aws::String& value) { m_bucketHasBeenSet = true; m_bucket = value; }
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline void SetBucket(Aws::String&& value) { m_bucketHasBeenSet = true; m_bucket = std::move(value); }
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline void SetBucket(const char* value) { m_bucketHasBeenSet = true; m_bucket.assign(value); }
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithBucket(const Aws::String& value) { SetBucket(value); return *this;}
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithBucket(Aws::String&& value) { SetBucket(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>The bucket name that contains the object you want to apply this Object
|
|
* Retention configuration to. </p> <p>When using this API with an access point,
|
|
* you must direct requests to the access point hostname. The access point hostname
|
|
* takes the form
|
|
* <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
|
|
* When using this operation using an access point through the AWS SDKs, you
|
|
* provide the access point ARN in place of the bucket name. For more information
|
|
* about access point ARNs, see <a
|
|
* href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html">Using
|
|
* Access Points</a> in the <i>Amazon Simple Storage Service Developer
|
|
* Guide</i>.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithBucket(const char* value) { SetBucket(value); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline const Aws::String& GetKey() const{ return m_key; }
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline bool KeyHasBeenSet() const { return m_keyHasBeenSet; }
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline void SetKey(const Aws::String& value) { m_keyHasBeenSet = true; m_key = value; }
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline void SetKey(Aws::String&& value) { m_keyHasBeenSet = true; m_key = std::move(value); }
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline void SetKey(const char* value) { m_keyHasBeenSet = true; m_key.assign(value); }
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithKey(const Aws::String& value) { SetKey(value); return *this;}
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithKey(Aws::String&& value) { SetKey(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>The key name for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithKey(const char* value) { SetKey(value); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>The container element for the Object Retention configuration.</p>
|
|
*/
|
|
inline const ObjectLockRetention& GetRetention() const{ return m_retention; }
|
|
|
|
/**
|
|
* <p>The container element for the Object Retention configuration.</p>
|
|
*/
|
|
inline bool RetentionHasBeenSet() const { return m_retentionHasBeenSet; }
|
|
|
|
/**
|
|
* <p>The container element for the Object Retention configuration.</p>
|
|
*/
|
|
inline void SetRetention(const ObjectLockRetention& value) { m_retentionHasBeenSet = true; m_retention = value; }
|
|
|
|
/**
|
|
* <p>The container element for the Object Retention configuration.</p>
|
|
*/
|
|
inline void SetRetention(ObjectLockRetention&& value) { m_retentionHasBeenSet = true; m_retention = std::move(value); }
|
|
|
|
/**
|
|
* <p>The container element for the Object Retention configuration.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithRetention(const ObjectLockRetention& value) { SetRetention(value); return *this;}
|
|
|
|
/**
|
|
* <p>The container element for the Object Retention configuration.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithRetention(ObjectLockRetention&& value) { SetRetention(std::move(value)); return *this;}
|
|
|
|
|
|
|
|
inline const RequestPayer& GetRequestPayer() const{ return m_requestPayer; }
|
|
|
|
|
|
inline bool RequestPayerHasBeenSet() const { return m_requestPayerHasBeenSet; }
|
|
|
|
|
|
inline void SetRequestPayer(const RequestPayer& value) { m_requestPayerHasBeenSet = true; m_requestPayer = value; }
|
|
|
|
|
|
inline void SetRequestPayer(RequestPayer&& value) { m_requestPayerHasBeenSet = true; m_requestPayer = std::move(value); }
|
|
|
|
|
|
inline PutObjectRetentionRequest& WithRequestPayer(const RequestPayer& value) { SetRequestPayer(value); return *this;}
|
|
|
|
|
|
inline PutObjectRetentionRequest& WithRequestPayer(RequestPayer&& value) { SetRequestPayer(std::move(value)); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline const Aws::String& GetVersionId() const{ return m_versionId; }
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline bool VersionIdHasBeenSet() const { return m_versionIdHasBeenSet; }
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline void SetVersionId(const Aws::String& value) { m_versionIdHasBeenSet = true; m_versionId = value; }
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline void SetVersionId(Aws::String&& value) { m_versionIdHasBeenSet = true; m_versionId = std::move(value); }
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline void SetVersionId(const char* value) { m_versionIdHasBeenSet = true; m_versionId.assign(value); }
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithVersionId(const Aws::String& value) { SetVersionId(value); return *this;}
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithVersionId(Aws::String&& value) { SetVersionId(std::move(value)); return *this;}
|
|
|
|
/**
|
|
* <p>The version ID for the object that you want to apply this Object Retention
|
|
* configuration to.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithVersionId(const char* value) { SetVersionId(value); return *this;}
|
|
|
|
|
|
/**
|
|
* <p>Indicates whether this operation should bypass Governance-mode
|
|
* restrictions.</p>
|
|
*/
|
|
inline bool GetBypassGovernanceRetention() const{ return m_bypassGovernanceRetention; }
|
|
|
|
/**
|
|
* <p>Indicates whether this operation should bypass Governance-mode
|
|
* restrictions.</p>
|
|
*/
|
|
inline bool BypassGovernanceRetentionHasBeenSet() const { return m_bypassGovernanceRetentionHasBeenSet; }
|
|
|
|
/**
|
|
* <p>Indicates whether this operation should bypass Governance-mode
|
|
* restrictions.</p>
|
|
*/
|
|
inline void SetBypassGovernanceRetention(bool value) { m_bypassGovernanceRetentionHasBeenSet = true; m_bypassGovernanceRetention = value; }
|
|
|
|
/**
|
|
* <p>Indicates whether this operation should bypass Governance-mode
|
|
* restrictions.</p>
|
|
*/
|
|
inline PutObjectRetentionRequest& WithBypassGovernanceRetention(bool value) { SetBypassGovernanceRetention(value); return *this;}
|
|
|
|
|
|
|
|
inline const Aws::Map<Aws::String, Aws::String>& GetCustomizedAccessLogTag() const{ return m_customizedAccessLogTag; }
|
|
|
|
|
|
inline bool CustomizedAccessLogTagHasBeenSet() const { return m_customizedAccessLogTagHasBeenSet; }
|
|
|
|
|
|
inline void SetCustomizedAccessLogTag(const Aws::Map<Aws::String, Aws::String>& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag = value; }
|
|
|
|
|
|
inline void SetCustomizedAccessLogTag(Aws::Map<Aws::String, Aws::String>&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag = std::move(value); }
|
|
|
|
|
|
inline PutObjectRetentionRequest& WithCustomizedAccessLogTag(const Aws::Map<Aws::String, Aws::String>& value) { SetCustomizedAccessLogTag(value); return *this;}
|
|
|
|
|
|
inline PutObjectRetentionRequest& WithCustomizedAccessLogTag(Aws::Map<Aws::String, Aws::String>&& value) { SetCustomizedAccessLogTag(std::move(value)); return *this;}
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(const Aws::String& key, const Aws::String& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, value); return *this; }
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(Aws::String&& key, const Aws::String& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(std::move(key), value); return *this; }
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(const Aws::String& key, Aws::String&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, std::move(value)); return *this; }
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(Aws::String&& key, Aws::String&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(std::move(key), std::move(value)); return *this; }
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(const char* key, Aws::String&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, std::move(value)); return *this; }
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(Aws::String&& key, const char* value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(std::move(key), value); return *this; }
|
|
|
|
|
|
inline PutObjectRetentionRequest& AddCustomizedAccessLogTag(const char* key, const char* value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, value); return *this; }
|
|
|
|
private:
|
|
|
|
Aws::String m_bucket;
|
|
bool m_bucketHasBeenSet;
|
|
|
|
Aws::String m_key;
|
|
bool m_keyHasBeenSet;
|
|
|
|
ObjectLockRetention m_retention;
|
|
bool m_retentionHasBeenSet;
|
|
|
|
RequestPayer m_requestPayer;
|
|
bool m_requestPayerHasBeenSet;
|
|
|
|
Aws::String m_versionId;
|
|
bool m_versionIdHasBeenSet;
|
|
|
|
bool m_bypassGovernanceRetention;
|
|
bool m_bypassGovernanceRetentionHasBeenSet;
|
|
|
|
Aws::Map<Aws::String, Aws::String> m_customizedAccessLogTag;
|
|
bool m_customizedAccessLogTagHasBeenSet;
|
|
};
|
|
|
|
} // namespace Model
|
|
} // namespace S3
|
|
} // namespace Aws
|