/** * 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/Delete.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 DeleteObjectsRequest : public S3Request { public: DeleteObjectsRequest(); // 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 "DeleteObjects"; } 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 containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline const Aws::String& GetBucket() const{ return m_bucket; } /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline bool BucketHasBeenSet() const { return m_bucketHasBeenSet; } /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline void SetBucket(const Aws::String& value) { m_bucketHasBeenSet = true; m_bucket = value; } /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline void SetBucket(Aws::String&& value) { m_bucketHasBeenSet = true; m_bucket = std::move(value); } /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline void SetBucket(const char* value) { m_bucketHasBeenSet = true; m_bucket.assign(value); } /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline DeleteObjectsRequest& WithBucket(const Aws::String& value) { SetBucket(value); return *this;} /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline DeleteObjectsRequest& WithBucket(Aws::String&& value) { SetBucket(std::move(value)); return *this;} /** * <p>The bucket name containing the objects to delete. </p> <p>When using this * action 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 action with 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/userguide/using-access-points.html">Using * Access Points</a> in the <i>Amazon S3 User Guide</i>.</p> <p>When using this * action with Amazon S3 on Outposts, you must direct requests to the S3 on * Outposts hostname. The S3 on Outposts hostname takes the form * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com. * When using this action using S3 on Outposts through the AWS SDKs, you provide * the Outposts bucket ARN in place of the bucket name. For more information about * S3 on Outposts ARNs, see <a * href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">Using * S3 on Outposts</a> in the <i>Amazon S3 User Guide</i>.</p> */ inline DeleteObjectsRequest& WithBucket(const char* value) { SetBucket(value); return *this;} /** * <p>Container for the request.</p> */ inline const Delete& GetDelete() const{ return m_delete; } /** * <p>Container for the request.</p> */ inline bool DeleteHasBeenSet() const { return m_deleteHasBeenSet; } /** * <p>Container for the request.</p> */ inline void SetDelete(const Delete& value) { m_deleteHasBeenSet = true; m_delete = value; } /** * <p>Container for the request.</p> */ inline void SetDelete(Delete&& value) { m_deleteHasBeenSet = true; m_delete = std::move(value); } /** * <p>Container for the request.</p> */ inline DeleteObjectsRequest& WithDelete(const Delete& value) { SetDelete(value); return *this;} /** * <p>Container for the request.</p> */ inline DeleteObjectsRequest& WithDelete(Delete&& value) { SetDelete(std::move(value)); return *this;} /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline const Aws::String& GetMFA() const{ return m_mFA; } /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline bool MFAHasBeenSet() const { return m_mFAHasBeenSet; } /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline void SetMFA(const Aws::String& value) { m_mFAHasBeenSet = true; m_mFA = value; } /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline void SetMFA(Aws::String&& value) { m_mFAHasBeenSet = true; m_mFA = std::move(value); } /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline void SetMFA(const char* value) { m_mFAHasBeenSet = true; m_mFA.assign(value); } /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline DeleteObjectsRequest& WithMFA(const Aws::String& value) { SetMFA(value); return *this;} /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline DeleteObjectsRequest& WithMFA(Aws::String&& value) { SetMFA(std::move(value)); return *this;} /** * <p>The concatenation of the authentication device's serial number, a space, and * the value that is displayed on your authentication device. Required to * permanently delete a versioned object if versioning is configured with MFA * delete enabled.</p> */ inline DeleteObjectsRequest& WithMFA(const char* value) { SetMFA(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 DeleteObjectsRequest& WithRequestPayer(const RequestPayer& value) { SetRequestPayer(value); return *this;} inline DeleteObjectsRequest& WithRequestPayer(RequestPayer&& value) { SetRequestPayer(std::move(value)); return *this;} /** * <p>Specifies whether you want to delete this object even if it has a * Governance-type Object Lock in place. You must have sufficient permissions to * perform this operation.</p> */ inline bool GetBypassGovernanceRetention() const{ return m_bypassGovernanceRetention; } /** * <p>Specifies whether you want to delete this object even if it has a * Governance-type Object Lock in place. You must have sufficient permissions to * perform this operation.</p> */ inline bool BypassGovernanceRetentionHasBeenSet() const { return m_bypassGovernanceRetentionHasBeenSet; } /** * <p>Specifies whether you want to delete this object even if it has a * Governance-type Object Lock in place. You must have sufficient permissions to * perform this operation.</p> */ inline void SetBypassGovernanceRetention(bool value) { m_bypassGovernanceRetentionHasBeenSet = true; m_bypassGovernanceRetention = value; } /** * <p>Specifies whether you want to delete this object even if it has a * Governance-type Object Lock in place. You must have sufficient permissions to * perform this operation.</p> */ inline DeleteObjectsRequest& WithBypassGovernanceRetention(bool value) { SetBypassGovernanceRetention(value); return *this;} /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline const Aws::String& GetExpectedBucketOwner() const{ return m_expectedBucketOwner; } /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline bool ExpectedBucketOwnerHasBeenSet() const { return m_expectedBucketOwnerHasBeenSet; } /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline void SetExpectedBucketOwner(const Aws::String& value) { m_expectedBucketOwnerHasBeenSet = true; m_expectedBucketOwner = value; } /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline void SetExpectedBucketOwner(Aws::String&& value) { m_expectedBucketOwnerHasBeenSet = true; m_expectedBucketOwner = std::move(value); } /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline void SetExpectedBucketOwner(const char* value) { m_expectedBucketOwnerHasBeenSet = true; m_expectedBucketOwner.assign(value); } /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline DeleteObjectsRequest& WithExpectedBucketOwner(const Aws::String& value) { SetExpectedBucketOwner(value); return *this;} /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline DeleteObjectsRequest& WithExpectedBucketOwner(Aws::String&& value) { SetExpectedBucketOwner(std::move(value)); return *this;} /** * <p>The account ID of the expected bucket owner. If the bucket is owned by a * different account, the request will fail with an HTTP <code>403 (Access * Denied)</code> error.</p> */ inline DeleteObjectsRequest& WithExpectedBucketOwner(const char* value) { SetExpectedBucketOwner(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 DeleteObjectsRequest& WithCustomizedAccessLogTag(const Aws::Map<Aws::String, Aws::String>& value) { SetCustomizedAccessLogTag(value); return *this;} inline DeleteObjectsRequest& WithCustomizedAccessLogTag(Aws::Map<Aws::String, Aws::String>&& value) { SetCustomizedAccessLogTag(std::move(value)); return *this;} inline DeleteObjectsRequest& AddCustomizedAccessLogTag(const Aws::String& key, const Aws::String& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, value); return *this; } inline DeleteObjectsRequest& AddCustomizedAccessLogTag(Aws::String&& key, const Aws::String& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(std::move(key), value); return *this; } inline DeleteObjectsRequest& AddCustomizedAccessLogTag(const Aws::String& key, Aws::String&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, std::move(value)); return *this; } inline DeleteObjectsRequest& AddCustomizedAccessLogTag(Aws::String&& key, Aws::String&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(std::move(key), std::move(value)); return *this; } inline DeleteObjectsRequest& AddCustomizedAccessLogTag(const char* key, Aws::String&& value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(key, std::move(value)); return *this; } inline DeleteObjectsRequest& AddCustomizedAccessLogTag(Aws::String&& key, const char* value) { m_customizedAccessLogTagHasBeenSet = true; m_customizedAccessLogTag.emplace(std::move(key), value); return *this; } inline DeleteObjectsRequest& 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; Delete m_delete; bool m_deleteHasBeenSet; Aws::String m_mFA; bool m_mFAHasBeenSet; RequestPayer m_requestPayer; bool m_requestPayerHasBeenSet; bool m_bypassGovernanceRetention; bool m_bypassGovernanceRetentionHasBeenSet; Aws::String m_expectedBucketOwner; bool m_expectedBucketOwnerHasBeenSet; Aws::Map<Aws::String, Aws::String> m_customizedAccessLogTag; bool m_customizedAccessLogTagHasBeenSet; }; } // namespace Model } // namespace S3 } // namespace Aws