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 izinoss:RestoreObjectdanoss: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.
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
|
--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
|
--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. |
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.txtContoh berikut menunjukkan cara memulihkan objek Archive bernama exampleobject.txt di examplebucket dengan durasi pemulihan selama 3 hari:
ossutil restore oss://examplebucket/exampleobject.txt --days 3Contoh berikut menunjukkan cara memulihkan objek dari daftar.
CatatanSetiap 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/key2ossutil restore list://list.txtContoh berikut menunjukkan cara memulihkan objek langsung dari daftar tanpa memeriksa status objek:
ossutil restore list://list.txt --no-check-statusContoh berikut menunjukkan cara memulihkan objek dari file daftar.
CatatanFile 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.jsonContoh 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 5Pemulihan 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 10Aturan 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.