Object Storage Service:PutBucket

API

Action

Description

PutBucket

oss:PutBucket

Membuat bucket.

oss:PutBucketAcl

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

Name

Type

Required

Example

Description

x-oss-acl

String

No

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 Set bucket ACLs.

x-oss-resource-group-id

String

No

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 tersebut.

  Jika Anda mengatur ID kelompok sumber daya ke 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 Resource Management atau dengan memanggil operasi ListResourceGroups. Untuk informasi selengkapnya, lihat View resource groups dan ListResourceGroups.

x-oss-bucket-tagging

String

No

k1=v1&k2=v2

Menentukan tag bucket.

x-oss-hns-status

String

No

disabled

Menentukan apakah fitur namespace hirarkis diaktifkan untuk bucket.

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

• enabled: Diaktifkan

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

• disabled (default): Fitur dinonaktifkan.

x-oss-server-side-encryption

String

No

AES256

Menetapkan metode enkripsi sisi server default.

Nilai yang valid: KMS, AES256

Penggunaan fitur KMS akan dikenai biaya kecil untuk panggilan API KMS. Untuk informasi harga selengkapnya, lihat KMS pricing.

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 mempertahankan metode enkripsi aslinya di bucket tujuan.

Untuk informasi selengkapnya, lihat Cross-region replication with server-side encryption.

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

String

No

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

ID kunci KMS. Header ini wajib hanya ketika 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.

Name

Type

Required

Example

Description

StorageClass

String

No

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

No

LRS

Jenis redundansi data bucket. Nilai yang valid:

• LRS (default)

  Locally redundant storage (LRS) menyimpan salinan data Anda di perangkat penyimpanan berbeda dalam zona yang sama. Hal ini menjamin ketahanan dan ketersediaan data meskipun dua perangkat penyimpanan rusak secara bersamaan.

• ZRS

  Zone-redundant storage (ZRS) menggunakan mekanisme redundansi data di beberapa zona. ZRS menyimpan data objek di beberapa zona dalam wilayah yang sama. Jika suatu zona tidak tersedia, Anda tetap dapat mengakses data tersebut.

Node induk: CreateBucketConfiguration

Node anak: Tidak ada

Name

Type

Example

Description

Location

String

/oss-example

Alamat bucket. Nilainya adalah garis miring (/) diikuti nama bucket.

Nilai default: Tidak ada

Error code

HTTP status code

Description

InvalidBucketName

400

Nama bucket tidak sesuai dengan konvensi penamaan.

AccessDenied

403

Penyebab error berikut mungkin terjadi:

• Informasi autentikasi pengguna tidak disertakan dalam permintaan PutBucket.

• Anda tidak memiliki izin yang diperlukan.

TooManyBuckets

400

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

BucketAlreadyExists

409

• Jika 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 pengguna RAM atau STS untuk membuat bucket dengan nama yang sama dengan 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 diberikan izin oss:PutBucketAcl melalui bucket policy atau RAM policy.

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