Struct aws_sdk_s3control::types::S3CopyObjectOperation
source · #[non_exhaustive]pub struct S3CopyObjectOperation {Show 18 fields
pub target_resource: Option<String>,
pub canned_access_control_list: Option<S3CannedAccessControlList>,
pub access_control_grants: Option<Vec<S3Grant>>,
pub metadata_directive: Option<S3MetadataDirective>,
pub modified_since_constraint: Option<DateTime>,
pub new_object_metadata: Option<S3ObjectMetadata>,
pub new_object_tagging: Option<Vec<S3Tag>>,
pub redirect_location: Option<String>,
pub requester_pays: bool,
pub storage_class: Option<S3StorageClass>,
pub un_modified_since_constraint: Option<DateTime>,
pub sse_aws_kms_key_id: Option<String>,
pub target_key_prefix: Option<String>,
pub object_lock_legal_hold_status: Option<S3ObjectLockLegalHoldStatus>,
pub object_lock_mode: Option<S3ObjectLockMode>,
pub object_lock_retain_until_date: Option<DateTime>,
pub bucket_key_enabled: bool,
pub checksum_algorithm: Option<S3ChecksumAlgorithm>,
}
Expand description
Contains the configuration parameters for a PUT Copy object operation. S3 Batch Operations passes every object to the underlying CopyObject
API operation. For more information about the parameters for this operation, see CopyObject.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.target_resource: Option<String>
Specifies the destination bucket Amazon Resource Name (ARN) for the batch copy operation. For example, to copy objects to a bucket named destinationBucket
, set the TargetResource
property to arn:aws:s3:::destinationBucket
.
canned_access_control_list: Option<S3CannedAccessControlList>
access_control_grants: Option<Vec<S3Grant>>
metadata_directive: Option<S3MetadataDirective>
modified_since_constraint: Option<DateTime>
new_object_metadata: Option<S3ObjectMetadata>
If you don't provide this parameter, Amazon S3 copies all the metadata from the original objects. If you specify an empty set, the new objects will have no tags. Otherwise, Amazon S3 assigns the supplied tags to the new objects.
new_object_tagging: Option<Vec<S3Tag>>
redirect_location: Option<String>
Specifies an optional metadata property for website redirects, x-amz-website-redirect-location
. Allows webpage redirects if the object is accessed through a website endpoint.
requester_pays: bool
storage_class: Option<S3StorageClass>
un_modified_since_constraint: Option<DateTime>
sse_aws_kms_key_id: Option<String>
target_key_prefix: Option<String>
Specifies the folder prefix that you want the objects to be copied into. For example, to copy objects into a folder named Folder1
in the destination bucket, set the TargetKeyPrefix
property to Folder1
.
object_lock_legal_hold_status: Option<S3ObjectLockLegalHoldStatus>
The legal hold status to be applied to all objects in the Batch Operations job.
object_lock_mode: Option<S3ObjectLockMode>
The retention mode to be applied to all objects in the Batch Operations job.
object_lock_retain_until_date: Option<DateTime>
The date when the applied object retention configuration expires on all objects in the Batch Operations job.
bucket_key_enabled: bool
Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption with server-side encryption using Amazon Web Services KMS (SSE-KMS). Setting this header to true
causes Amazon S3 to use an S3 Bucket Key for object encryption with SSE-KMS.
Specifying this header with an object action doesn’t affect bucket-level settings for S3 Bucket Key.
checksum_algorithm: Option<S3ChecksumAlgorithm>
Indicates the algorithm that you want Amazon S3 to use to create the checksum. For more information, see Checking object integrity in the Amazon S3 User Guide.
Implementations§
source§impl S3CopyObjectOperation
impl S3CopyObjectOperation
sourcepub fn target_resource(&self) -> Option<&str>
pub fn target_resource(&self) -> Option<&str>
Specifies the destination bucket Amazon Resource Name (ARN) for the batch copy operation. For example, to copy objects to a bucket named destinationBucket
, set the TargetResource
property to arn:aws:s3:::destinationBucket
.
sourcepub fn canned_access_control_list(&self) -> Option<&S3CannedAccessControlList>
pub fn canned_access_control_list(&self) -> Option<&S3CannedAccessControlList>
sourcepub fn access_control_grants(&self) -> &[S3Grant]
pub fn access_control_grants(&self) -> &[S3Grant]
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .access_control_grants.is_none()
.
sourcepub fn metadata_directive(&self) -> Option<&S3MetadataDirective>
pub fn metadata_directive(&self) -> Option<&S3MetadataDirective>
sourcepub fn modified_since_constraint(&self) -> Option<&DateTime>
pub fn modified_since_constraint(&self) -> Option<&DateTime>
sourcepub fn new_object_metadata(&self) -> Option<&S3ObjectMetadata>
pub fn new_object_metadata(&self) -> Option<&S3ObjectMetadata>
If you don't provide this parameter, Amazon S3 copies all the metadata from the original objects. If you specify an empty set, the new objects will have no tags. Otherwise, Amazon S3 assigns the supplied tags to the new objects.
sourcepub fn new_object_tagging(&self) -> &[S3Tag]
pub fn new_object_tagging(&self) -> &[S3Tag]
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .new_object_tagging.is_none()
.
sourcepub fn redirect_location(&self) -> Option<&str>
pub fn redirect_location(&self) -> Option<&str>
Specifies an optional metadata property for website redirects, x-amz-website-redirect-location
. Allows webpage redirects if the object is accessed through a website endpoint.
sourcepub fn requester_pays(&self) -> bool
pub fn requester_pays(&self) -> bool
sourcepub fn storage_class(&self) -> Option<&S3StorageClass>
pub fn storage_class(&self) -> Option<&S3StorageClass>
sourcepub fn un_modified_since_constraint(&self) -> Option<&DateTime>
pub fn un_modified_since_constraint(&self) -> Option<&DateTime>
sourcepub fn sse_aws_kms_key_id(&self) -> Option<&str>
pub fn sse_aws_kms_key_id(&self) -> Option<&str>
sourcepub fn target_key_prefix(&self) -> Option<&str>
pub fn target_key_prefix(&self) -> Option<&str>
Specifies the folder prefix that you want the objects to be copied into. For example, to copy objects into a folder named Folder1
in the destination bucket, set the TargetKeyPrefix
property to Folder1
.
sourcepub fn object_lock_legal_hold_status(
&self
) -> Option<&S3ObjectLockLegalHoldStatus>
pub fn object_lock_legal_hold_status( &self ) -> Option<&S3ObjectLockLegalHoldStatus>
The legal hold status to be applied to all objects in the Batch Operations job.
sourcepub fn object_lock_mode(&self) -> Option<&S3ObjectLockMode>
pub fn object_lock_mode(&self) -> Option<&S3ObjectLockMode>
The retention mode to be applied to all objects in the Batch Operations job.
sourcepub fn object_lock_retain_until_date(&self) -> Option<&DateTime>
pub fn object_lock_retain_until_date(&self) -> Option<&DateTime>
The date when the applied object retention configuration expires on all objects in the Batch Operations job.
sourcepub fn bucket_key_enabled(&self) -> bool
pub fn bucket_key_enabled(&self) -> bool
Specifies whether Amazon S3 should use an S3 Bucket Key for object encryption with server-side encryption using Amazon Web Services KMS (SSE-KMS). Setting this header to true
causes Amazon S3 to use an S3 Bucket Key for object encryption with SSE-KMS.
Specifying this header with an object action doesn’t affect bucket-level settings for S3 Bucket Key.
sourcepub fn checksum_algorithm(&self) -> Option<&S3ChecksumAlgorithm>
pub fn checksum_algorithm(&self) -> Option<&S3ChecksumAlgorithm>
Indicates the algorithm that you want Amazon S3 to use to create the checksum. For more information, see Checking object integrity in the Amazon S3 User Guide.
source§impl S3CopyObjectOperation
impl S3CopyObjectOperation
sourcepub fn builder() -> S3CopyObjectOperationBuilder
pub fn builder() -> S3CopyObjectOperationBuilder
Creates a new builder-style object to manufacture S3CopyObjectOperation
.
Trait Implementations§
source§impl Clone for S3CopyObjectOperation
impl Clone for S3CopyObjectOperation
source§fn clone(&self) -> S3CopyObjectOperation
fn clone(&self) -> S3CopyObjectOperation
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for S3CopyObjectOperation
impl Debug for S3CopyObjectOperation
source§impl PartialEq for S3CopyObjectOperation
impl PartialEq for S3CopyObjectOperation
source§fn eq(&self, other: &S3CopyObjectOperation) -> bool
fn eq(&self, other: &S3CopyObjectOperation) -> bool
self
and other
values to be equal, and is used
by ==
.