全部產品
Search
文件中心

Object Storage Service:刪除儲存空間(PHP SDK V1)

更新時間:Nov 28, 2025

當儲存空間(Bucket)不再需要或希望停止計費時,應刪除該Bucket。由於OSS的費用主要來源於Bucket內部資源,而刪除Bucket前系統強制要求清空所有內部資源,因此刪除Bucket是確保您不會遺漏任何計費資源而產生意外費用的最可靠方式。請注意,刪除後資料無法恢複,且Bucket名稱釋放後存在被他人佔用的風險。若要完全停用整個OSS服務,則需刪除您帳號下的所有Bucket。

警告
  • 刪除Bucket後,該Bucket名稱會被釋放,刪除的Bucket名稱存在被其他人佔用的風險。若需保留名稱,建議您清空Bucket內容而非刪除Bucket。

  • 刪除Bucket後,Bucket中的資料無法恢複,請在刪除前確認資料已不再使用。如果需要繼續使用Bucket中的資料,請提前做好備份。關於備份的更多資訊,請參見資料保護概述

刪除Bucket前需要清理的資源

刪除Bucket前要清理資源,大部分使用者往往Bucket中只有檔案,少量使用者使用了進階功能會涉及其他配置項。OSS控制台支援自動檢測需要清理的資源,建議刪除儲存空間清理。

  • (大部分使用者涉及清理的資源)Bucket中的所有檔案。

    如果檔案數量較少,可以選擇刪除檔案。如果檔案數量較多,可以選擇生命週期。此外,如果Bucket開啟了版本控制,需要清理所有目前的版本和歷史版本的檔案。

  • (少量使用者使用了進階功能涉及清理的配置項)

注意事項

  • 本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見地區和Endpoint

  • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見建立OssClient

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予操作許可權。

API

Action

說明

DeleteBucket

oss:DeleteBucket

刪除Bucket。

範例程式碼

以下代碼用於刪除儲存空間examplebucket:

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}

use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱,例如examplebucket。
$bucket= "examplebucket";

try{
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);

    $ossClient->deleteBucket($bucket);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");        

相關文檔

  • 關於刪除Bucket的完整範例程式碼,請參見GitHub樣本

  • 關於刪除Bucket的API介面說明,請參見DeleteBucket