PUT
curl -X PUT "https://mybucket.storage.nami.cloud/" \
  -H "Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20231028/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-date, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024" \
  -H "x-amz-acl: private"
This response does not have an example.

You need appropriate permissions to create buckets in your account.

Create Bucket

Creates a new bucket. By default, the bucket is created in the region specified in your configuration.

Base URL

https://${bucketname}.storage.nami.cloud

Headers

x-amz-acl

The canned ACL to apply to the bucket

x-amz-bucket-object-lock-enabled

Specifies whether object lock should be enabled for the bucket

Request Examples

curl -X PUT "https://mybucket.storage.nami.cloud/" \
  -H "Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20231028/us-east-1/s3/aws4_request, SignedHeaders=host;x-amz-date, Signature=fe5f80f77d5fa3beca038a248ff027d0445342fe2855ddc963176630326f1024" \
  -H "x-amz-acl: private"

Response Example

HTTP/1.1 200 OK
x-amz-id-2: YgIPIfBiKa2bj0KMgUAdQkf3ShJTOOpXUueF6QKo
x-amz-request-id: 236A8905248E5A01
Date: Wed, 28 Oct 2023 22:32:00 GMT
Location: /mybucket
Content-Length: 0
Server: Nami Cloud

Authorizations

Authorization
string
header
required

AWS Signature Version 4

Headers

x-amz-acl
enum<string>

The canned ACL to apply to the bucket

Available options:
private,
public-read,
public-read-write,
authenticated-read

Response

200
_mintlify/placeholder

Bucket created successfully