NAME
Paws::S3Control::CreateBucket - Arguments for method CreateBucket on Paws::S3Control
DESCRIPTION
This class represents the parameters used for calling the method CreateBucket on the AWS S3 Control 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-control = Paws->service('S3Control');
my $CreateBucketResult = $s3 -control->CreateBucket(
Bucket => 'MyBucketName',
ACL => 'private', # OPTIONAL
CreateBucketConfiguration => {
LocationConstraint => 'EU'
, # values: EU, eu-west-1, us-west-1, us-west-2, ap-south-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, sa-east-1, cn-north-1, eu-central-1; OPTIONAL
}, # OPTIONAL
GrantFullControl => 'MyGrantFullControl', # OPTIONAL
GrantRead => 'MyGrantRead', # OPTIONAL
GrantReadACP => 'MyGrantReadACP', # OPTIONAL
GrantWrite => 'MyGrantWrite', # OPTIONAL
GrantWriteACP => 'MyGrantWriteACP', # OPTIONAL
ObjectLockEnabledForBucket => 1, # OPTIONAL
OutpostId => 'MyNonEmptyMaxLength64String', # OPTIONAL
);
# Results:
my $BucketArn = $CreateBucketResult->BucketArn;
my $Location = $CreateBucketResult->Location;
# Returns a L<Paws::S3Control::CreateBucketResult> 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-control/CreateBucket
ATTRIBUTES
ACL => Str
The canned ACL to apply to the bucket.
This is not supported by Amazon S3 on Outposts buckets.
Valid values are: "private"
, "public-read"
, "public-read-write"
, "authenticated-read"
REQUIRED Bucket => Str
The name of the bucket.
CreateBucketConfiguration => Paws::S3Control::CreateBucketConfiguration
The configuration information for the bucket.
This is not supported by Amazon S3 on Outposts buckets.
GrantFullControl => Str
Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.
This is not supported by Amazon S3 on Outposts buckets.
GrantRead => Str
Allows grantee to list the objects in the bucket.
This is not supported by Amazon S3 on Outposts buckets.
GrantReadACP => Str
Allows grantee to read the bucket ACL.
This is not supported by Amazon S3 on Outposts buckets.
GrantWrite => Str
Allows grantee to create, overwrite, and delete any object in the bucket.
This is not supported by Amazon S3 on Outposts buckets.
GrantWriteACP => Str
Allows grantee to write the ACL for the applicable bucket.
This is not supported by Amazon S3 on Outposts buckets.
ObjectLockEnabledForBucket => Bool
Specifies whether you want S3 Object Lock to be enabled for the new bucket.
This is not supported by Amazon S3 on Outposts buckets.
OutpostId => Str
The ID of the Outposts where the bucket is being created.
This is required by Amazon S3 on Outposts buckets.
SEE ALSO
This class forms part of Paws, documenting arguments for method CreateBucket in Paws::S3Control
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