全部產品
Search
文件中心

Object Storage Service:刪除檔案(Harmony SDK)

更新時間:Nov 29, 2025

本文介紹如何使用OSS Harmony SDK刪除指定的單個檔案和刪除指定的多個檔案。

注意事項

範例程式碼

刪除單個檔案

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();