Object Storage Service:CloudBox のバージョン管理

• クラウドボックスの OSS バケットを作成するときにバージョン管理を有効にする

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

  2. 左側のナビゲーションウィンドウで、データサービス > CloudBox Bucket を選択し、左上隅にある [バケットの作成] をクリックします。

  3. [バケットの作成] ページで、パラメーターを設定します。

     [バージョン管理] セクションで、[有効化] を選択します。他のパラメーターの設定方法の詳細については、「クラウドボックスの OSS バケットの作成」をご参照ください。

  4. [OK] をクリックします。

• 既存のクラウドボックスの OSS バケットのバージョン管理を有効にする

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

  2. 左側のナビゲーションウィンドウで、[データセキュリティ] > [バージョン管理] を選択します。

  3. [バージョン管理] の右側にある [有効化] をクリックします。

Java software development kit (SDK) を使用してバージョン管理を有効にできます。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.*;
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 インスタンスが不要になったら、シャットダウンメソッドを呼び出してリソースを解放します。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
                .clientConfiguration(conf)
                .region(region)
                .cloudBoxId(cloudBoxId)
                .build();

        try {
            // バケットのバージョン管理状態を Enabled に設定します。
            BucketVersioningConfiguration configuration = new BucketVersioningConfiguration();
            configuration.setStatus(BucketVersioningConfiguration.ENABLED);
            SetBucketVersioningRequest request = new SetBucketVersioningRequest(bucketName, configuration);
            ossClient.setBucketVersioning(request);
        } catch (OSSException oe) {
            System.out.println("OSSException がキャッチされました。これは、リクエストは OSS に到達しましたが、"
                    + "何らかの理由でエラー応答で拒否されたことを意味します。");
            System.out.println("エラーメッセージ:" + oe.getErrorMessage());
            System.out.println("エラーコード:" + oe.getErrorCode());
            System.out.println("リクエスト ID:" + oe.getRequestId());
            System.out.println("ホスト ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("ClientException がキャッチされました。これは、クライアントが OSS との通信中に、"
                    + "ネットワークにアクセスできないなど、深刻な内部問題に遭遇したことを意味します。");
            System.out.println("エラーメッセージ:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

ossutil コマンドラインインターフェイスを使用して、指定したバケットのバージョン管理状態を設定できます。ossutil のインストール方法の詳細については、「ossutil のインストール」をご参照ください。

次のコマンドは、指定したバケットのバージョン管理を有効にします。

ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration "{\"Status\":\"Enabled\"}"

このコマンドの詳細については、「put-bucket-versioning」をご参照ください。

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

2. 左側のナビゲーションウィンドウで、[フォールトトレランスのための冗長性] > [バージョン管理] を選択します。

Java SDK を使用してバージョン管理を一時停止できます。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.*;
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 バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを cn-hangzhou に設定します。
        String region = "cn-hangzhou";
        // CloudBox ID を指定します。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";

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

        try {
            // バケットのバージョン管理状態を Suspended に設定します。
            BucketVersioningConfiguration configuration = new BucketVersioningConfiguration();
            configuration.setStatus(BucketVersioningConfiguration.SUSPENDED);
            SetBucketVersioningRequest request = new SetBucketVersioningRequest(bucketName, configuration);
            ossClient.setBucketVersioning(request);
        } catch (OSSException oe) {
            System.out.println("OSSException がキャッチされました。これは、リクエストは OSS に到達しましたが、"
                    + "何らかの理由でエラー応答で拒否されたことを意味します。");
            System.out.println("エラーメッセージ:" + oe.getErrorMessage());
            System.out.println("エラーコード:" + oe.getErrorCode());
            System.out.println("リクエスト ID:" + oe.getRequestId());
            System.out.println("ホスト ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("ClientException がキャッチされました。これは、クライアントが OSS との通信中に、"
                    + "ネットワークにアクセスできないなど、深刻な内部問題に遭遇したことを意味します。");
            System.out.println("エラーメッセージ:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

ossutil コマンドラインインターフェイスを使用して、指定したバケットのバージョン管理状態を設定できます。ossutil のインストール方法の詳細については、「ossutil のインストール」をご参照ください。

次のコマンドは、指定したバケットのバージョン管理を一時停止します。

ossutil api put-bucket-versioning --bucket examplebucket --versioning-configuration "{\"Status\":\"Suspended\"}"

このコマンドの詳細については、「put-bucket-versioning」をご参照ください。