Object Storage Service:PutBucket

API

Tindakan

Deskripsi

PutBucket

oss:PutBucket

Membuat bucket.

oss:PutBucketAcl

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

Nama

Tipe

Wajib

Contoh

Deskripsi

bucket

String

Ya

examplebucket

Nama bucket. Konvensi penamaan untuk bucket adalah sebagai berikut:

• Nama hanya boleh berisi huruf kecil, angka, dan tanda hubung (-).

• Nama harus dimulai dan diakhiri dengan huruf kecil atau angka.

• Panjang nama harus antara 3 hingga 63 karakter.

x-oss-acl

String

Tidak

private

Daftar kontrol akses (ACL) bucket. Nilai yang valid:

• public-read-write: Memberikan izin baca dan tulis publik.

• public-read: Baca Publik

• private (default)

Untuk informasi selengkapnya tentang ACL bucket, lihat Mengatur 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 menjadi milik kelompok sumber daya yang ditentukan.

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

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

Anda dapat memperoleh ID kelompok sumber daya di Konsol Resource Management atau dengan memanggil operasi ListResourceGroups. Untuk informasi selengkapnya, lihat Melihat kelompok sumber daya dan ListResourceGroups.

x-oss-bucket-tagging

String

Tidak

k1=v1&k2=v2

Menentukan tag bucket.

x-oss-hns-status

String

Tidak

disabled

Menentukan apakah akan mengaktifkan fitur hierarchical namespace untuk bucket.

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

• enabled: Diaktifkan

  Setelah Anda mengaktifkan fitur hierarchical namespace untuk sebuah bucket, Anda dapat melakukan operasi direktori di dalam bucket tersebut, seperti membuat, menghapus, dan mengganti nama direktori.

• disabled (default): Fitur dinonaktifkan.

x-oss-server-side-encryption

String

Tidak

AES256

Mengatur metode Enkripsi sisi server default.

Nilai yang valid: KMS, AES256

Penggunaan fitur KMS dikenakan biaya kecil untuk panggilan API KMS. Untuk informasi selengkapnya tentang harga, lihat Harga KMS.

Selama replikasi lintas wilayah, jika bucket tujuan telah mengaktifkan Enkripsi sisi server default dan aturan replikasi dikonfigurasi dengan ReplicaCMKID, situasi berikut berlaku:

• Jika objek di bucket sumber tidak dienkripsi, objek tersebut akan dienkripsi menggunakan metode enkripsi default bucket tujuan setelah direplikasi.

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

Untuk informasi selengkapnya, lihat Replikasi lintas wilayah dengan Enkripsi sisi server.

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

String

Tidak

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

ID kunci KMS. Header ini hanya diperlukan jika x-oss-server-side-encryption diatur ke KMS. Dalam kasus lain, header ini harus kosong.

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

Nama

Tipe

Wajib

Contoh

Deskripsi

StorageClass

String

Tidak

Standard

Kelas penyimpanan bucket. Nilai yang valid:

• Standard (default)

• IA: Akses Jarang

• Archive: Archive Storage

• ColdArchive: Penyimpanan Arsip Dingin

• DeepColdArchive: Deep Cold Archive

Node induk: CreateBucketConfiguration

Node anak: Tidak ada

DataRedundancyType

String

Tidak

LRS

Tipe redundansi data bucket. Nilai yang valid:

• LRS (default)

  Locally redundant storage (LRS) menyimpan salinan data Anda pada perangkat penyimpanan yang berbeda dalam zona yang sama. Hal ini memastikan ketahanan dan ketersediaan data bahkan jika dua perangkat penyimpanan rusak secara bersamaan.

• ZRS

  Zone-redundant storage (ZRS) menggunakan Mekanisme redundansi data di dalam multiple zona. ZRS menyimpan data objek di beberapa zona dalam Wilayah yang sama. Jika satu zona tidak tersedia, Anda masih dapat mengakses data tersebut.

Node induk: CreateBucketConfiguration

Node anak: Tidak ada

Nama

Tipe

Contoh

Deskripsi

Location

String

/oss-example

Alamat bucket. Nilainya berupa garis miring (/) diikuti dengan nama bucket.

Nilai default: Tidak ada

Kode error

Kode status HTTP

Deskripsi

InvalidBucketName

400

Nama bucket tidak sesuai dengan Konvensi penamaan.

AccessDenied

403

Berikut adalah kemungkinan penyebab error:

• Informasi autentikasi pengguna tidak disertakan dalam permintaan PutBucket.

• Anda tidak memiliki izin yang diperlukan.

TooManyBuckets

400

Jumlah bucket yang dibuat melebihi batas atas. Satu Akun Alibaba Cloud dapat membuat maksimal 100 bucket di Wilayah yang sama.

BucketAlreadyExists

409

• Jika sebuah bucket telah dihapus, persyaratan waktu untuk membuat bucket dengan nama yang sama belum terpenuhi.

  Anda mencoba membuat bucket dengan nama yang sebelumnya digunakan oleh bucket yang baru saja dihapus. Setelah bucket dihapus, Anda harus menunggu beberapa jam (biasanya 4 hingga 8 jam) sebelum dapat membuat bucket dengan nama yang sama.

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

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

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

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