Object Storage Service：PutBucket

API

Aksi

Definisi

PutBucket

oss:PutBucket

Membuat sebuah bucket.

oss:PutBucketAcl

Setelah membuat bucket, izin ini diperlukan untuk memodifikasi ACL bucket.

Header

Tipe

Diperlukan

Contoh

Deskripsi

x-oss-acl

String

Tidak

private

ACL dari bucket. Nilai valid:

• public-read-write: public-read-write

• public-read: public-read

• private (default): private

Untuk informasi lebih lanjut tentang ACL bucket, lihat Atur ACL bucket.

x-oss-resource-group-id

String

Tidak

rg-aek27tc****

ID kelompok sumber daya.

• Jika Anda menyertakan header ini dalam permintaan dan menentukan ID kelompok sumber daya, bucket yang dibuat akan termasuk dalam kelompok sumber daya yang ditentukan.

  Jika Anda mengatur ID kelompok sumber daya menjadi rg-default-id, bucket yang dibuat akan termasuk dalam kelompok sumber daya default.

• Jika Anda tidak menyertakan header ini dalam permintaan, bucket yang dibuat akan termasuk dalam kelompok sumber daya default.

Anda dapat memperoleh ID kelompok sumber daya di Konsol Manajemen Sumber Daya atau dengan memanggil operasi ListResourceGroups. Untuk informasi lebih lanjut, lihat Lihat informasi dasar kelompok sumber daya dan ListResourceGroups.

x-oss-bucket-tagging

String

Tidak

k1=v1&k2=v2

Tag bucket.

x-oss-hns-status

String

Tidak

disabled

Menentukan apakah akan mengaktifkan fitur namespace hierarkis untuk bucket.

Anda hanya dapat mengaktifkan fitur namespace hierarkis saat membuat bucket. Anda tidak dapat mengubah status namespace hierarkis dari bucket yang sudah ada.

• enabled: Mengaktifkan fitur.

  Setelah Anda mengaktifkan fitur namespace hierarkis untuk bucket, Anda dapat melakukan operasi folder di bucket, seperti membuat, menghapus, dan mengganti nama folder.

• disabled (default): Menonaktifkan fitur.

x-oss-server-side-encryption

String

Tidak

AES256

Metode enkripsi sisi server default.

Nilai valid: KMS, AES256

Biaya kecil dikenakan untuk memanggil operasi API KMS saat Anda menggunakan kunci KMS. Untuk informasi lebih lanjut, lihat Harga KMS.

Saat Anda menggunakan replikasi lintas wilayah, jika bucket tujuan memiliki enkripsi sisi server default yang diaktifkan dan aturan replikasi memiliki ReplicaCMKID yang dikonfigurasi, kasus-kasus berikut berlaku:

• Jika objek di bucket sumber tidak dienkripsi, objek yang direplikasi ke bucket tujuan dienkripsi menggunakan metode enkripsi default bucket tujuan.

• Jika objek di bucket sumber dienkripsi menggunakan SSE-KMS atau SSE-OSS, objek tersebut dienkripsi menggunakan metode enkripsi aslinya di bucket tujuan.

Untuk informasi lebih lanjut, lihat Replikasi lintas wilayah dan enkripsi sisi server.

x-oss-server-side-encryption-key-id

String

Tidak

9468da86-3509-4f8d-a61e-6eab1eac****

ID kunci KMS. Header ini diperlukan ketika x-oss-server-side-encryption disetel ke KMS dan Anda ingin menggunakan kunci tertentu untuk enkripsi. Dalam kasus lain, header ini harus kosong.

Jika Anda menggunakan OSS di CloudBox, parameter ini tidak didukung.

Nama

Tipe

Diperlukan

Contoh

Deskripsi

StorageClass

String

Tidak

Standard

Kelas penyimpanan bucket. Nilai valid:

• Standard (default): Standard

• IA: Infrequent Access

• Archive: Archive Storage

• ColdArchive: Cold Archive

• DeepColdArchive: Deep Cold Archive

Node induk: CreateBucketConfiguration

Node anak: tidak ada

DataRedundancyType

String

Tidak

LRS

Tipe redundansi data bucket. Nilai valid:

• LRS (default)

  Penyimpanan redundan lokal (LRS) menyimpan salinan redundan data Anda pada perangkat penyimpanan yang berbeda di zona yang sama. Ini memastikan durabilitas dan ketersediaan data bahkan jika dua perangkat penyimpanan rusak pada saat bersamaan.

• ZRS

  Penyimpanan redundan zona (ZRS) menggunakan mekanisme redundansi data lintas beberapa zona. ZRS menyimpan salinan redundan data Anda di beberapa zona di wilayah yang sama. Ini memastikan bahwa data Anda tetap dapat diakses meskipun satu zona menjadi tidak tersedia.

Node induk: CreateBucketConfiguration

Node anak: tidak ada

Header

Tipe

Contoh

Deskripsi

Location

String

/oss-example

Alamat bucket. Terdiri dari garis miring (/) dan nama bucket.

Nilai default: tidak ada

Kode kesalahan

Status HTTP

Deskripsi

InvalidBucketName

400

Nama bucket yang ditentukan tidak mengikuti konvensi penamaan.

AccessDenied

403

Penyebab potensial dari kesalahan:

• Informasi autentikasi pengguna tidak disertakan dalam permintaan PutBucket.

• Anda tidak memiliki izin yang diperlukan.

TooManyBuckets

400

Jumlah bucket yang dibuat melebihi batas atas. Akun Alibaba Cloud dapat membuat maksimal 100 bucket di wilayah tertentu.

BucketAlreadyExists

409

• Permintaan untuk membuat Bucket dengan nama yang sama dengan Bucket yang baru saja dihapus tidak memenuhi persyaratan waktu.

  Anda mencoba membuat bucket dengan nama yang sama dengan bucket yang baru saja dihapus. Setelah Anda menghapus sebuah bucket, Anda harus menunggu beberapa jam, biasanya 4 hingga 8 jam, sebelum Anda dapat membuat bucket lain dengan nama yang sama.

• Anda menggunakan Pengguna RAM atau STS untuk memanggil operasi PutBucket untuk membuat bucket dengan nama yang sama dengan bucket yang sudah ada.

  Hanya Akun Alibaba Cloud yang dapat membuat ulang bucket dengan nama yang sama.

• Anda tidak memiliki izin untuk memanggil operasi PutBucketAcl. Pastikan bahwa pemanggil diberi izin oss:PutBucketAcl menggunakan kebijakan bucket atau kebijakan RAM.

• Anda mencoba mengubah status namespace hierarkis dari bucket yang sudah ada. Anda hanya dapat mengaktifkan fitur namespace hierarkis saat membuat bucket.