Enum CannedAccessControlList
- All Implemented Interfaces:
Serializable
,Comparable<CannedAccessControlList>
,java.lang.constant.Constable
Canned access control lists are commonly used access control lists (ACL) that can be
used as a shortcut when applying an access control list to Amazon S3 buckets
and objects. Only a few commonly used configurations are available, but they
offer an alternative to manually creating a custom ACL. If more specific
access control is desired, users can create a custom AccessControlList
.
- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class java.lang.Enum
Enum.EnumDesc<E extends Enum<E>>
-
Enum Constant Summary
Enum ConstantsEnum ConstantDescriptionSpecifies the owner is grantedPermission.FullControl
and theGroupGrantee.AuthenticatedUsers
group grantee is grantedPermission.Read
access.Specifies the owner is grantedPermission.FullControl
.Specifies the owner of the bucket, but not necessarily the same as the owner of the object, is grantedPermission.FullControl
.Specifies the owner of the bucket, but not necessarily the same as the owner of the object, is grantedPermission.Read
.Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.LogDelivery
group grantee is grantedPermission.Write
access so that access logs can be delivered.Specifies the owner is grantedPermission.FullControl
.Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.AllUsers
group grantee is grantedPermission.Read
access.Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.AllUsers
group grantee is grantedPermission.Read
andPermission.Write
access. -
Method Summary
Modifier and TypeMethodDescriptiontoString()
Returns the Amazon S3 x-amz-acl header value for this canned acl.static CannedAccessControlList
Returns the enum constant of this type with the specified name.static CannedAccessControlList[]
values()
Returns an array containing the constants of this enum type, in the order they are declared.
-
Enum Constant Details
-
Private
Specifies the owner is grantedPermission.FullControl
. No one else has access rights.This is the default access control policy for any new buckets or objects.
-
PublicRead
Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.AllUsers
group grantee is grantedPermission.Read
access.If this policy is used on an object, it can be read from a browser without authentication.
-
PublicReadWrite
Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.AllUsers
group grantee is grantedPermission.Read
andPermission.Write
access.This access policy is not recommended for general use.
-
AuthenticatedRead
Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.AuthenticatedUsers
group grantee is grantedPermission.Read
access. -
LogDeliveryWrite
Specifies the owner is grantedPermission.FullControl
and theGroupGrantee.LogDelivery
group grantee is grantedPermission.Write
access so that access logs can be delivered.Use this access policy to enable Amazon S3 bucket logging for a bucket. The destination bucket requires these permissions so that access logs can be delivered.
-
BucketOwnerRead
Specifies the owner of the bucket, but not necessarily the same as the owner of the object, is grantedPermission.Read
.Use this access policy when uploading objects to another owner's bucket. This access policy grants the bucket owner read access to the object, but does not give read access for all users.
-
BucketOwnerFullControl
Specifies the owner of the bucket, but not necessarily the same as the owner of the object, is grantedPermission.FullControl
.Use this access policy to upload objects to another owner's bucket. This access policy grants the bucket owner full access to the object, but does not give full access to all users.
-
AwsExecRead
Specifies the owner is grantedPermission.FullControl
. Amazon EC2 is grantedPermission.Read
access to GET an Amazon Machine Image (AMI) bundle from Amazon S3.
-
-
Method Details
-
values
Returns an array containing the constants of this enum type, in the order they are declared.- Returns:
- an array containing the constants of this enum type, in the order they are declared
-
valueOf
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)- Parameters:
name
- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is null
-
toString
Returns the Amazon S3 x-amz-acl header value for this canned acl.- Overrides:
toString
in classEnum<CannedAccessControlList>
-