在OSS ON雲盒中建立Bucket-Object Storage Service-阿里雲

通過OSS ON雲盒，您可以對本機資料進行資料監控、資料處理等操作。OSS ON雲盒適用於業務要求低延時、多分公司統一管理等情境。使用OSS ON雲盒之前，您需要建立雲盒Bucket。

前提條件

僅華東1（杭州）、華東2（上海）、華南1（深圳）、華南2（河源）、華北2（北京）、西南1（成都）地區支援使用OSS ON雲盒服務。
已購買雲盒。
已在雲盒內建立Virtual Private Cloud和交換器。
已聯絡OSS管理主控台。
在左側導覽列，選擇資料服務 > 雲盒Bucket，然後單擊建立Bucket。

在建立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執行個體。
        // 當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);            
                       
            // 設定雲盒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的具體步驟，請參見put-bucket。

使用REST API

如果您的程式自訂要求較高，您可以直接發起REST API請求。直接發起REST API請求需要手動編寫代碼計算簽名。更多資訊，請參見PutBucket。