本文介紹如何使用OSS Harmony SDK刪除指定的單個檔案和刪除指定的多個檔案。
注意事項
關於OSS支援的Region與Endpoint的對應關係,請參見地區和Endpoint。
要刪除檔案,您必須具有
oss:DeleteObject許可權。具體操作,請參見為RAM使用者授予自訂的權限原則。
範例程式碼
刪除單個檔案
import Client, { RequestError } from '@aliyun/oss';
// 建立OSS用戶端執行個體
const client = new Client({
// 請替換為STS臨時訪問憑證的Access Key ID
accessKeyId: 'yourAccessKeyId',
// 請替換為STS臨時訪問憑證的Access Key Secret
accessKeySecret: 'yourAccessKeySecret',
// 請替換為STS臨時訪問憑證的Security Token
securityToken: 'yourSecurityToken',
// 填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou
region: 'oss-cn-hangzhou',
});
// 指定要操作的Bucket名稱,請替換為您實際使用的Bucket名稱
const bucket = 'yourBucketName';
// 指定要刪除的對象(檔案)名稱,請替換為您實際要刪除的對象名稱
const key = 'yourObjectName';
/**
* 刪除指定的對象。
* 使用deleteObject方法刪除指定Bucket中的對象。
*/
const deleteObject = async () => {
try {
// 調用deleteObject方法刪除指定Bucket中的對象
const res = await client.deleteObject({
bucket, // Bucket名稱
key, // 對象(檔案)名稱
});
// 列印刪除結果
console.log(JSON.stringify(res));
} catch (err) {
// 捕獲請求過程中的異常資訊
if (err instanceof RequestError) {
// 如果是已知類型的錯誤,則列印錯誤碼、錯誤訊息、請求ID、狀態代碼、EC碼等資訊
console.log('code: ', err.code); // 錯誤碼
console.log('message: ', err.message); // 錯誤訊息
console.log('requestId: ', err.requestId); // 請求ID
console.log('status: ', err.status); // HTTP狀態代碼
console.log('ec: ', err.ec); // 錯誤碼
} else {
// 列印其他未知類型的錯誤
console.log('unknown error: ', err);
}
}
};
// 調用deleteObject函數執行刪除對象的操作
deleteObject();
刪除多個檔案
import Client, { RequestError } from '@aliyun/oss';
// 建立OSS用戶端執行個體
const client = new Client({
// 請替換為STS臨時訪問憑證的Access Key ID
accessKeyId: 'yourAccessKeyId',
// 請替換為STS臨時訪問憑證的Access Key Secret
accessKeySecret: 'yourAccessKeySecret',
// 請替換為STS臨時訪問憑證的Security Token
securityToken: 'yourSecurityToken',
// 填寫Bucket所在地區。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou
region: 'oss-cn-hangzhou',
});
// 指定要操作的Bucket名稱,請替換為您實際使用的Bucket名稱
const bucket = 'yourBucketName';
/**
* 大量刪除對象。
* 使用deleteMultipleObjects方法大量刪除指定Bucket中的多個對象。
*/
const deleteMultipleObjects = async () => {
try {
// 調用deleteMultipleObjects方法大量刪除指定Bucket中的多個對象
const res = await client.deleteMultipleObjects({
bucket, // Bucket名稱
delete: {
// 指定要刪除的對象列表,每個對象通過其key標識
object: [
{ key: 'yourObjectName1' }, // 對象1的名稱,請替換為您實際要刪除的對象名稱
{ key: 'yourObjectName2' }, // 對象2的名稱,請替換為您實際要刪除的對象名稱
{ key: 'yourObjectName3' }, // 對象3的名稱,請替換為您實際要刪除的對象名稱
],
},
});
// 列印大量刪除結果
console.log(JSON.stringify(res));
} catch (err) {
// 捕獲請求過程中的異常資訊
if (err instanceof RequestError) {
// 如果是已知類型的錯誤,則列印錯誤碼、錯誤訊息、請求ID、狀態代碼、EC碼等資訊
console.log('code: ', err.code); // 錯誤碼
console.log('message: ', err.message); // 錯誤訊息
console.log('requestId: ', err.requestId); // 請求ID
console.log('status: ', err.status); // HTTP狀態代碼
console.log('ec: ', err.ec); // 錯誤碼
} else {
// 列印其他未知類型的錯誤
console.log('unknown error: ', err);
}
}
};
// 調用deleteMultipleObjects函數執行大量刪除對象的操作
deleteMultipleObjects();