歸檔或冷歸檔類型的Object需要解凍(Restore)之後才能讀取。本文介紹如何解凍歸檔和冷歸檔Object。
說明
非歸檔或非冷歸檔類型的Object,請勿調用RestoreObject方法。
解凍歸檔Object
以下代碼用於解凍歸檔Object:
const OSS = require('ali-oss')
const client = new OSS({
//yourRegion填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
region: 'yourRegion',
// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
//填寫Bucket名稱,例如examplebucket。
bucket: 'examplebucket',
});
//填寫待解凍的歸檔類型Object名稱,例如exampleobject.txt。
client.restore('exampleobject.txt').then((res) => {
console.log(res);
}).catch(err => {
console.log(err);
})
解凍冷歸檔Object
以下代碼用於解凍冷歸檔Object:
const OSS = require('ali-oss')
const client = new OSS({
// yourRegion填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
region: 'yourRegion',
// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// 填寫Bucket名稱,例如examplebucket。
bucket: 'examplebucket',
});
const restoreOptions = {
// 指定為冷歸檔類型ColdArchive。
type: 'ColdArchive',
//JobParameters用於指定解凍優先順序。
//高優先順序(Expedited):表示1小時內完成解凍。
//標準(Standard):表示2~5小時內完成解凍。如果不傳入JobParameters節點,則預設為Standard。
//批量(Bulk):表示5~12小時內完成解凍。
JobParameters: 'Bulk',
//Days用於指定解凍的天數。取值範圍為1~7天。
Days: 2,
};
client.restore('exampleobject.txt', restoreOptions)
.then(res => {
console.log(res);
})
.catch(err => {
console.log(err);
});
相關文檔
關於解凍歸檔以及冷歸檔Object的完整範例程式碼,請參見GitHub樣本。
關於解凍歸檔以及冷歸檔Object的API介面說明,請參見RestoreObject。