赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 操作指南
  5. OSS ON云盒
  6. OSS ON云盒支持的Bucket操作
  7. 基础设置
  8. 创建云盒Bucket

创建云盒Bucket

  • 基础设置
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

通过OSS ON云盒,您可以对本地数据进行数据监控、数据处理等操作。OSS ON云盒适用于业务要求低延时、多分支机构统一管理等场景。使用OSS ON云盒之前,您需要创建云盒Bucket。

前提条件

  • 仅华东1(杭州)、华东2(上海)、华南1(深圳)、华南2(河源)、华北2(北京)、西南1(成都)地域支持使用OSS ON云盒服务。

  • 已购买云盒。

  • 已在云盒内创建专有网络VPC和交换机。

  • 已联系技术支持申请创建云盒VPC内网SingleTunnel网络类型。

操作步骤

使用OSS控制台

  1. 登录OSS管理控制台。

  2. 在左侧导航栏,选择数据服务 > 云盒Bucket,然后单击创建Bucket。

  3. 在创建Bucket页面,按如下说明配置各项参数,然后单击完成创建。

    参数

    说明

    Bucket名称

    填写Bucket名称。命名规则如下:

    • 指定的Bucket名称不能与云盒中已存在Bucket名称重复。

    • 只能包括小写字母、数字和短划线(-)。
    • 必须以小写字母或者数字开头和结尾。
    • 长度必须在3~63字符之间。

    地域

    选择已购买的云盒资源所在地域。

    Endpoint

    选择地域与云盒ID后自动关联Endpoint。Endpoint分为管控域名(格式为<Cloudbox-Id>.<Region>.oss-cloudbox-control.aliyuncs.com)和数据域名(格式为<Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com)两种。

    存储类型

    仅支持标准存储。

    存储冗余类型

    仅支持本地冗余存储。

    读写权限

    选择Bucket内Object的读写权限。

    • 私有(private):只有该存储空间的拥有者可以对该存储空间内的文件进行读写操作,其他人无法访问该存储空间内的文件。
    • 公共读(public-read):只有该存储空间的拥有者可以对该存储空间内的文件进行写操作,任何人(包括匿名访问者)可以对该存储空间中的文件进行读操作。
      警告 互联网上任何用户都可以对该Bucket内文件进行访问,这有可能造成您数据的外泄以及费用激增,请谨慎操作。
    • 公共读写(public-read-write):任何人(包括匿名访问者)都可以对该存储空间内文件进行读写操作。
      警告 互联网上任何用户都可以对该Bucket内的文件进行访问,并且向该Bucket写入数据。这有可能造成您数据的外泄以及费用激增,若被人恶意写入违法信息还可能会侵害您的合法权益。除特殊场景外,不建议您配置公共读写权限。

    云盒ID

    选择已购买的云盒ID。

    版本控制

    选择是否开通版本控制功能。

    • 开通:开通Bucket版本控制功能后,针对数据的覆盖和删除操作将会以历史版本的形式保存下来。当您在错误覆盖或者删除Object后,能够将Bucket中存储的Object恢复至任意时刻的历史版本。更多详情请参见版本控制。
    • 不开通:不开通版本控制功能,则不保存覆盖或删除的数据。

    服务端加密方式

    选择服务器端加密方式。

    • 无:不启用服务器端加密。

    • OSS完全托管:使用OSS托管的密钥进行加密。OSS会为每个Object使用不同的密钥进行加密,作为额外的保护,OSS会使用主密钥对加密密钥本身进行加密。

    加密算法仅支持AES256。

使用阿里云SDK

仅支持通过Java SDK创建云盒Bucket,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.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 {
        // 填写云盒Bucket的数据域名。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前,请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写云盒Bucket名称,例如examplebucket。
        String bucketName = "examplebucket";
        // 填写云盒Bucket所在地域。
        String region = "cn-hangzhou";
        // 填写云盒ID。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";


        // 创建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 {
            // 创建CreateBucketRequest对象。
            CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName);            
                       
            // 设置云盒Bucket的读写权限为公共读,默认为私有。
            //createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);

            // 创建云盒Bucket。
            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创建云盒Bucket的具体步骤,请参见mb(创建存储空间)。

使用REST API

如果您的程序自定义要求较高,您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息,请参见PutBucket。

相关文章

创建云盒Bucket 2025-04-21 18:15

通过OSS ON云盒,您可以对本地数据进行数据监控、数据处理等操作。OSS ON云盒适用于业务要求低延时、多分支机构统一管理等场景。使用OSS ON云盒之前,您需要创建云盒Bucket。 前提条件

服务器端加密 2025-04-21 18:15

OSS ON云盒支持服务器端加密功能。开启服务器端加密后,OSS对在云盒Bucket中上传的Object进行加密,再将得到的加密Object持久化保存。下载Object时,OSS自动将加密Object解密后返回给用户,并在返回的HTTP请求Header中,声明该Object进行了服务器端加密。

生命周期规则 2025-04-21 18:15

您可以创建基于最后一次修改时间(Last Modified Time)的生命周期规则(Lifecycle),定期将云盒Bucket内的Object和碎片删除,从而节省存储费用。 前提条件

列举云盒Bucket 2025-04-21 18:15

云盒Bucket按字母序排列。您可以结合实际场景列举某个云盒ID下的所有云盒Bucket、指定前缀的云盒Bucket、指定个数的云盒Bucket等。 前提条件

获取云盒Bucket信息 2025-04-21 18:15

您可以通过GetBucketInfo接口查看云盒Bucket的信息,包括云盒Bucket的创建时间、读写权限、拥有者信息等。

静态网站托管 2025-04-21 18:15

静态网站由静态内容构成。您可以通过静态网站托管功能将网站托管到云盒Bucket,并使用Bucket的访问域名访问网站。 前提条件

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号