S3 Create Bucket

S3 Create Bucket

API code: S3_CREATE_BUCKET
Pre-authorized role(s): TENANT_USER | TENANT_ADMIN

Request
URI
PUT
https://{api_host}//api/v1/s3/{bucketName}
COPY
Path Parameters
string
bucketName
Required

The bucket name. It must be URL encoded.

Header Parameters
x-amz-acl
Optional

The ACL of the bucket using the specified canned ACL. Valid Values: private | public-read | public-read-write | authenticated-read.

x-amz-grant-read
Optional

Allows the specified grantee(s) to list the objects in the bucket.

x-amz-grant-write
Optional

Allows the specified grantee(s) to create, overwrite, and delete any object in the bucket.

x-amz-grant-read-acp
Optional

Allows the specified grantee(s) to read the bucket ACL.

x-amz-grant-write-acp
Optional

Allows the specified grantee(s) to write the ACL for the applicable bucket.

x-amz-grant-full-control
Optional

Allows grantee the READ, WRITE, READ_ACP, and WRITE_ACP permissions on the bucket.

x-amz-bucket-object-lock-enabled
Optional

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

Request Body
CreateBucketConfiguration of type(s) application/json
Optional 
{
    "locationConstraint": "string"
}
string
locationConstraint
Optional

locationConstraint

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Operation doesn't return any data structure

On This Page
Bucket Management Operations
PUT
S3 Create Bucket
DELETE
S3 Delete Bucket
DELETE
S3 Delete Bucket Cors
DELETE
S3 Delete Bucket Encryption
DELETE
S3 Delete Bucket Lifecycle Configuration
DELETE
S3 Delete Bucket Policy
DELETE
S3 Delete Bucket Replication
DELETE
S3 Delete Bucket Tagging
DELETE
S3 Delete Bucket Website
DELETE
S3 Delete Public Access Block
GET
S3 Get Bucket
GET
S3 Get Bucket Acl
GET
S3 Get Bucket Cors
GET
S3 Get Bucket Encryption
GET
S3 Get Bucket Lifecycle Configuration
GET
S3 Get Bucket Location
GET
S3 Get Bucket Logging
GET
S3 Get Bucket Notification Configuration
GET
S3 Get Bucket Policy
GET
S3 Get Bucket Policy Status
GET
S3 Get Bucket Replication
GET
S3 Get Bucket Request Payment
GET
S3 Get Bucket Tagging
GET
S3 Get Bucket Versioning
GET
S3 Get Bucket Website
GET
S3 Get Object Lock Configuration
GET
S3 Get Public Access Block
GET
S3 List Buckets
GET
S3 List Multipart Uploads
GET
S3 List Object Versions
PUT
S3 Put Bucket Acl
PUT
S3 Put Bucket Cors
PUT
S3 Put Bucket Encryption
PUT
S3 Put Bucket Lifecycle Configuration
PUT
S3 Put Bucket Logging
PUT
S3 Put Bucket Notification Configuration
PUT
S3 Put Bucket Policy
PUT
S3 Put Bucket Replication
PUT
S3 Put Bucket Request Payment
PUT
S3 Put Bucket Tagging
PUT
S3 Put Bucket Versioning
PUT
S3 Put Bucket Website
PUT
S3 Put Object Lock Configuration
PUT
S3 Set Public Access Block