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 izinoss:RestoreObjectdanoss: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 |
|
--tier |
string |
Prioritas pemulihan. Parameter ini tidak diperlukan untuk objek Archive Storage karena pemulihan berlangsung sekitar satu menit.
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 |
|
--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 Catatan
|
|
--max-age |
Duration |
Mengecualikan objek yang lebih lama dari nilai yang ditentukan. Satuan default adalah detik. Anda juga dapat menggunakan akhiran satuan, seperti |
|
--min-mtime |
Time |
Mengecualikan objek yang dimodifikasi sebelum waktu yang ditentukan. Waktu harus dalam format UTC. Contoh: 2006-01-02T15:04:05. Catatan
|
|
--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 |
|
--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 |
Untuk informasi selengkapnya, lihat Command-line options.
Contoh
Archive Storage
-
Perintah berikut memulihkan objek
exampleobject.txtdari bucketexamplebucket.ossutil restore oss://examplebucket/exampleobject.txt -
Perintah berikut memulihkan objek
exampleobject.txtdari bucketexamplebucketdan mengatur durasi pemulihan menjadi 3 hari.ossutil restore oss://examplebucket/exampleobject.txt --days 3 -
Memulihkan objek dari file daftar.
CatatanSetiap baris dalam file daftar menentukan satu objek dan menggunakan format path OSS
oss://{bucket}/{key}. Sebagai contoh, filelist.txtberisi:oss://examplebucket/key1 oss://examplebucket/key2ossutil 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.
CatatanSetelah pekerjaan inventaris selesai, file
csv.gzdan filemanifest.jsonakan 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.