NAME

Paws::S3::PutBucketAcl - Arguments for method PutBucketAcl on Paws::S3

DESCRIPTION

This class represents the parameters used for calling the method PutBucketAcl on the Amazon Simple Storage Service service. Use the attributes of this class as arguments to method PutBucketAcl.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to PutBucketAcl.

SYNOPSIS

    my $s3 = Paws->service('S3');
  # Put bucket acl
  # The following example replaces existing ACL on a bucket. The ACL grants the
  # bucket owner (specified using the owner ID) and write permission to the
  # LogDelivery group. Because this is a replace operation, you must specify all
  # the grants in your request. To incrementally add or remove ACL grants, you
  # might use the console.
    $s3->PutBucketAcl(
      'Bucket'           => 'examplebucket',
      'GrantFullControl' =>
        'id=examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484',
      'GrantWrite' => 'uri=http://acs.amazonaws.com/groups/s3/LogDelivery'
    );

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/s3/PutBucketAcl

ATTRIBUTES

AccessControlPolicy => Paws::S3::AccessControlPolicy

Contains the elements that set the ACL permissions for an object per grantee.

ACL => Str

The canned ACL to apply to the bucket.

Valid values are: "private", "public-read", "public-read-write", "authenticated-read"

REQUIRED Bucket => Str

The bucket to which to apply the ACL.

ContentLength => Int

Size of the body in bytes.

ContentMD5 => Str

The base64-encoded 128-bit MD5 digest of the data. This header must be used as a message integrity check to verify that the request body was not corrupted in transit. For more information, go to RFC 1864. (http://www.ietf.org/rfc/rfc1864.txt)

For requests made using the AWS Command Line Interface (CLI) or AWS SDKs, this field is calculated automatically.

ExpectedBucketOwner => Str

The account ID of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

GrantFullControl => Str

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

GrantRead => Str

Allows grantee to list the objects in the bucket.

GrantReadACP => Str

Allows grantee to read the bucket ACL.

GrantWrite => Str

Allows grantee to create new objects in the bucket.

For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects.

GrantWriteACP => Str

Allows grantee to write the ACL for the applicable bucket.

SEE ALSO

This class forms part of Paws, documenting arguments for method PutBucketAcl in Paws::S3

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues

cpanm Paws

perl -MCPAN -e shell
install Paws