You use the HTTP PUT method to create a bucket. To create a bucket, you must be an authenticated user. Additionally, your user account must be configured to let you create buckets.
When you create a bucket, you specify a name for it. The specified name must be at least three characters long and at most 63 characters long. The name can contain only alphanumeric characters and hyphens (-) but cannot start or end with a hyphen. For information about naming buckets, see Bucket names.
You can specify an ACL for a bucket in the same request as you use to create the bucket. To do this, you need to use ACL headers. You cannot use an ACL request body when creating a bucket. For information about ACLs, see Access control lists.
If the ACL you specify in a request to create a bucket is invalid, HCP returns a 400 (Bad Request) or 501 (Not Implemented) status code and does not create the bucket.
When you create a bucket, you become the bucket owner. You also get browse, read, read ACL, write, write ACL, and delete data access permissions for the bucket. If search is enabled for the bucket, you also get search permission.
For information about bucket ownership, see Bucket owners. For information about data access permissions, see Data access permissions. For information about search, see Search.
![]() |
Note: You cannot use Active Directory authentication with S3 compatible requests to create a bucket. |
© 2015, 2020 Hitachi Vantara LLC. All rights reserved.