全部产品
Search
文档中心

Object Storage Service:CreateBucketDataRedundancyTransition

更新时间:Jul 02, 2025

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: SignatureValue

Header 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Respons 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.