全部产品
Search
文档中心

Object Storage Service:restore

更新时间:Jul 02, 2025

Jika akses real-time tidak diaktifkan untuk objek Archive, Anda hanya dapat mengaksesnya setelah pemulihan. Akses real-time tidak didukung untuk objek Cold Archive dan Deep Cold Archive; Anda harus memulihkannya terlebih dahulu. Pemulihan objek Archive biasanya memerlukan beberapa menit, objek Cold Archive memerlukan beberapa jam, sedangkan objek Deep Cold Archive memerlukan waktu 12 hingga 48 jam. Waktu pemulihan ini hanya sebagai referensi dan dapat bervariasi berdasarkan skenario aktual. Topik ini menjelaskan cara menggunakan perintah restore untuk memulihkan objek.

Catatan penggunaan

  • Untuk memulihkan satu objek, Anda memerlukan izin oss:RestoreObject. Untuk memulihkan objek berdasarkan direktori, Anda memerlukan izin oss:RestoreObject dan oss:ListObjects. Informasi lebih lanjut dapat ditemukan di Lampirkan kebijakan kustom ke pengguna RAM.

  • Untuk detail lebih lanjut tentang proses pemulihan dan aturan penagihan, lihat Pemulihan Objek.

Sintaksis perintah

ossutil restore oss://bucket/object [flags]

Parameter

Tipe

Deskripsi

--days

int

Durasi dalam mana objek tetap dalam keadaan dipulihkan. Unit: hari. Nilai valid: 1 hingga 365.

Ketika Anda melakukan operasi pada beberapa objek dalam kelas penyimpanan yang berbeda sekaligus, dan nilai parameter --days melebihi durasi maksimum untuk kelas penyimpanan tertentu, nilai tersebut secara otomatis disetel ke durasi maksimum untuk kelas penyimpanan tersebut. Misalnya, durasi maksimum yang didukung oleh Archive adalah 7 hari, dan durasi maksimum yang didukung oleh Deep Cold Archive adalah 365 hari. Jika Anda menyetel parameter --days menjadi 100, durasi untuk objek Archive secara otomatis disetel ke 7 hari dan durasi untuk objek Deep Cold Archive secara otomatis disetel ke 100 hari.

--tier

string

Prioritas pemulihan. Anda tidak perlu menentukan parameter ini untuk objek Archive. Pemulihan memerlukan sekitar 1 menit.

  • Cold Archive:

    • Expedited: Objek dipulihkan dalam waktu 1 jam.

    • Standard: Objek dipulihkan dalam waktu 2~5 jam.

    • Bulk: Objek dipulihkan dalam waktu 5~12 jam.

  • Deep Cold Archive:

    • Expedited: Objek dipulihkan dalam waktu 12 jam.

    • Standard: Objek dipulihkan dalam waktu 48 jam.

Ketika Anda melakukan operasi pada beberapa objek dalam kelas penyimpanan yang berbeda sekaligus, jika nilai parameter --tier melebihi nilai prioritas yang didukung oleh kelas penyimpanan, nilai tersebut secara otomatis disetel ke prioritas terendah untuk kelas penyimpanan tersebut. Misalnya, objek Cold Archive mendukung Bulk, sedangkan objek Deep Cold Archive hanya mendukung Standard. Dalam hal ini, prioritas pemulihan secara otomatis disesuaikan menjadi Standard jika Anda menyetel parameter --tier menjadi Bulk.

--dirs

/

Menampilkan daftar objek dan subdirektori dalam direktori saat ini, bukan menampilkan semua objek di semua subdirektori secara rekursif.

--encoding-type

string

Metode encoding yang digunakan untuk mengkodekan nama objek. Nilai valid: url.

--end-with

string

Menentukan bahwa objek yang namanya secara alfabetis sebelum atau sama dengan nilai parameter --end-with akan dikembalikan.

--exclude

stringArray

Menentukan aturan pengecualian untuk jalur atau nama objek.

--exclude-from

stringArray

Membaca aturan pengecualian dari file.

--files-from

stringArray

Membaca nama objek dari file, dengan baris kosong atau baris komentar diabaikan.

--files-from-raw

stringArray

Membaca nama objek dari file, tanpa mengabaikan baris kosong dan baris komentar.

--filter

stringArray

Menentukan aturan filter untuk jalur atau nama objek.

--filter-from

stringArray

Membaca aturan filter dari file.

-f, --force

/

Memaksa operasi tanpa memerlukan konfirmasi.

--include

stringArray

Menentukan aturan inklusi untuk jalur atau nama objek.

--include-from

stringArray

Membaca aturan inklusi dari file.

--limited-num

int

Jumlah maksimum hasil yang akan dikembalikan.

--list-objects

/

Menampilkan daftar objek dengan memanggil operasi ListObjects.

--min-age

Durasi

Mengecualikan objek yang waktu modifikasi terakhirnya lebih baru dari nilai opsi ini. Unit default adalah s (detik). Anda dapat menambahkan akhiran unit waktu pada nilai numerik. Contohnya, 1h menunjukkan satu jam.

Catatan

--min-age 1h menentukan bahwa hanya objek yang dimodifikasi lebih dari satu jam lalu yang ditransfer.

--max-age

Durasi

Mengecualikan objek yang waktu modifikasi terakhirnya lebih lama dari nilai opsi ini. Unit default adalah s (detik). Anda dapat menambahkan akhiran unit waktu pada nilai numerik. Contohnya, 1h menunjukkan satu jam.

--min-mtime

Waktu

Mengecualikan objek yang waktu modifikasi terakhirnya lebih lama dari nilai opsi ini. Waktu harus dalam UTC. Contoh: 2006-01-02T15:04:05.

Catatan

--min-mtime "2006-01-02T15:04:05" menentukan bahwa hanya objek yang dimodifikasi setelah 15:04:05 Jan 2, 2006 yang ditransfer.

--max-mtime

Waktu

Mengecualikan objek yang waktu modifikasi terakhirnya lebih baru dari nilai opsi ini. Waktu harus dalam UTC. Contoh: 2006-01-02T15:04:05.

--max-size

SizeSuffix

Ukuran maksimum objek yang dapat ditransfer. Secara default, ukuran dalam byte (B). Anda dapat menambahkan akhiran unit berbasis 1024: B untuk byte, K untuk Kibibyte, M untuk Mebibyte, G untuk Gibibyte, T untuk Tebibyte, atau P untuk Pebibyte.

--metadata-exclude

stringArray

Menentukan aturan pengecualian untuk metadata objek.

--metadata-filter

stringArray

Aturan filter untuk metadata objek.

--metadata-filter-from

stringArray

Membaca aturan filter metadata dari file.

--metadata-include

stringArray

Menentukan aturan inklusi untuk metadata objek.

--min-size

SizeSuffix

Ukuran minimum file dan objek yang dapat ditransfer. Secara default, ukuran dalam byte (B). Anda dapat menambahkan akhiran unit berbasis 1024: B untuk byte, K untuk Kibibyte, M untuk Mebibyte, G untuk Gibibyte, T untuk Tebibyte, atau P untuk Pebibyte.

--page-size

int

Jumlah maksimum objek yang dapat dikembalikan per halaman ketika pencantuman daftar dilakukan dalam mode batch. Nilai valid: 1 hingga 1000. Nilai default: 1000.

-r, --recursive

/

Menentukan bahwa perintah melakukan operasi secara rekursif. Jika parameter ini ditentukan, perintah melakukan operasi pada semua objek yang cocok di bucket. Jika parameter ini tidak ditentukan, perintah hanya melakukan operasi pada objek yang ditentukan di jalur yang ditentukan.

--request-payer

string

Pembayar permintaan. Jika pay-by-requester diaktifkan, tentukan parameter ini. Nilai valid: requester.

--start-after

string

Menentukan bahwa objek yang namanya secara alfabetis sebelum atau sama dengan nilai parameter --end-with akan dikembalikan.

--version-id

string

ID versi objek.

--list-format

string

Format file daftar. Nilai valid: plain dan inventory.

--list-manifest-from

string

Baca deskripsi format file daftar dari file. Anda diharuskan menentukan parameter ini jika formatnya adalah inventory.

Catatan

Informasi lebih lanjut tersedia di Opsi Baris Perintah.

Contoh

Pemulihan objek Archive

  • Contoh berikut menunjukkan cara memulihkan objek Archive bernama exampleobject.txt di examplebucket:

    ossutil restore oss://examplebucket/exampleobject.txt
  • Contoh berikut menunjukkan cara memulihkan objek Archive bernama exampleobject.txt di examplebucket dengan durasi pemulihan selama 3 hari:

    ossutil restore oss://examplebucket/exampleobject.txt --days 3
  • Contoh berikut menunjukkan cara memulihkan objek dari daftar.

    Catatan

    Setiap baris dalam file daftar mewakili sebuah objek dalam format jalur OSS: oss://{bucket}/{key}.

    Berikut ini menggunakan list.txt sebagai contoh.

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil restore list://list.txt
  • Contoh berikut menunjukkan cara memulihkan objek langsung dari daftar tanpa memeriksa status objek:

    ossutil restore list://list.txt --no-check-status 
  • Contoh berikut menunjukkan cara memulihkan objek dari file daftar.

    Catatan

    File csv.gz dan manifest.json dihasilkan setelah inventaris dikonfigurasi dan diperlukan untuk pemulihan objek dari file daftar.

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json
  • Contoh berikut menunjukkan cara memulihkan objek langsung dari file daftar tanpa memeriksa status objek:

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json --no-check-status

Pemulihan objek Cold Archive

Contoh berikut menunjukkan cara memulihkan objek Cold Archive bernama exampleobject.txt di examplebucket dengan durasi pemulihan selama 5 hari:

ossutil restore oss://examplebucket/exampleobject.txt --tier Bulk --days 5

Pemulihan objek Deep Cold Archive

Contoh berikut menunjukkan cara memulihkan objek Deep Cold Archive bernama exampleobject.txt di examplebucket dengan durasi pemulihan selama 10 hari:

ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10

Aturan penagihan

  • Anda akan dikenakan biaya pengambilan data berdasarkan ukuran objek Archive, Cold Archive, atau Deep Cold Archive yang dipulihkan. Informasi lebih lanjut tersedia di Biaya Pemrosesan Data.

  • Anda akan dikenakan biaya pemanggilan operasi API berdasarkan jumlah permintaan PUT saat memulihkan objek Archive. Informasi lebih lanjut tersedia di Biaya Pemanggilan Operasi API.

  • Anda akan dikenakan biaya permintaan pengambilan data saat memulihkan objek Cold Archive atau Deep Cold Archive. Informasi lebih lanjut tersedia di Biaya Pemanggilan Operasi API.

  • Anda akan dikenakan biaya penyimpanan berdasarkan aturan penagihan untuk objek Archive, Cold Archive, dan Deep Cold Archive selama dan setelah pemulihan. Informasi lebih lanjut tersedia di Biaya Penyimpanan.

  • Saat memulihkan objek Cold Archive atau Deep Cold Archive, replika Standar dibuat untuk akses sementara. Anda akan dikenakan biaya penyimpanan sementara replika tersebut berdasarkan kelas penyimpanan Standar hingga objek kembali ke keadaan beku. Informasi lebih lanjut tersedia di Biaya Penyimpanan Sementara.

  • Objek Archive dapat tetap dalam keadaan dipulihkan hingga tujuh hari, sedangkan objek Cold Archive atau Deep Cold Archive dapat tetap dalam keadaan dipulihkan hingga 365 hari. Tidak ada biaya pengambilan data selama objek dalam keadaan dipulihkan.

  • Setelah periode pemulihan berakhir, objek kembali ke keadaan beku. Jika Anda memulihkan objek setelah itu, Anda akan dikenakan biaya pengambilan data.