Class EmailAddressGrantee

  • All Implemented Interfaces:
    Grantee, Serializable

    public class EmailAddressGrantee
    extends Object
    implements Grantee, Serializable
    Represents an e-mail grantee. An e-mail grantee is a grantee identified by their e-mail address and authenticated by an Amazon system.

    E-mail grants are internally converted to the canonical user representation when creating the ACL. If the grantee changes their e-mail address, it will not affect existing Amazon S3 permissions.

    Adding a grantee by e-mail address only works if exactly one Amazon account corresponds to the specified e-mail address. If multiple Amazon accounts are associated with the e-mail address, an AmbiguousGrantByEmail error message is returned. This happens rarely, but usually occurs if a user created an Amazon account in the past, forgotten the password, and created another Amazon account using the same e-mail address. If this occurs, the user should contact Amazon customer service to have the accounts merged. Alernatively, grant user access specifying the canonical user representation.

    See Also:
    EmailAddressGrantee(String), Serialized Form
    • Constructor Detail

      • EmailAddressGrantee

        public EmailAddressGrantee​(String emailAddress)
        Constructs a new EmailAddressGrantee object with the given email address.
        Parameters:
        emailAddress - The e-mail address used to identify the e-mail grantee.
    • Method Detail

      • getTypeIdentifier

        public String getTypeIdentifier()
        Description copied from interface: Grantee
        Returns the identifier for the type of this grant, to be used when specifying grants in the header of a request.
        Specified by:
        getTypeIdentifier in interface Grantee
      • setIdentifier

        public void setIdentifier​(String emailAddress)
        Set the e-mail address as the grantee's ID.
        Specified by:
        setIdentifier in interface Grantee
        Parameters:
        emailAddress - The e-mail address used to identify the e-mail grantee.
        See Also:
        getIdentifier()
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object