---
name: "Net::Amazon::S3::ACL::Set"
section: "3pm"
platform: "linux"
package: "libnet-amazon-s3-perl"
version: "0.991-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Amazon::S3::ACL::Set"
---

# Net::Amazon::S3::ACL::Set(3pm)

Representation of explicit ACL

## NAME

Net::Amazon::S3::ACL::Set - Representation of explicit ACL

## VERSION

version 0.991

## SYNOPSIS

```
        use Net::Amazon::S3::ACL;
        $acl = Net::Amazon::S3::ACL->new
                ->grant_full_control (
                        id => 11112222333,
                        id => 444455556666,
                        uri => 'predefined group uri',
                        email => 'email-address',
                )
                ->grant_write (
                        ...
                )
                ;
```

## DESCRIPTION

Class representing explicit Amazon S3 ACL configuration.

## METHODS

### new

Creates new instance.

### grant\_full\_control (@grantees)

### grant\_read (@grantees)

### grant\_read\_acp (@grantees)

### grant\_write (@grantees)

### grant\_write\_acp (@grantees)

## GRANTEES

See also "Who Is a Grantee?" \<https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#specifying-grantee\> in Amazon S3 documentation.

Each grant\_\* method accepts list of grantees either in key-value format or as an instance of `"Net::Amazon::S3::ACL::Grantee::*"`.

- canonical user ID

  ```
          ->grant_read (
                  id => 123,
                  Net::Amazon::S3::ACL::Grantee::User->new (123),
          )
  ```

- predefined group uri

  ```
          ->grant_read (
                  uri => 'http://...',
                  Net::Amazon::S3::ACL::Grantee::Group->new ('http://...'),
                  Net::Amazon::S3::ACL::Grantee::Group->ALL_USERS,
          )
  ```

- email address

  ```
          ->grant_read (
                  email => 'foo@bar.baz',
                  Net::Amazon::S3::ACL::Grantee::Email->new ('foo@bar.baz'),
          );
  ```

## AUTHOR

Branislav Zahradník \<barney@cpan.org\>

## COPYRIGHT AND LICENSE

This module is part of Net::Amazon::S3.

## AUTHOR

Branislav Zahradník \<barney@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by Amazon Digital Services, Leon Brocard, Brad Fitzpatrick, Pedro Figueiredo, Rusty Conover, Branislav Zahradník.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.