CreateBucket
Creates a new bucket. The bucket name is global unique for different LSU. Not every string is an acceptable bucket name. For information about bucket naming restrictions, see Bucket naming rules. You must specify Region(=lsu name) in the request body. You are not permitted to create buckets using anonymous requests.
Request Syntax
PUT /bucket HTTP/1.1 Host: msdps3.server:8443 <?xml version="1.0" encoding="UTF-8"?> <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <LocationConstraint>string</LocationConstraint> </CreateBucketConfiguration>
Request Parameters
Bucket
Name of the bucket to be created.
Required: Yes
Type: String
x-amz-bucket-object-lock-enabled (Flex WORM only)
Specifies if S3 Object Lock is enabled for the new bucket.
Note:
If ObjectLockEnabledForBucket is set to true in the CreateBucket request, s3:PutObjectLockConfiguration permission is required and the bucket versioning is enabled automatically. s3:PutBucketVersioning permission is not required.
Request Body
CreateBucketConfiguration
Root level tag for the CreateBucketConfiguration parameters.
Required: Yes
LocationConstraint
Specifies the Region where the bucket will be created.
Note:
The regions in S3Srv are the LSU names. If you don't specify a region, the bucket is created in the region PureDiskVolume (Local LSU).
Type: String
Valid Values: PureDiskVolume, CLOUD_LSU_NAME
Required: No
Response Syntax
HTTP/1.1 200
Possible Error Response
Success
HTTP status code 200.
InvalidArgument
Invalid Argument.
HTTP status code 400.
InvalidBucketName
The specified bucket is not valid.
HTTP status code 400.
AccessDenied
Access Denied.
HTTP status code 403.
BucketAlreadyExists
The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.
HTTP status code 409.
InternalError
Request failed because of an internal server error.
HTTP status code 500.