All Products
Search
Document Center

Object Storage Service:restore (Pulihkan objek)

Last Updated:Mar 26, 2026

Jika pembacaan langsung tidak diaktifkan, objek Archive harus dipulihkan terlebih dahulu sebelum dapat dibaca. Kelas penyimpanan Cold Archive dan Deep Cold Archive tidak mendukung pembacaan langsung, sehingga objek dalam kelas tersebut juga harus dipulihkan sebelum dapat diakses. Pemulihan objek Archive biasanya memerlukan beberapa menit, pemulihan objek Cold Archive memerlukan beberapa jam, sedangkan pemulihan objek Deep Cold Archive memerlukan 12 hingga 48 jam. Waktu pemulihan aktual dapat bervariasi. Topik ini menjelaskan cara memulihkan file menggunakan perintah restore.

Pertimbangan

  • Untuk memulihkan satu file, Anda harus memiliki izin oss:RestoreObject. Untuk memulihkan file berdasarkan direktori, Anda harus memiliki izin oss:RestoreObject dan oss:ListObjects. Untuk informasi selengkapnya, lihat Grant custom policies to a RAM user.

  • Untuk detail mengenai status pemulihan dan biaya objek dalam Archive Storage, Cold Archive Storage, atau Deep Cold Archive Storage, lihat Restore objects.

Sintaksis perintah

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

Parameter

Tipe

Deskripsi

--days

int

Jumlah hari objek yang dipulihkan tetap dapat diakses. Nilai valid: 1 hingga 365.

Ketika Anda menjalankan operasi batch pada objek dari kelas penyimpanan yang berbeda, jika jumlah hari yang ditentukan melebihi batas maksimum yang diizinkan untuk suatu kelas penyimpanan, nilai tersebut akan secara otomatis disesuaikan ke batas maksimum kelas tersebut. Misalnya, durasi maksimum untuk Archive Storage adalah 7 hari, sedangkan untuk Deep Cold Archive Storage adalah 365 hari. Jika Anda mengatur --days ke 100, durasi akan secara otomatis diatur menjadi 7 untuk objek Archive Storage dan tetap 100 untuk objek Deep Cold Archive Storage.

--tier

string

Prioritas pemulihan. Parameter ini tidak diperlukan untuk objek Archive Storage karena pemulihan berlangsung sekitar satu menit.

  • Cold Archive Storage:

    • Expedited: Pemulihan selesai dalam waktu kurang dari 1 jam.

    • Standard: Pemulihan selesai dalam waktu 2 hingga 5 jam.

    • Bulk: Pemulihan selesai dalam waktu 5 hingga 12 jam.

  • Deep Cold Archive Storage:

    • Expedited: Pemulihan selesai dalam waktu kurang dari 12 jam.

    • Standard: Pemulihan selesai dalam waktu 48 jam.

Ketika Anda melakukan pemulihan batch untuk objek dari kelas penyimpanan yang berbeda, jika tier yang ditentukan tidak didukung oleh suatu kelas, nilai tersebut akan secara otomatis disesuaikan ke prioritas terendah yang didukung oleh kelas tersebut. Misalnya, Cold Archive Storage mendukung tier Bulk, tetapi Deep Cold Archive Storage hanya mendukung tier Standard. Jika Anda mengatur --tier ke Bulk, tier untuk objek Deep Cold Archive Storage dalam batch tersebut akan secara otomatis disesuaikan menjadi Standard.

--dirs

/

Menampilkan daftar objek dan subdirektori dalam direktori yang ditentukan, tetapi tidak secara rekursif.

--encoding-type

string

Tipe encoding untuk nama objek atau file yang akan diproses. Nilai valid: url.

--end-with

string

Menampilkan daftar objek yang secara alfabetis berada pada atau sebelum nilai yang ditentukan.

--exclude

stringArray

Aturan pengecualian untuk path atau nama objek.

--exclude-from

stringArray

Membaca aturan pengecualian dari sebuah file.

--files-from

stringArray

Membaca daftar nama file sumber dari sebuah file. Baris kosong dan baris komentar diabaikan.

--files-from-raw

stringArray

Membaca daftar nama file sumber dari sebuah file.

--filter

stringArray

Aturan filter untuk path atau nama objek.

--filter-from

stringArray

Membaca aturan filter dari sebuah file.

-f, --force

/

Memaksa operasi tanpa meminta konfirmasi.

--include

stringArray

Aturan inklusi untuk path atau nama objek.

--include-from

stringArray

Membaca aturan inklusi dari sebuah file.

--limited-num

int

Jumlah maksimum hasil yang dikembalikan.

--list-objects

/

Menampilkan daftar objek menggunakan operasi ListObjects.

--min-age

Duration

Mengecualikan objek yang lebih baru dari nilai yang ditentukan. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan, seperti 1h untuk satu jam.

Catatan

--min-age 1h menunjukkan bahwa hanya file yang dimodifikasi satu jam lalu atau lebih awal yang ditransfer.

--max-age

Duration

Mengecualikan objek yang lebih lama dari nilai yang ditentukan. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan, seperti 1h untuk satu jam.

--min-mtime

Time

Mengecualikan objek yang dimodifikasi sebelum waktu yang ditentukan. Waktu harus dalam format UTC. Contoh: 2006-01-02T15:04:05.

Catatan

--min-mtime "2006-01-02T15:04:05" menentukan bahwa hanya file yang dimodifikasi setelah pukul 15:04:05 pada 2 Januari 2006 yang ditransfer.

--max-mtime

Time

Mengecualikan objek yang dimodifikasi setelah waktu yang ditentukan. Waktu harus dalam format UTC. Contoh: 2006-01-02T15:04:05.

--max-size

SizeSuffix

Ukuran maksimum objek yang akan dipulihkan. Satuan default adalah byte. Anda dapat menggunakan akhiran seperti B, K, M, G, T, atau P. 1 K (KiB) sama dengan 1.024 byte.

--metadata-exclude

stringArray

Aturan pengecualian untuk metadata objek.

--metadata-filter

stringArray

Aturan filter untuk metadata objek.

--metadata-filter-from

stringArray

Membaca aturan filter untuk metadata objek dari sebuah file.

--metadata-include

stringArray

Aturan inklusi untuk metadata objek.

--min-size

SizeSuffix

Ukuran minimum objek yang akan dipulihkan. Satuan default adalah byte. Anda dapat menggunakan akhiran seperti B, K, M, G, T, atau P. 1 K (KiB) sama dengan 1.024 byte.

--page-size

int

Jumlah maksimum objek yang ditampilkan per halaman dalam operasi batch. Nilai default: 1000. Nilai valid: 1 hingga 1000.

-r, --recursive

/

Secara rekursif menjalankan operasi pada semua objek yang sesuai di bawah awalan yang ditentukan. Tanpa opsi ini, perintah hanya berlaku untuk objek yang ditentukan.

--request-payer

string

Menentukan pihak yang membayar permintaan. Atur nilai ini ke requester untuk bucket dalam mode Requester Pays.

--start-after

string

Menampilkan daftar objek yang secara alfabetis berada setelah nilai yang ditentukan, tidak termasuk nilai tersebut.

--version-id

string

ID versi objek.

--list-format

string

Format file daftar. Nilai valid: plain dan inventory.

--list-manifest-from

string

Membaca deskripsi format file daftar dari file manifest. Parameter ini wajib digunakan ketika --list-format diatur ke inventory.

Catatan

Untuk informasi selengkapnya, lihat Command-line options.

Contoh

Archive Storage

  • Perintah berikut memulihkan objek exampleobject.txt dari bucket examplebucket.

    ossutil restore oss://examplebucket/exampleobject.txt
  • Perintah berikut memulihkan objek exampleobject.txt dari bucket examplebucket dan mengatur durasi pemulihan menjadi 3 hari.

    ossutil restore oss://examplebucket/exampleobject.txt --days 3
  • Memulihkan objek dari file daftar.

    Catatan

    Setiap baris dalam file daftar menentukan satu objek dan menggunakan format path OSS oss://{bucket}/{key}. Sebagai contoh, file list.txt berisi:

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil restore list://list.txt
  • Memulihkan objek dari file daftar tanpa memeriksa status objek.

    ossutil restore list://list.txt --no-check-status 
  • Memulihkan objek dari file inventaris.

    Catatan

    Setelah pekerjaan inventaris selesai, file csv.gz dan file manifest.json akan dihasilkan. Kedua file ini diperlukan untuk memulihkan objek dari file inventaris.

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json
  • Memulihkan objek dari file inventaris 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

Cold Archive Storage

Perintah berikut memulihkan objek Cold Archive Storage exampleobject.txt dari bucket examplebucket dan mengatur durasi pemulihan menjadi 5 hari.

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

Perintah berikut secara rekursif memulihkan semua objek .csv dalam Cold Archive Storage dari awalan dir/ di bucket examplebucket. Durasi pemulihan diatur menjadi 5 hari.

ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Bulk --days 5

Deep Cold Archive Storage

Perintah berikut memulihkan objek Deep Cold Archive Storage exampleobject.txt dari bucket examplebucket dan mengatur durasi pemulihan menjadi 10 hari.

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

Perintah berikut secara rekursif memulihkan semua objek .csv dalam Deep Cold Archive Storage dari awalan dir/ di bucket examplebucket. Durasi pemulihan diatur menjadi 10 hari.

ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Standard --days 10

Penagihan

  • Biaya pengambilan data dikenakan saat Anda memulihkan objek Archive, Cold Archive, dan Deep Cold Archive. Untuk informasi selengkapnya, lihat Data processing fees.

  • Objek Archive dapat tetap dalam keadaan dipulihkan hingga 7 hari. Objek Cold Archive dan Deep Cold Archive dapat tetap dalam keadaan dipulihkan hingga 365 hari. Tidak ada biaya pengambilan data tambahan yang dikenakan selama periode ini.

  • Setelah masa keadaan dipulihkan berakhir, objek kembali ke status beku. Jika Anda memulihkan objek tersebut lagi, biaya pengambilan data akan dikenakan.

  • Ketika Anda memulihkan objek Cold Archive atau Deep Cold Archive, replika objek tersebut dibuat dalam kelas penyimpanan Standard untuk memungkinkan akses. Selama objek berada dalam keadaan dipulihkan, Anda dikenai biaya penyimpanan sementara replika tersebut sesuai laju kelas penyimpanan Standard. Untuk informasi selengkapnya, lihat Temporary storage fees.