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という名前のバケットを削除する方法を示しています。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;

public class Demo {

    public static void main(String[] args) throws Exception {
        // In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. 
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 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. 
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // Specify the name of the bucket. Example: examplebucket. 
        String bucketName = "examplebucket";
        // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
        String region = "cn-hangzhou";
        
        // Create an OSSClient instance. 
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);        
        OSS ossClient = OSSClientBuilder.create()
        .endpoint(endpoint)
        .credentialsProvider(credentialsProvider)
        .clientConfiguration(clientBuilderConfiguration)
        .region(region)               
        .build();

        try {
            // Delete the bucket. 
            ossClient.deleteBucket(bucketName);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
} 

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

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