Enum aws_sdk_s3::types::ObjectOwnership
source · #[non_exhaustive]pub enum ObjectOwnership {
BucketOwnerEnforced,
BucketOwnerPreferred,
ObjectWriter,
Unknown(UnknownVariantValue),
}
Expand description
When writing a match expression against ObjectOwnership
, it is important to ensure
your code is forward-compatible. That is, if a match arm handles a case for a
feature that is supported by the service but has not been represented as an enum
variant in a current version of SDK, your code should continue to work when you
upgrade SDK to a future version in which the enum does include a variant for that
feature.
Here is an example of how you can make a match expression forward-compatible:
# let objectownership = unimplemented!();
match objectownership {
ObjectOwnership::BucketOwnerEnforced => { /* ... */ },
ObjectOwnership::BucketOwnerPreferred => { /* ... */ },
ObjectOwnership::ObjectWriter => { /* ... */ },
other @ _ if other.as_str() == "NewFeature" => { /* handles a case for `NewFeature` */ },
_ => { /* ... */ },
}
The above code demonstrates that when objectownership
represents
NewFeature
, the execution path will lead to the second last match arm,
even though the enum does not contain a variant ObjectOwnership::NewFeature
in the current version of SDK. The reason is that the variable other
,
created by the @
operator, is bound to
ObjectOwnership::Unknown(UnknownVariantValue("NewFeature".to_owned()))
and calling as_str
on it yields "NewFeature"
.
This match expression is forward-compatible when executed with a newer
version of SDK where the variant ObjectOwnership::NewFeature
is defined.
Specifically, when objectownership
represents NewFeature
,
the execution path will hit the second last match arm as before by virtue of
calling as_str
on ObjectOwnership::NewFeature
also yielding "NewFeature"
.
Explicitly matching on the Unknown
variant should
be avoided for two reasons:
- The inner data
UnknownVariantValue
is opaque, and no further information can be extracted. - It might inadvertently shadow other intended match arms.
The container element for object ownership for a bucket's ownership controls.
BucketOwnerPreferred
- Objects uploaded to the bucket change ownership to the bucket
owner if the objects are uploaded with the bucket-owner-full-control
canned
ACL.
ObjectWriter
- The uploading account will own the object if the object is uploaded with
the bucket-owner-full-control
canned ACL.
BucketOwnerEnforced
- Access control lists (ACLs) are disabled and no longer affect
permissions. The bucket owner automatically owns and has full control over every object in
the bucket. The bucket only accepts PUT requests that don't specify an ACL or specify bucket owner
full control ACLs (such as the predefined bucket-owner-full-control
canned ACL or a custom ACL
in XML format that grants the same permissions).
By default, ObjectOwnership
is set to BucketOwnerEnforced
and ACLs are disabled. We recommend
keeping ACLs disabled, except in uncommon use cases where you must control access for each object individually. For more information about S3 Object Ownership, see
Controlling ownership of objects and disabling ACLs for your bucket in the Amazon S3 User Guide.
This functionality is not supported for directory buckets. Directory buckets use the bucket owner enforced setting for S3 Object Ownership.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
BucketOwnerEnforced
BucketOwnerPreferred
ObjectWriter
Unknown(UnknownVariantValue)
Unknown
. See the docs on this enum for the correct way to handle unknown variants.Unknown
contains new variants that have been added since this code was generated.
Implementations§
source§impl ObjectOwnership
impl ObjectOwnership
sourcepub fn try_parse(value: &str) -> Result<Self, UnknownVariantError>
pub fn try_parse(value: &str) -> Result<Self, UnknownVariantError>
Parses the enum value while disallowing unknown variants.
Unknown variants will result in an error.
Trait Implementations§
source§impl AsRef<str> for ObjectOwnership
impl AsRef<str> for ObjectOwnership
source§impl Clone for ObjectOwnership
impl Clone for ObjectOwnership
source§fn clone(&self) -> ObjectOwnership
fn clone(&self) -> ObjectOwnership
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for ObjectOwnership
impl Debug for ObjectOwnership
source§impl Display for ObjectOwnership
impl Display for ObjectOwnership
source§impl From<&str> for ObjectOwnership
impl From<&str> for ObjectOwnership
source§impl FromStr for ObjectOwnership
impl FromStr for ObjectOwnership
source§impl Hash for ObjectOwnership
impl Hash for ObjectOwnership
source§impl Ord for ObjectOwnership
impl Ord for ObjectOwnership
source§fn cmp(&self, other: &ObjectOwnership) -> Ordering
fn cmp(&self, other: &ObjectOwnership) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
source§impl PartialEq for ObjectOwnership
impl PartialEq for ObjectOwnership
source§impl PartialOrd for ObjectOwnership
impl PartialOrd for ObjectOwnership
impl Eq for ObjectOwnership
impl StructuralPartialEq for ObjectOwnership
Auto Trait Implementations§
impl Freeze for ObjectOwnership
impl RefUnwindSafe for ObjectOwnership
impl Send for ObjectOwnership
impl Sync for ObjectOwnership
impl Unpin for ObjectOwnership
impl UnwindSafe for ObjectOwnership
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.