The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

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

DESCRIPTION

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

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

SYNOPSIS

    my $s3 = Paws->service('S3');
   # To create a bucket in a specific region
   # The following example creates a bucket. The request specifies an AWS region
   # where to create the bucket.
    my $CreateBucketOutput = $s3->CreateBucket(
      'Bucket'                    => 'examplebucket',
      'CreateBucketConfiguration' => {
        'LocationConstraint' => 'eu-west-1'
      }
    );

    # Results:
    my $Location = $CreateBucketOutput->Location;

    # Returns a L<Paws::S3::CreateBucketOutput> object.
    # To create a bucket
    # The following example creates a bucket.
    my $CreateBucketOutput = $s3->CreateBucket( 'Bucket' => 'examplebucket' );

    # Results:
    my $Location = $CreateBucketOutput->Location;

    # Returns a L<Paws::S3::CreateBucketOutput> object.

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/CreateBucket

ATTRIBUTES

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 name of the bucket to create.

ContentLength => Int

Size of the body in bytes.

CreateBucketConfiguration => Paws::S3::CreateBucketConfiguration

The configuration information for the bucket.

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.

ObjectLockEnabledForBucket => Bool

Specifies whether you want S3 Object Lock to be enabled for the new bucket.

SEE ALSO

This class forms part of Paws, documenting arguments for method CreateBucket 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