Enum CannedAccessControlList
- java.lang.Object
-
- java.lang.Enum<CannedAccessControlList>
-
- com.amazonaws.services.s3.model.CannedAccessControlList
-
- All Implemented Interfaces:
Serializable,Comparable<CannedAccessControlList>
public enum CannedAccessControlList extends Enum<CannedAccessControlList>
Specifies constants defining a canned access control list.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:
AccessControlList
-
-
Enum Constant Summary
Enum Constants Enum Constant Description AuthenticatedReadSpecifies the owner is grantedPermission.FullControland theGroupGrantee.AuthenticatedUsersgroup grantee is grantedPermission.Readaccess.AwsExecReadSpecifies the owner is grantedPermission.FullControl.BucketOwnerFullControlSpecifies the owner of the bucket, but not necessarily the same as the owner of the object, is grantedPermission.FullControl.BucketOwnerReadSpecifies the owner of the bucket, but not necessarily the same as the owner of the object, is grantedPermission.Read.LogDeliveryWriteSpecifies the owner is grantedPermission.FullControland theGroupGrantee.LogDeliverygroup grantee is grantedPermission.Writeaccess so that access logs can be delivered.PrivateSpecifies the owner is grantedPermission.FullControl.PublicReadSpecifies the owner is grantedPermission.FullControland theGroupGrantee.AllUsersgroup grantee is grantedPermission.Readaccess.PublicReadWriteSpecifies the owner is grantedPermission.FullControland theGroupGrantee.AllUsersgroup grantee is grantedPermission.ReadandPermission.Writeaccess.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description StringtoString()Returns the Amazon S3 x-amz-acl header value for this canned acl.static CannedAccessControlListvalueOf(String name)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 Detail
-
Private
public static final CannedAccessControlList 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
public static final CannedAccessControlList PublicRead
Specifies the owner is grantedPermission.FullControland theGroupGrantee.AllUsersgroup grantee is grantedPermission.Readaccess.If this policy is used on an object, it can be read from a browser without authentication.
-
PublicReadWrite
public static final CannedAccessControlList PublicReadWrite
Specifies the owner is grantedPermission.FullControland theGroupGrantee.AllUsersgroup grantee is grantedPermission.ReadandPermission.Writeaccess.This access policy is not recommended for general use.
-
AuthenticatedRead
public static final CannedAccessControlList AuthenticatedRead
Specifies the owner is grantedPermission.FullControland theGroupGrantee.AuthenticatedUsersgroup grantee is grantedPermission.Readaccess.
-
LogDeliveryWrite
public static final CannedAccessControlList LogDeliveryWrite
Specifies the owner is grantedPermission.FullControland theGroupGrantee.LogDeliverygroup grantee is grantedPermission.Writeaccess 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
public static final CannedAccessControlList 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
public static final CannedAccessControlList 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
public static final CannedAccessControlList AwsExecRead
Specifies the owner is grantedPermission.FullControl. Amazon EC2 is grantedPermission.Readaccess to GET an Amazon Machine Image (AMI) bundle from Amazon S3.
-
-
Method Detail
-
values
public static CannedAccessControlList[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:for (CannedAccessControlList c : CannedAccessControlList.values()) System.out.println(c);
- Returns:
- an array containing the constants of this enum type, in the order they are declared
-
valueOf
public static CannedAccessControlList valueOf(String name)
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
public String toString()
Returns the Amazon S3 x-amz-acl header value for this canned acl.- Overrides:
toStringin classEnum<CannedAccessControlList>
-
-