すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS SDK for PHPを使用したバケットの削除

最終更新日:Oct 30, 2024

OSS (Object Storage Service) バケットを使用しなくなった場合は、バケットを削除して不要な課金を防ぐことができます。

警告

削除されたバケットは復元できません。 バケットを削除する前に、バケット内のデータが不要になったことを確認してください。 バケット内のデータを引き続き使用する場合は、事前にデータをバックアップしてください。 詳細については、「バケットのバックアップ」をご参照ください。

前提条件

  • バケットのアクセスポイントが削除されます。 詳細については、「概要」をご参照ください。

  • バケット内のすべてのオブジェクトが削除されます。

    重要

    バージョン管理されたバケットを削除するには、バケット内のオブジェクトの現在のバージョンと以前のバージョンがすべて削除されていることを確認します。 詳細については、「概要」をご参照ください。

    • バケットに含まれるオブジェクトの数が少ない場合は、手動で削除することを推奨します。 詳細については、「オブジェクトの削除」をご参照ください。

    • バケットに多数のオブジェクトが含まれている場合は、オブジェクトを削除するようにライフサイクルルールを設定することを推奨します。 詳細については、「概要」をご参照ください。

  • バケット内のマルチパートアップロードまたは再開可能アップロードタスクによって生成されたパーツは削除されます。 詳細については、「パーツの削除」をご参照ください。

  • バケット内のすべてのLiveChannelsが削除されます。 詳細については、「DeleteLiveChannel」をご参照ください。

  • RAMユーザーを使用してバケットを削除する場合は、RAMユーザーにoss:DeleteBucket権限が付与されます。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

    説明

    RAMユーザーがRAMポリシーでoss:DeleteBucket権限を持っていてもバケットを削除できない場合、バケットポリシーにはoss:DeleteBucket権限が含まれており、その効果はDenyです。 この場合、拒否を許可に変更するか、バケットポリシーを削除する必要があります。 その後、バケットを削除できます。

使用上の注意

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョン、エンドポイント、オープンポート」をご参照ください。

  • このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSecurity Token Service (STS) を使用してOSSClientインスタンスを作成する場合は、「OSSClientインスタンスの作成」をご参照ください。

  • バケットを削除するには、oss:DeleteBucket権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

次のサンプルコードは、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;

// Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
$provider = new EnvironmentVariableCredentialsProvider();
// Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. 
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// Specify the name of the bucket. Example: 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");        

関連ドキュメント

  • バケットの削除に使用される完全なサンプルコードについては、『GitHub』をご参照ください。

  • バケットを削除するために呼び出すことができるAPI操作の詳細については、「DeleteBucket」をご参照ください。