Membuat tugas konversi tipe redundansi untuk sebuah bucket.
Catatan penggunaan
Pastikan bahwa konversi tipe redundansi didukung di wilayah tempat bucket berada. Fitur ini tersedia di wilayah-wilayah berikut: Cina (Hangzhou), Cina (Shanghai), Cina (Beijing), Cina (Zhangjiakou), Cina (Ulanqab), Cina (Shenzhen), Cina (Hong Kong), Jepang (Tokyo), Singapura, Indonesia (Jakarta), dan Jerman (Frankfurt).
Tipe redundansi bucket haruslah penyimpanan redundan lokal (LRS). Anda hanya dapat mengonversi tipe redundansi bucket dari LRS ke penyimpanan redundan zona (ZRS).
Kelas penyimpanan bucket harus Standar, Akses Jarang (IA), atau Arsip. Namun, kelas penyimpanan objek dalam bucket bisa berupa Penyimpanan Arsip Dingin atau Deep Cold Archive. Objek Penyimpanan Arsip Dingin dan Deep Cold Archive tetap disimpan sebagai LRS setelah perubahan. Anda tidak dapat mengubah tipe redundansi penyimpanan bucket Penyimpanan Arsip Dingin atau Deep Cold Archive.
Untuk membuat tugas konversi tipe redundansi untuk sebuah bucket, Anda memerlukan izin
oss:CreateBucketDataRedundancyTransition. Untuk informasi lebih lanjut, lihat Melampirkan kebijakan kustom ke pengguna RAM.Setiap wilayah memiliki Titik akhir Object Storage Service (OSS) sendiri. Untuk informasi lebih lanjut tentang wilayah dan titik akhir mereka, lihat Wilayah dan titik akhir.
Sintaks permintaan
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueHeader permintaan
Semua header dalam permintaan CreateBucketDataRedundancyTransition adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header permintaan umum.
Parameter permintaan
Parameter | Tipe | Diperlukan | Contoh | Deskripsi |
x-oss-target-redundancy-type | String | Ya | ZRS | Tipe redundansi yang ingin Anda konversikan pada bucket. Anda hanya dapat mengonversi tipe redundansi bucket dari LRS ke ZRS. |
Header respons
Semua header dalam respons terhadap permintaan CreateBucketDataRedundancyTransition adalah header respons umum. Untuk informasi lebih lanjut, lihat Header respons umum.
Elemen respons
Elemen | Tipe | Contoh | Deskripsi |
BucketDataRedundancyTransition | Container | N/A | Wadah tempat tugas konversi tipe redundansi disimpan. Node induk: tidak ada Node anak: TaskId |
TaskId | String | 4be5beb0f74f490186311b268bf6**** | ID tugas konversi tipe redundansi. ID tersebut dapat digunakan untuk melihat dan menghapus tugas konversi tipe redundansi. Node induk: BucketDataRedundancyTransition Node anak: tidak ada |
Contoh
Permintaan contoh
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Thu, 17 Apr 2025 08:40:17 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eRespons contoh
HTTP/1.1 200 x-oss-request-id: 655726F18EAD9B710C00B235 Date: Fri, 17 Nov 2023 08:40:17 GMT Content-Type: application/xml Content-Length: 151 Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <BucketDataRedundancyTransition> <TaskId>4be5beb0f74f490186311b268bf6****</TaskId> </BucketDataRedundancyTransition>
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi CreateBucketDataRedundancyTransition, lihat create-bucket-data-redundancy-transition.
Kode kesalahan
Kode kesalahan | Kode status HTTP | Deskripsi |
NoSuchBucket | 404 | Bucket tempat tugas konversi tipe redundansi dibuat tidak ada. |
BucketDataRedundancyTransitionTaskNotSupport | 400 | Tipe redundansi bucket tidak dapat dikonversi. Anda hanya dapat mengonversi tipe redundansi bucket dari LRS ke ZRS. |
BucketDataRedundancyTransitionTaskAlreadyExist | 409 | Tugas konversi tipe redundansi sedang berlangsung. |
BucketDataRedundancyTransitionTaskExceedLimit | 400 | Jumlah maksimum tugas konversi tipe redundansi telah tercapai. Hapus tugas yang selesai sebelum membuat tugas baru. |