すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:CloudBox 上の OSS バケットを作成する

最終更新日:Jun 28, 2025

CloudBox 上の Object Storage Service (OSS) を使用すると、ローカルデータを監視および処理できます。 CloudBox 上の OSS は、低レイテンシと複数ブランチの統合管理が必要なシナリオに適しています。 CloudBox 上の OSS を使用する前に、CloudBox 上の OSS バケットを作成する必要があります。

前提条件

  • CloudBox 上の OSS は、中国 (杭州)、中国 (上海)、中国 (深圳)、中国 (河源)、中国 (北京)、および中国 (成都) リージョンでのみサポートされています。

  • クラウドボックスが購入済みであること。 詳細については、「クラウドボックスを購入する」をご参照ください。

  • CloudBox 上の OSS に Virtual Private Cloud (VPC) と vSwitch が作成されていること。 詳細については、「VPC と vSwitch を作成する」をご参照ください。

  • VPC 内部ネットワークがセットアップされ、単一トンネルが設定されて安全な接続が提供されていること。 この機能を申請するには、technical support にお問い合わせください。

手順

OSS コンソールを使用する

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

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

  3. [バケットの作成] パネルで、パラメーターを指定し、[作成完了] をクリックします。 次の表にパラメーターを示します。

パラメーター

説明

バケット名

作成する CloudBox 上の OSS バケットの名前。 CloudBox 上の OSS バケットの名前は、次の要件を満たしている必要があります。

  • 指定した CloudBox 上の OSS バケットの名前は、クラウドボックス内の既存の CloudBox 上の OSS バケットの名前と同じにすることはできません。

  • 名前に使用できるのは、小文字、数字、およびハイフン (-) のみです。
  • 名前は小文字または数字で始まり、小文字または数字で終わる必要があります。
  • 名前は 3 ~ 63 文字である必要があります。

リージョン

購入したクラウドボックスが配置されているリージョン。

エンドポイント

CloudBox 上の OSS バケットへのアクセスに使用されるエンドポイント。 リージョンとクラウドボックスの ID を選択すると、エンドポイントが CloudBox 上の OSS バケットに自動的に関連付けられます。 エンドポイントは、コントロールエンドポイントとデータエンドポイントに分けられます。 コントロールエンドポイントは <Cloudbox-Id>.<Region>.oss-cloudbox-control.aliyuncs.com 形式で、データエンドポイントは <Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com 形式です。

ストレージクラス

CloudBox 上の OSS バケットのストレージクラス。 有効な値: 標準

冗長性

CloudBox 上の OSS バケットの冗長性タイプ。 有効な値: LRS

ACL

CloudBox 上の OSS バケットのアクセス制御リスト (ACL)。

  • 非公開: バケット所有者のみが、バケット内のオブジェクトに対して読み取りおよび書き込み操作を実行できます。 他のユーザーは、バケット内のオブジェクトにアクセスできません。
  • パブリック読み取り: バケット所有者のみが、バケット内のオブジェクトに対して書き込み操作を実行できます。 匿名ユーザーを含む他のユーザーは、バケット内のオブジェクトに対して読み取り操作のみを実行できます。
    警告 インターネット上のすべてのユーザーがバケット内のオブジェクトにアクセスできます。 これにより、バケット内のデータへの予期しないアクセスや、予期せず高額な料金が発生する可能性があります。 バケットの ACL をパブリック読み取りに設定する場合は注意してください。
  • パブリック読み取り/書き込み: 匿名ユーザーを含むすべてのユーザーが、バケット内のオブジェクトに対して読み取りおよび書き込み操作を実行できます。
    警告 インターネット上のすべてのユーザーがバケット内のオブジェクトにアクセスし、バケットにデータを書き込むことができます。 これにより、バケット内のデータへの予期しないアクセスや、予期せず高額な料金が発生する可能性があります。 ユーザーが禁止されているデータまたは情報をアップロードした場合、お客様の正当な利益と権利が侵害される可能性があります。 特殊な場合を除き、バケットの ACL をパブリック読み取り/書き込みに設定しないことをお勧めします。

Cloud Box ID

購入したクラウドボックスの ID。

バージョニング

バージョニングを有効にするかどうかを指定します。 有効な値:

  • 有効化: バケットのバージョニングを有効にすると、バケット内で上書きまたは削除されたオブジェクトは以前のバージョンとして保存されます。 バージョニングを使用すると、バケット内のオブジェクトを以前のバージョンに復元でき、データが誤って上書きまたは削除されるのを防ぐことができます。 詳細については、「バージョニング」をご参照ください。
  • 無効化: バケットのバージョニングを無効にすると、バケット内で上書きまたは削除されたオブジェクトは復元されません。

暗号化方法

CloudBox 上の OSS バケット内のオブジェクトの暗号化に使用される方法。 有効な値:

  • なし: サーバー側の暗号化は無効になっています。
  • OSS 管理: OSS によって管理されるキーを使用して、バケット内のオブジェクトが暗号化されます。 OSS はキーを使用してオブジェクトを暗号化します。 また、OSS はマスターキーを使用して暗号キーを暗号化します。

暗号化アルゴリズム: AES-256 のみがサポートされています。

OSS SDK for Java を使用する

CloudBox 上の OSS バケットは、OSS SDK for Java を使用することによってのみ作成できます。 OSS SDK for Java のバージョンは 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.CreateBucketRequest;
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 {
        // CloudBox 上の OSS バケットのデータエンドポイントを指定します。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 環境変数からアクセス認証情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // CloudBox 上の OSS バケットの名前を指定します。 例: examplebucket。
        String bucketName = "examplebucket";
        // CloudBox 上の OSS バケットが配置されているリージョンを指定します。
        String region = "cn-hangzhou";
        // クラウドボックスの 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)
                .cloudBoxId(cloudBoxId)
                .build();

        try {
            // CreateBucketRequest オブジェクトを作成します。
            CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName);            
                       
            // CloudBox 上の OSS バケットの ACL を public-read に設定します。 デフォルトの ACL は private です。
            //createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);

            // CloudBox 上の OSS バケットを作成します。
            ossClient.createBucket(createBucketRequest);
        } 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();
            }
        }
    }
}

ossutil を使用する

ossutil を使用して、CloudBox 上の OSS バケットを作成できます。 詳細については、「put-bucket」をご参照ください。

OSS API を使用する

ビジネスで高度なカスタマイズが必要な場合は、RESTful API を直接呼び出すことができます。 API を直接呼び出すには、コードに署名計算を含める必要があります。 詳細については、「PutBucket」をご参照ください。