PHP 2.0 向け OSS SDK を使用したバケットの削除 - Object Storage Service

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

使用上の注意

このトピックのサンプルコードでは、中国 (杭州) リージョンのリージョン ID cn-hangzhou を使用しています。デフォルトでは、パブリックエンドポイントを使用してバケット内のリソースにアクセスします。バケットが配置されているのと同じリージョン内の他の Alibaba Cloud サービスを使用してバケット内のリソースにアクセスする場合は、内部エンドポイントを使用します。OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
バケット名は一意です。バケットが削除されると、その名前は他のユーザーが使用できるようになります。名前を引き続き使用する場合は、バケットを削除するのではなく空にすることをお勧めします。
削除されたバケットは復元できません。バケットを削除する前に、バケット内のデータが不要になったことを確認してください。バケット内のデータを引き続き使用する場合は、事前にデータをバックアップしてください。詳細については、「バケットのバックアップ」をご参照ください。
バケットを削除するには、oss:DeleteBucket 権限が必要です。詳細については、「RAM ユーザーへのカスタムポリシーのアタッチ」をご参照ください。

前提条件

バケット内のすべてのオブジェクトが削除されていること。
重要
バージョン管理が有効になっているバケットを削除するには、バケット内のすべての現在および以前のバージョンのオブジェクトが削除されていることを確認してください。詳細については、「バージョン管理」をご参照ください。
- バケットに少数のオブジェクトが含まれている場合は、手動で削除することをお勧めします。詳細については、「オブジェクトの削除」をご参照ください。
- バケットに多数のオブジェクトが含まれている場合は、ライフサイクルルールを構成してオブジェクトを削除することをお勧めします。詳細については、「ライフサイクル」をご参照ください。
バケット内のマルチパートアップロードまたは再開可能なアップロードタスクによって生成されたパーツが削除されていること。詳細については、「パーツの削除」をご参照ください。
RAM ユーザーを使用してバケットを削除するには、RAM ユーザーに oss:DeleteBucket 権限を付与する必要があります。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
説明
RAM ユーザーが RAM ポリシーで oss:DeleteBucket 権限を持っているにもかかわらずバケットを削除できない場合は、バケットポリシーに効果が「拒否」の oss:DeleteBucket 権限が含まれている可能性があります。この場合は、「拒否」を「許可」に変更するか、バケットポリシーを削除する必要があります。その後、バケットを削除できます。

例

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

<?php

require_once __DIR__ . '/../vendor/autoload.php'; // オブジェクトと依存ライブラリを自動的にロードします。

use AlibabaCloud\Oss\V2 as Oss;

// コマンドラインパラメータを指定します。
$optsdesc = [
    "region" => ['help' => 'バケットが配置されているリージョン。', 'required' => True], // (必須) バケットが配置されているリージョンを指定します。例: oss-cn-hangzhou。
    "endpoint" => ['help' => '他のサービスが OSS にアクセスするために使用できるドメイン名。', 'required' => False], // (オプション) 他のサービスが OSS にアクセスするために使用できるエンドポイントを指定します。
    "bucket" => ['help' => 'バケットの名前', 'required' => True], // (必須) バケットの名前を指定します。
];
$longopts = \array_map(function ($key) {
    return "$key:"; // 各パラメータの末尾にコロン (:) を追加して、値が必要であることを示します。
}, array_keys($optsdesc));

// コマンドラインパラメータを解析します。
$options = getopt("", $longopts); 

// 必須パラメータが構成されているかどうかを確認します。
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help'];
        echo "Error: the following arguments are required: --$key, $help"; // 必須パラメータが構成されていないことを指定します。
        exit(1); 
    }
}

// コマンドラインパラメータの値を取得します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // バケットの名前。

// 環境変数を使用して認証情報 (AccessKey ID と AccessKey シークレット) をロードします。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider(); 

// SDK のデフォルト構成を使用します。
$cfg=Oss\Config::loadDefault(); // SDK のデフォルト構成をロードします。
$cfg->setCredentialsProvider($credentialsProvider); // 認証プロバイダーを指定します。
$cfg->setRegion($region); // リージョンを指定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // エンドポイントが提供されている場合は、エンドポイントを指定します。
}

// OSSClient インスタンスを作成します。
$client = new Oss\Client($cfg); 

// バケットを削除するリクエストを作成します。
$request = new Oss\Models\DeleteBucketRequest($bucket); 

// deleteBucket メソッドを使用してバケットを削除します。
$result = $client->deleteBucket($request); 

// 返された結果を表示します。
printf(
    'status code:' . $result-> statusCode. PHP_EOL . // HTTP 応答ステータスコード。
    'request id:' . $result->requestId // リクエストの一意の識別子。
);