Object Storage Service:バケットの削除

使用上の注意

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

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

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

前提条件

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

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

  重要

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

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

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

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

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

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

  説明

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

例

次のサンプルコードは、examplebucketという名前のバケットを削除する方法を示しています。

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* Initialize information about the account that is used to access OSS. */
    
    /* 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. */
    std::string Endpoint = "yourEndpoint";
    
    /* 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. */
    std::string Region = "yourRegion";
    
    /* Specify the name of the bucket. Example: examplebucket. */
    std::string BucketName = "examplebucket";

    /* Initialize resources, such as network resources. */
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* 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. */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    /* Delete the bucket. */
    DeleteBucketRequest request(BucketName);
   
    auto outcome = client.DeleteBucket(request);

    if (outcome.isSuccess()) {
    std::cout << "Delete bucket successfully." << std::endl;
    } else {
    std::cout << "Failed to delete bucket. Error code: " << outcome.error().Code()
              << ", Message: " << outcome.error().Message()
              << ", RequestId: " << outcome.error().RequestId() << std::endl;
    }

    /* Release resources, such as network resources. */
    ShutdownSdk();
    return 0;
}

関連ドキュメント

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

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