Object Storage Service:ライフサイクルルール

1. OSS コンソールにログインします。

2. 左側のナビゲーションウィンドウで、データサービス > CloudBox Bucket を選択します。次に、バケットリストでターゲットバケットの名前をクリックします。

3. 左側のナビゲーションウィンドウで、[Data Management] > [ライフサイクル] を選択します。

4. [ルールの作成] をクリックします。[ライフサイクルルールの作成] パネルで、次の表の説明に従ってライフサイクルルールを設定します。

   • クラウドボックスの OSS バケットでバージョン管理が無効になっている場合

     エリア	設定項目	説明
     基本設定	ステータス	ライフサイクルルールのステータスを指定します。有効な値: 有効 および 無効。
     	ポリシー	ライフサイクルルールを適用するオブジェクトを指定します。有効な値: 指定されたプレフィックスを持つファイル および バケット全体。
     	プレフィックス	一致させるオブジェクト名のプレフィックスを入力します。たとえば、名前が img で始まるオブジェクトを一致させるには、img と入力します。
     パージポリシー	ファイルの有効期限ポリシー	オブジェクトがいつ期限切れになるかを指定するルールを設定します。有効な値: 有効期間 (日数)、有効期限日、および 無効。無効 を選択した場合、ファイルライフサイクルの設定は有効になりません。
     	ファイルの削除	期限切れのオブジェクトを削除するルールを設定します。 たとえば、有効期限日 を 2022 年 9 月 24 日に設定し、この日より前のデータが自動的に削除されるように指定した場合、2022 年 9 月 24 日より前に最終更新されたオブジェクトは自動的に削除され、回復できなくなります。
     パートのクリーンアップ	パートの有効期限ポリシー	期限切れのパートに対して実行する操作を設定します。パートの有効期限ポリシーには 有効期限 (日数) または 有効期限日 を選択するか、無効 を選択できます。無効 を選択した場合、パートの有効期限ポリシーは有効になりません。 重要 各ライフサイクルルールには、オブジェクトの有効期限ポリシーとパートの有効期限ポリシーの少なくとも 1 つが含まれている必要があります。
     	パートの削除	パートライフサイクルの値に基づいてパートがいつ期限切れになるかを指定します。期限切れのパートは自動的に削除され、回復できません。

   • クラウドボックスの OSS バケットでバージョン管理が有効になっている場合

     バージョン管理を有効にすると、[基本設定] および [パートのクリーンアップ] エリアの設定項目は、バージョン管理が無効な場合と同じになります。次の表では、異なる設定項目のみを説明します。

     エリア	設定項目	説明
     現在のバージョン	期限切れのオブジェクト削除マーカーのクリーンアップ	バケットのバージョン管理を有効にすると、[削除マーカーのクリーンアップ] パラメーターを設定できます。その他のパラメーターは、バージョン管理されていないバケットで設定できるものと同じです。 削除マーカーのクリーンアップ を選択し、オブジェクトに削除マーカーであるバージョンが 1 つしかない場合、OSS はその削除マーカーを期限切れとみなし、削除マーカーを削除します。オブジェクトに複数のバージョンがあり、オブジェクトの現在のバージョンが削除マーカーである場合、OSS は削除マーカーを保持します。削除マーカーの詳細については、「削除マーカー」をご参照ください。
     以前のバージョン	ファイルの有効期限ポリシー	以前のバージョンがいつ期限切れになるかを指定します。有効な値: 有効期間 (日数) および 無効。無効 を選択した場合、ファイルライフサイクルは有効になりません。
     	ファイルの削除	有効期限までの日数 N を設定します。オブジェクトの以前のバージョンは、以前のバージョンになってから N 日後に期限切れになり、期限切れの翌日に削除されます。たとえば、これを 30 に設定した場合、2021 年 9 月 1 日に以前のバージョンになったオブジェクトは、2021 年 10 月 1 日に削除されます。 重要 オブジェクトの次のバージョンが最後に変更された時間に基づいて、オブジェクトがいつ以前のバージョンになるかを判断できます。

ライフサイクルルールは、SDK for Java を使用してのみ設定できます。SDK のバージョンは 3.15.0 以降である必要があります。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.LifecycleRule;
import com.aliyun.oss.model.SetBucketLifecycleRequest;
import java.util.List;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;

public class Demo {

    public static void main(String[] args) throws Exception {
        // クラウドボックスの OSS バケットのデータエンドポイントを指定します。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 環境変数からアクセス資格情報を取得します。このサンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // クラウドボックスの OSS バケットの名前を指定します。例: examplebucket。
        String bucketName = "examplebucket";
        // クラウドボックスの OSS バケットが配置されているリージョンを指定します。
        String region = "cn-hangzhou";
        // CloudBox の ID を指定します。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";

        // OSSClient インスタンスを作成します。
        // OSSClient インスタンスが不要になったら、shutdown メソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
                .clientConfiguration(conf)
                .region(region)
                .build();

        try {
            // SetBucketLifecycleRequest を作成します。
            SetBucketLifecycleRequest request = new SetBucketLifecycleRequest(bucketName);

            // ルール ID を設定します。
            String ruleId0 = "rule0";
            // プレフィックスが空のままの場合、ルールはバケット内のすべてのオブジェクトに適用されます。
            String matchPrefix0 = null;

            // 最終更新から 3 日後にオブジェクトを期限切れにします。
            LifecycleRule rule = new LifecycleRule(ruleId0, matchPrefix0, LifecycleRule.RuleStatus.Enabled, 3);
            request.AddLifecycleRule(rule);

            // ライフサイクルルールを設定するリクエストを送信します。
            ossClient.setBucketLifecycle(request);

            // ライフサイクルルールを表示します。
            List<LifecycleRule> listRules = ossClient.getBucketLifecycle(bucketName);
            for(LifecycleRule rules : listRules){
                System.out.println("ruleId="+rules.getId()+", matchPrefix="+rules.getPrefix()+", expirationDays="+rules.getExpirationDays());
            }
        } 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();
            }
        }
    }
}