Struct aws_sdk_s3::client::fluent_builders::PutObjectRetention [−][src]
pub struct PutObjectRetention<C = DynConnector, M = AwsMiddleware, R = Standard> { /* fields omitted */ }
Expand description
Fluent builder constructing a request to PutObjectRetention
.
Places an Object Retention configuration on an object. For more information, see Locking Objects.
Users or accounts require the s3:PutObjectRetention
permission in order to place
an Object Retention configuration on objects. Bypassing a Governance Retention configuration
requires the s3:BypassGovernanceRetention
permission.
This action is not supported by Amazon S3 on Outposts.
Permissions
When the Object Lock retention mode is set to compliance, you need s3:PutObjectRetention
and
s3:BypassGovernanceRetention
permissions. For other requests to PutObjectRetention
,
only s3:PutObjectRetention
permissions are required.
Implementations
impl<C, M, R> PutObjectRetention<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
impl<C, M, R> PutObjectRetention<C, M, R> where
C: SmithyConnector,
M: SmithyMiddleware<C>,
R: NewRequestPolicy,
pub async fn send(
self
) -> Result<PutObjectRetentionOutput, SdkError<PutObjectRetentionError>> where
R::Policy: SmithyRetryPolicy<PutObjectRetentionInputOperationOutputAlias, PutObjectRetentionOutput, PutObjectRetentionError, PutObjectRetentionInputOperationRetryAlias>,
pub async fn send(
self
) -> Result<PutObjectRetentionOutput, SdkError<PutObjectRetentionError>> where
R::Policy: SmithyRetryPolicy<PutObjectRetentionInputOperationOutputAlias, PutObjectRetentionOutput, PutObjectRetentionError, PutObjectRetentionInputOperationRetryAlias>,
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
The bucket name that contains the object you want to apply this Object Retention configuration to.
When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.
The bucket name that contains the object you want to apply this Object Retention configuration to.
When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see Using access points in the Amazon S3 User Guide.
The key name for the object that you want to apply this Object Retention configuration to.
The key name for the object that you want to apply this Object Retention configuration to.
The container element for the Object Retention configuration.
The container element for the Object Retention configuration.
Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. For information about downloading objects from requester pays buckets, see Downloading Objects in Requestor Pays Buckets in the Amazon S3 User Guide.
Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. For information about downloading objects from requester pays buckets, see Downloading Objects in Requestor Pays Buckets in the Amazon S3 User Guide.
The version ID for the object that you want to apply this Object Retention configuration to.
The version ID for the object that you want to apply this Object Retention configuration to.
Indicates whether this action should bypass Governance-mode restrictions.
Indicates whether this action should bypass Governance-mode restrictions.
The MD5 hash for the request body.
For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.
The MD5 hash for the request body.
For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.
The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied)
error.
The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied)
error.
Trait Implementations
Auto Trait Implementations
impl<C = DynConnector, M = AwsMiddleware, R = Standard> !RefUnwindSafe for PutObjectRetention<C, M, R>
impl<C, M, R> Send for PutObjectRetention<C, M, R> where
C: Send + Sync,
M: Send + Sync,
R: Send + Sync,
impl<C, M, R> Sync for PutObjectRetention<C, M, R> where
C: Send + Sync,
M: Send + Sync,
R: Send + Sync,
impl<C, M, R> Unpin for PutObjectRetention<C, M, R>
impl<C = DynConnector, M = AwsMiddleware, R = Standard> !UnwindSafe for PutObjectRetention<C, M, R>
Blanket Implementations
Mutably borrows from an owned value. Read more
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more