-
Amazon S3
- S3 Bucket Acl Operations
- S3 Bucket Cors Operations
- S3 Bucket Is Stale Allowed Operations
- S3 Bucket Lifecycle Operation
- S3 Bucket List Uploads Operations
- S3 Bucket Location Operations
- S3 Bucket Operations
- S3 Bucket Versioning Operations
- S3 Bucket Versions Operations
- S3 Data Node Operation
- S3 Multi Object Delete Operations
- S3 Object Acl Operations
- S3 Object Init Uploads Operations
- S3 Object Operations
- S3 Object Uploads Operations
- S3 Options Operations
- S3 Ping Operation
- EMC Atmos
- OpenStack SWIFT
- All Changes
-
Modified Services
- Data Store
- Password Group (Swift)
- S3 Bucket Acl Operations
- S3 Bucket Lifecycle Operation
- S3 Bucket Location Operations
- S3 Bucket Operations
- S3 Bucket Versioning Operations
- S3 Object Operations
- S3 Object Uploads Operations
- Secret Key
- Secret Key Self-Service
- Swift Container Operations
- Swift File Access Operations
- Swift Object Operations
- User (Object)

Create Bucket
Creates a bucket in which users can create objects. The bucket is created in a storage pool associated with the specified replication group.
Current user will become the bucket owner.
If namespace to this bucket creation does not exist, user's namespace is used
For non SYSTEM_ADMIN user, namespace should be current user's namespace
Required Roles
Requires one of the following roles:
SYSTEM_ADMIN
NAMESPACE_ADMIN
Prerequisites
The following conditions must be met in order to call this operation.
A qualifying storage pool must exist corresponding to the replication group for bucket
Only authenticated users can create buckets
Bucket name should be less than 255 characters
Bucket name should contain only alphanumeric, '.','-' and '_'.
Request Payload
All parameters are required unless otherwise stated.
Field | Description | Type | Notes |
<object_bucket_create> | |||
<name> | Bucket name | String | |
<vpool> | Replication group identifier | URI | |
<filesystem_enabled> | flag indicating whether file-system is enabled for this bucket | Boolean | |
<head_type> | HeadType indicates the object head type that is allowed to access the bucket. If the bucket has FS-Enabled, then the FS heads are implicitly allowed to access this bucket | String | |
<namespace> | Namespace associated with the user/tenant that is allowed to access the bucket | String | |
<is_stale_allowed> | tag to allow stale data in bucket | Boolean | |
</object_bucket_create> |
Response Body
Indicating success or failure of the bucket create operation
Field | Description | Type | Notes |
<object_bucket> | |||
<error_message> | Message returned by the server indicating the reason for create bucket failure (if any) | String | |
<name> | Name assigned to this resource in ECS. The resource name is set by a user and can be changed at any time. It is not a unique identifier. | String | |
<id> | Identifier that is generated by ECS when the resource is created. The resource Id is guaranteed to be unique and immutable across all virtual data centers for all time. | URI |
Valid Values:
|
<link> | Hyperlink to the details for this resource | ||
<creation_time> | Timestamp that shows when this resource was created in ECS | DateTime |
Valid Values:
|
<tags> | Keywords and labels that can be added by a user to a resource to make it easy to find when doing a search. | ||
<tag> | String |
0-* Elements |
|
</tags> | |||
<inactive> | Indicates whether the resource is inactive. When a user removes a resource, the resource is put in this state before it is removed from the ECS database. | Boolean |
Valid Values:
|
<global> | Indicates whether the resource is global. | Boolean |
Valid Values:
|
<remote> | Indicates whether the resource is remote. | Boolean |
Valid Values:
|
<vdc> | |||
<id> | ECS Id of the related object | URI | |
<link> | Hyperlink to the related object | ||
</vdc> | |||
<internal> | Indicated whether the resource is an internal resource | Boolean |
Valid Values:
|
</object_bucket> |
Examples
Request
POST https://192.168.0.0:4443/object/bucket HTTP/1.1 Content-Type: application/xml X-SDS-AUTH-TOKEN: <AUTH_TOKEN> <object_bucket_create> <name>bucket3</name> <vpool></vpool> <filesystem_enabled>false</filesystem_enabled> <head_type>s3</head_type> <namespace>s3</namespace> <is_stale_allowed>false</is_stale_allowed> </object_bucket_create>
Response
HTTP/1.1 200 OK Content-Type: application/xml <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <object_bucket> <id>s3.bucket3</id> <inactive>false</inactive> <name>bucket3</name> <tags/> </object_bucket>