Membuat tugas konversi tipe redundansi untuk sebuah bucket.
Usage notes
Bucket harus berada di wilayah yang mendukung konversi tipe redundansi penyimpanan. Wilayah yang didukung meliputi: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Hong Kong), Jepang (Tokyo), Singapura, Indonesia (Jakarta), dan Jerman (Frankfurt).
Tipe redundansi penyimpanan bucket harus LRS. OSS hanya mendukung konversi dari LRS ke ZRS.
Kelas penyimpanan bucket harus Standard, Infrequent Access (IA), atau Archive. Namun, objek dalam kelas penyimpanan Cold Archive atau Deep Cold Archive dapat ada di dalam bucket tersebut. Setelah konversi, objek-objek ini tetap berada dalam LRS. Anda tidak dapat mengonversi tipe redundansi penyimpanan untuk bucket yang kelas penyimpanannya adalah Cold Archive atau Deep Cold Archive.
Untuk membuat tugas konversi tipe redundansi, Anda harus memiliki izin
oss:CreateBucketDataRedundancyTransition. Untuk informasi selengkapnya, lihat Grant a custom policy to a RAM user.Untuk pemetaan antara wilayah dan titik akhir, lihat Endpoints.
Request syntax
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueRequest headers
Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Common request headers.
Request parameters
Parameter | Type | Required | Example | Description |
x-oss-target-redundancy-type | String | Yes | ZRS | Tipe redundansi target. Tetapkan nilai ini ke ZRS untuk mengonversi bucket dari locally redundant storage (LRS) ke zone-redundant storage (ZRS). |
Response headers
Operasi ini hanya menggunakan header respons umum. Untuk informasi selengkapnya, lihat Common response headers.
Response elements
Parameter | Type | Example | Description |
BucketDataRedundancyTransition | Container | N/A | Kontainer untuk task konversi tipe redundansi. Elemen induk: Tidak ada (Ini adalah elemen root). Elemen anak: TaskId |
TaskId | String | 4be5beb0f74f490186311b268bf6**** | ID task konversi tipe redundansi. Anda dapat menggunakan ID ini untuk mengkueri atau menghapus task tersebut. Elemen induk: BucketDataRedundancyTransition Elemen anak: Tidak ada |
Examples
Sample request
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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eSample response
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 perintah ossutil yang sesuai, lihat create-bucket-data-redundancy-transition.
Error codes
Error code | HTTP status code | Description |
NoSuchBucket | 404 | Bucket yang ditentukan tidak ada. |
BucketDataRedundancyTransitionTaskNotSupport | 400 | Tipe redundansi bucket tidak dapat dikonversi. Bucket hanya dapat dikonversi dari LRS ke ZRS. |
BucketDataRedundancyTransitionTaskAlreadyExist | 409 | Task konversi tipe redundansi sedang berlangsung untuk bucket yang ditentukan. |
BucketDataRedundancyTransitionTaskExceedLimit | 400 | Jumlah maksimum task konversi tipe redundansi telah tercapai. Untuk membuat task baru, Anda harus menghapus task yang telah selesai. |
AccessDenied | 403 | Wilayah bucket tidak mendukung operasi ini. |