/AWS1/CL_S3_CREATEBUCKETCONF

The configuration information for the bucket.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_locationconstraint TYPE /AWS1/S3_BUCKETLOCATIONCNSTRNT /AWS1/S3_BUCKETLOCATIONCNSTRNT

Specifies the Region where the bucket will be created. You might choose a Region to optimize latency, minimize costs, or address regulatory requirements. For example, if you reside in Europe, you will probably find it advantageous to create buckets in the Europe (Ireland) Region.

If you don't specify a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1) by default. Configurations using the value EU will create a bucket in eu-west-1.

For a list of the valid values for all of the Amazon Web Services Regions, see Regions and Endpoints.

This functionality is not supported for directory buckets.

io_location TYPE REF TO /AWS1/CL_S3_LOCATIONINFO /AWS1/CL_S3_LOCATIONINFO

Specifies the location where the bucket will be created.

Directory buckets - The location type is Availability Zone or Local Zone. To use the Local Zone location type, your account must be enabled for Local Zones. Otherwise, you get an HTTP 403 Forbidden error with the error code AccessDenied. To learn more, see Enable accounts for Local Zones in the Amazon S3 User Guide.

This functionality is only supported by directory buckets.

io_bucket TYPE REF TO /AWS1/CL_S3_BUCKETINFO /AWS1/CL_S3_BUCKETINFO

Specifies the information about the bucket that will be created.

This functionality is only supported by directory buckets.

it_tags TYPE /AWS1/CL_S3_TAG=>TT_TAGSET TT_TAGSET

An array of tags that you can apply to the bucket that you're creating. Tags are key-value pairs of metadata used to categorize and organize your buckets, track costs, and control access.

You must have the s3:TagResource permission to create a general purpose bucket with tags or the s3express:TagResource permission to create a directory bucket with tags.

When creating buckets with tags, note that tag-based conditions using aws:ResourceTag and s3:BucketTag condition keys are applicable only after ABAC is enabled on the bucket. To learn more, see Enabling ABAC in general purpose buckets.

---

Queryable Attributes

LocationConstraint

Specifies the Region where the bucket will be created. You might choose a Region to optimize latency, minimize costs, or address regulatory requirements. For example, if you reside in Europe, you will probably find it advantageous to create buckets in the Europe (Ireland) Region.

If you don't specify a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1) by default. Configurations using the value EU will create a bucket in eu-west-1.

For a list of the valid values for all of the Amazon Web Services Regions, see Regions and Endpoints.

This functionality is not supported for directory buckets.

Accessible with the following methods

Method	Description
GET_LOCATIONCONSTRAINT()	Getter for LOCATIONCONSTRAINT, with configurable default
ASK_LOCATIONCONSTRAINT()	Getter for LOCATIONCONSTRAINT w/ exceptions if field has no
HAS_LOCATIONCONSTRAINT()	Determine if LOCATIONCONSTRAINT has a value

Location

Specifies the location where the bucket will be created.

Directory buckets - The location type is Availability Zone or Local Zone. To use the Local Zone location type, your account must be enabled for Local Zones. Otherwise, you get an HTTP 403 Forbidden error with the error code AccessDenied. To learn more, see Enable accounts for Local Zones in the Amazon S3 User Guide.

This functionality is only supported by directory buckets.

Accessible with the following methods

Method	Description
GET_LOCATION()	Getter for LOCATION

Bucket

Specifies the information about the bucket that will be created.

This functionality is only supported by directory buckets.

Accessible with the following methods

Method	Description
GET_BUCKET()	Getter for BUCKET

Tags

An array of tags that you can apply to the bucket that you're creating. Tags are key-value pairs of metadata used to categorize and organize your buckets, track costs, and control access.

You must have the s3:TagResource permission to create a general purpose bucket with tags or the s3express:TagResource permission to create a directory bucket with tags.

When creating buckets with tags, note that tag-based conditions using aws:ResourceTag and s3:BucketTag condition keys are applicable only after ABAC is enabled on the bucket. To learn more, see Enabling ABAC in general purpose buckets.

Accessible with the following methods

Method	Description
GET_TAGS()	Getter for TAGS, with configurable default
ASK_TAGS()	Getter for TAGS w/ exceptions if field has no value
HAS_TAGS()	Determine if TAGS has a value