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"
import boto3
s3_client = boto3.client('s3',
endpoint_url='https://storage.nami.cloud',
aws_access_key_id='YOUR_ACCESS_KEY',
aws_secret_access_key='YOUR_SECRET_KEY'
)
s3_client.create_bucket(
Bucket='mybucket',
ACL='private'
)
import { S3Client, CreateBucketCommand } from "@aws-sdk/client-s3";
const client = new S3Client({
endpoint: "https://storage.nami.cloud",
credentials: {
accessKeyId: "YOUR_ACCESS_KEY",
secretAccessKey: "YOUR_SECRET_KEY",
},
});
async function createBucket() {
const command = new CreateBucketCommand({
Bucket: "mybucket",
ACL: "private"
});
try {
const response = await client.send(command);
console.log("Bucket created:", response);
} catch (err) {
console.error("Error:", err);
}
}
createBucket();
package main
import (
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/credentials"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/service/s3"
)
func main() {
sess := session.Must(session.NewSession(&aws.Config{
Endpoint: aws.String("https://storage.nami.cloud"),
Region: aws.String("us-east-1"),
Credentials: credentials.NewStaticCredentials("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY", ""),
}))
s3Client := s3.New(sess)
_, err := s3Client.CreateBucket(&s3.CreateBucketInput{
Bucket: aws.String("mybucket"),
ACL: aws.String("private"),
})
if err != nil {
panic(err)
}
}
use aws_sdk_s3::{Client, Config};
use aws_config::credentials::StaticCredentialsProvider;
use aws_types::region::Region;
use tokio;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let credentials = StaticCredentialsProvider::new(
"YOUR_ACCESS_KEY".to_string(),
"YOUR_SECRET_KEY".to_string(),
None,
);
let config = Config::builder()
.endpoint_url("https://storage.nami.cloud")
.region(Region::new("us-east-1"))
.credentials_provider(credentials)
.build();
let client = Client::from_conf(config);
client
.create_bucket()
.bucket("mybucket")
.acl(aws_sdk_s3::types::BucketCannedAcl::Private)
.send()
.await?;
println!("Bucket created successfully!");
Ok(())
}
{
"Code": "<string>",
"Message": "<string>",
"RequestId": "<string>"
}Bucket Operations
Create Bucket
Create a new S3 bucket
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"
import boto3
s3_client = boto3.client('s3',
endpoint_url='https://storage.nami.cloud',
aws_access_key_id='YOUR_ACCESS_KEY',
aws_secret_access_key='YOUR_SECRET_KEY'
)
s3_client.create_bucket(
Bucket='mybucket',
ACL='private'
)
import { S3Client, CreateBucketCommand } from "@aws-sdk/client-s3";
const client = new S3Client({
endpoint: "https://storage.nami.cloud",
credentials: {
accessKeyId: "YOUR_ACCESS_KEY",
secretAccessKey: "YOUR_SECRET_KEY",
},
});
async function createBucket() {
const command = new CreateBucketCommand({
Bucket: "mybucket",
ACL: "private"
});
try {
const response = await client.send(command);
console.log("Bucket created:", response);
} catch (err) {
console.error("Error:", err);
}
}
createBucket();
package main
import (
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/credentials"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/service/s3"
)
func main() {
sess := session.Must(session.NewSession(&aws.Config{
Endpoint: aws.String("https://storage.nami.cloud"),
Region: aws.String("us-east-1"),
Credentials: credentials.NewStaticCredentials("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY", ""),
}))
s3Client := s3.New(sess)
_, err := s3Client.CreateBucket(&s3.CreateBucketInput{
Bucket: aws.String("mybucket"),
ACL: aws.String("private"),
})
if err != nil {
panic(err)
}
}
use aws_sdk_s3::{Client, Config};
use aws_config::credentials::StaticCredentialsProvider;
use aws_types::region::Region;
use tokio;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let credentials = StaticCredentialsProvider::new(
"YOUR_ACCESS_KEY".to_string(),
"YOUR_SECRET_KEY".to_string(),
None,
);
let config = Config::builder()
.endpoint_url("https://storage.nami.cloud")
.region(Region::new("us-east-1"))
.credentials_provider(credentials)
.build();
let client = Client::from_conf(config);
client
.create_bucket()
.bucket("mybucket")
.acl(aws_sdk_s3::types::BucketCannedAcl::Private)
.send()
.await?;
println!("Bucket created successfully!");
Ok(())
}
{
"Code": "<string>",
"Message": "<string>",
"RequestId": "<string>"
}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
The canned ACL to apply to the bucket
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"
import boto3
s3_client = boto3.client('s3',
endpoint_url='https://storage.nami.cloud',
aws_access_key_id='YOUR_ACCESS_KEY',
aws_secret_access_key='YOUR_SECRET_KEY'
)
s3_client.create_bucket(
Bucket='mybucket',
ACL='private'
)
import { S3Client, CreateBucketCommand } from "@aws-sdk/client-s3";
const client = new S3Client({
endpoint: "https://storage.nami.cloud",
credentials: {
accessKeyId: "YOUR_ACCESS_KEY",
secretAccessKey: "YOUR_SECRET_KEY",
},
});
async function createBucket() {
const command = new CreateBucketCommand({
Bucket: "mybucket",
ACL: "private"
});
try {
const response = await client.send(command);
console.log("Bucket created:", response);
} catch (err) {
console.error("Error:", err);
}
}
createBucket();
package main
import (
"github.com/aws/aws-sdk-go/aws"
"github.com/aws/aws-sdk-go/aws/credentials"
"github.com/aws/aws-sdk-go/aws/session"
"github.com/aws/aws-sdk-go/service/s3"
)
func main() {
sess := session.Must(session.NewSession(&aws.Config{
Endpoint: aws.String("https://storage.nami.cloud"),
Region: aws.String("us-east-1"),
Credentials: credentials.NewStaticCredentials("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY", ""),
}))
s3Client := s3.New(sess)
_, err := s3Client.CreateBucket(&s3.CreateBucketInput{
Bucket: aws.String("mybucket"),
ACL: aws.String("private"),
})
if err != nil {
panic(err)
}
}
use aws_sdk_s3::{Client, Config};
use aws_config::credentials::StaticCredentialsProvider;
use aws_types::region::Region;
use tokio;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let credentials = StaticCredentialsProvider::new(
"YOUR_ACCESS_KEY".to_string(),
"YOUR_SECRET_KEY".to_string(),
None,
);
let config = Config::builder()
.endpoint_url("https://storage.nami.cloud")
.region(Region::new("us-east-1"))
.credentials_provider(credentials)
.build();
let client = Client::from_conf(config);
client
.create_bucket()
.bucket("mybucket")
.acl(aws_sdk_s3::types::BucketCannedAcl::Private)
.send()
.await?;
println!("Bucket created successfully!");
Ok(())
}
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
⌘I