本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業(yè)務造成影響,請務必仔細閱讀。
在上傳文件(Object)到OSS之前,您需要創(chuàng)建一個用于存儲文件的存儲空間(Bucket)。存儲空間具有各種配置屬性,包括訪問權限、存儲類型等。您可以根據實際需求,創(chuàng)建不同類型的存儲空間來存儲不同的數據。
注意事項
創(chuàng)建存儲空間本身不收取任何費用,僅收取上傳至存儲空間中Object的存儲費用或者訪問Object產生的流量費用等。更多信息,請參見計量項和計費項。
存儲空間的容量彈性擴展,您無需提前購買容量。
使用限制
同一阿里云賬號在同一地域內創(chuàng)建的存儲空間總數不能超過100個。
存儲空間創(chuàng)建后,其名稱、所處地域、存儲類型不支持修改。
單個存儲空間的容量不受限制。
操作方式
使用OSS控制臺
您可以創(chuàng)建有地域屬性Bucket或者無地域屬性Bucket。關于存儲空間地域屬性的更多信息,請參見存儲空間地域屬性。
創(chuàng)建有地域屬性Bucket
登錄OSS管理控制臺。
在左側導航欄,單擊Bucket 列表,然后單擊創(chuàng)建 Bucket。
在創(chuàng)建 Bucket面板,按如下說明配置各項參數。
參數
描述
Bucket名稱
填寫Bucket名稱。命名規(guī)則如下:
Bucket名稱在OSS范圍內必須全局唯一。
只能包括小寫字母、數字和短劃線(-)。
必須以小寫字母或者數字開頭和結尾。
長度必須在3~63字符之間。
地域
Bucket的數據中心。
您需要下拉選擇有地域屬性,然后指定某個地域。
如需通過ECS內網訪問OSS,請選擇與您ECS相同的地域。更多信息,請參見 OSS訪問域名使用規(guī)則。
Endpoint
Bucket所在地域對應的外網Endpoint。更多Endpoint,請參見OSS地域和訪問域名。
存儲類型
Bucket的存儲類型。
標準存儲:提供高可靠、高可用、高性能的對象存儲服務,能夠支持頻繁的數據訪問。適用于各種社交、分享類的圖片、音視頻應用、大型網站、大數據分析等業(yè)務場景。
低頻訪問存儲:提供高持久性、較低存儲成本的對象存儲服務。有最小計量單位(64 KB)和最低存儲時間(30天)的要求。支持數據實時訪問,訪問數據時會產生數據取回費用。適用于較低訪問頻率(平均每月訪問頻率1到2次)的業(yè)務場景。
歸檔存儲:提供高持久性、極低存儲成本的對象存儲服務。有最小計量單位(64 KB)和最低存儲時間(60天)的要求。數據需解凍(約1分鐘)后訪問,會產生數據解凍費用。如果開啟歸檔直讀,無需解凍就可以訪問數據,會產生數據直讀取回費用。適用于數據長期保存的業(yè)務場景,例如檔案數據、醫(yī)療影像、科學資料、影視素材等。
冷歸檔存儲:提供高持久性、比歸檔存儲的存儲成本更低的對象存儲服務。有最小計量單位(64 KB)和最低存儲時間(180天)的要求。數據需解凍后訪問,解凍時間根據數據大小和選擇的解凍模式決定,解凍會產生數據取回費用以及取回請求費用。適用于需要超長時間存放的冷數據,例如因合規(guī)要求需要長期留存的數據、大數據及人工智能領域長期積累的原始數據、影視行業(yè)長期留存的媒體資源、在線教育行業(yè)的歸檔視頻等業(yè)務場景。
深度冷歸檔存儲:提供高持久性、比冷歸檔存儲成本更低的對象存儲服務。有最小計量單位(64 KB)和最低存儲時間(180天)的要求。數據需解凍后訪問,解凍時間根據數據大小和選擇的解凍模式決定,解凍會產生數據取回費用以及取回請求費用。適用于需要超長時間存放的極冷數據,例如大數據及人工智能領域的原始數據的長期積累留存、媒體數據的長期保留、法規(guī)和合規(guī)性存檔、磁帶替換等業(yè)務場景。
更多信息,請參見存儲類型介紹。
存儲冗余類型
Bucket的數據容災類型。
本地冗余存儲
采用單可用區(qū)(AZ)內的數據冗余存儲機制,將用戶的數據冗余存儲在同一個可用區(qū)內多個設施的多個設備上,確保硬件失效時的數據持久性和可用性。
同城冗余存儲(推薦)
采用多可用區(qū)(AZ)內的數據冗余存儲機制,將用戶的數據冗余存儲在同一地域(Region)的多個可用區(qū)。當某個可用區(qū)不可用時,仍然能夠保障數據的正常訪問。
重要同城冗余存儲的費用較高,且開啟后不支持關閉,請謹慎操作。
更多信息,請參見同城冗余存儲。
阻止公共訪問
開啟阻止公共訪問,已有的公共訪問權限會被忽略,且不允許創(chuàng)建新的公共訪問權限,以此關閉數據的公開訪問渠道,確保數據安全。更多信息,請參見阻止公共訪問。
讀寫權限
選擇Bucket的讀寫權限。
私有:只有該存儲空間的擁有者可以對該存儲空間內的文件進行讀寫操作,其他人無法訪問該存儲空間內的文件。
公共讀:只有該存儲空間的擁有者可以對該存儲空間內的文件進行寫操作,任何人(包括匿名訪問者)可以對該存儲空間中的文件進行讀操作。
警告互聯(lián)網上任何用戶都可以對該Bucket內文件進行訪問,這有可能造成您數據的外泄以及費用激增,請謹慎操作。
公共讀寫:任何人(包括匿名訪問者)都可以對該存儲空間內文件進行讀寫操作。
警告互聯(lián)網上任何用戶都可以對該Bucket內的文件進行訪問,并且向該Bucket寫入數據。這有可能造成您數據的外泄以及費用激增,若被人惡意寫入違法信息還可能會侵害您的合法權益。除特殊場景外,不建議您配置公共讀寫權限。
所屬資源組
選擇Bucket所屬資源組。資源組對您擁有的云資源從用途、權限、歸屬等維度上進行分組,實現企業(yè)內部多用戶、多項目的資源分級管理。更多信息,請參見什么是資源組。
版本控制
選擇是否開通版本控制功能。
開通:開通Bucket版本控制功能后,針對數據的覆蓋和刪除操作將會以歷史版本的形式保存下來。當您在錯誤覆蓋或者刪除Object后,能夠將Bucket中存儲的Object恢復至任意時刻的歷史版本。更多詳情請參見版本控制介紹。
不開通:不開通版本控制功能,則不保存覆蓋或刪除的數據。
服務端加密方式
選擇Object的加密方式。
無:不啟用服務器端加密。
OSS完全托管:使用OSS托管的密鑰進行加密。OSS會為每個Object使用不同的密鑰進行加密,作為額外的保護,OSS會使用主密鑰對加密密鑰本身進行加密。
KMS:使用KMS默認托管的CMK或指定CMK ID進行加解密操作。
使用KMS加密方式前,需要開通KMS服務。具體操作,請參見開通密鑰管理服務。
加密算法:可選擇AES256或SM4加密算法。
加密密鑰:服務端加密方式選擇KMS時,可配置此項。參數說明如下:
alias/acs/oss(CMK ID):使用默認托管的CMK生成不同的密鑰來加密不同的Object,并且在Object被下載時自動解密。
alias/<cmkname>(CMK ID):使用指定的CMK生成不同的密鑰來加密不同的Object,并將加密Object的CMK ID記錄到Object的元數據中,具有解密權限的用戶下載Object時會自動解密。其中
<cmkname>
為創(chuàng)建密鑰時配置的主密鑰可選標識。使用指定的CMK ID前,您需要在KMS管理控制臺創(chuàng)建一個與Bucket處于相同地域的普通密鑰或外部密鑰。具體操作,請參見創(chuàng)建密鑰。
實時日志查詢
如果您希望在不付費的情況下實時查詢最近7天的OSS訪問日志,請開通實時日志查詢。
有關實時日志查詢的更多信息,請參見實時日志查詢。
如果您不需要進行實時日志查詢,請保持不開通的默認配置。
定時備份
如果您希望定時備份您的OSS數據,請開通定時備份。此時,OSS將自動創(chuàng)建備份計劃,并由云備份(Cloud Backup)執(zhí)行備份頻率為每天備份一次OSS數據,備份文件保存一周的任務。更多信息,請參見定時備份。
如果您不需要定時備份您的OSS數據,請保持不開通的默認配置。
HDFS服務
如果您希望通過JindoSDK訪問OSS實現數據湖場景,需要開通HDFS服務。開通HDFS功能前,需要打開開關,并按照頁面指引完成授權操作。更多信息,請參見開通OSS-HDFS服務。
重要HDFS服務開啟后不支持關閉,請謹慎操作。
歸檔以及冷歸檔存儲類型Bucket不支持開啟HDFS服務。
創(chuàng)建無地域屬性Bucket
無地域屬性Bucket僅支持外網訪問,不支持內網訪問。更多信息,請參見無地域屬性Bucket。
建議您在創(chuàng)建無地域屬性Bucket之前,及時購買無地域屬性預留空間,否則將以按量付費的方式對無地域屬性Bucket存放的資源進行收費。更多信息,請參見無地域屬性預留空間。
登錄OSS管理控制臺。
在左側導航欄,單擊Bucket 列表,然后單擊創(chuàng)建 Bucket。
在創(chuàng)建 Bucket面板,按如下說明配置各項參數。
參數
描述
Bucket名稱
填寫Bucket名稱。命名規(guī)則如下:
Bucket名稱在OSS范圍內必須全局唯一。
只能包括小寫字母、數字和短劃線(-)。
必須以小寫字母或者數字開頭和結尾。
長度必須在3~63字符之間。
地域
Bucket的數據中心。
您需要下拉選擇無地域屬性。
Endpoint
僅支持外網Endpoint。固定值為oss-rg-china-mainland.aliyuncs.com。
存儲類型
Bucket的存儲類型。
僅支持標準存儲。標準存儲提供高可靠、高可用、高性能的對象存儲服務,能夠支持頻繁的數據訪問。適用于各種社交、分享類的圖片、音視頻應用、大型網站、大數據分析等業(yè)務場景。
存儲冗余類型
Bucket的數據容災類型。
僅支持本地冗余存儲。本地冗余存儲采用單可用區(qū)(AZ)內的數據冗余存儲機制,將用戶的數據冗余存儲在同一個可用區(qū)內多個設施的多個設備上,確保硬件失效時的數據持久性和可用性。
阻止公共訪問
開啟阻止公共訪問,已有的公共訪問權限會被忽略,且不允許創(chuàng)建新的公共訪問權限,以此關閉數據的公開訪問渠道,確保數據安全。更多信息,請參見阻止公共訪問。
讀寫權限
選擇Bucket的讀寫權限。
私有:只有該存儲空間的擁有者可以對該存儲空間內的文件進行讀寫操作,其他人無法訪問該存儲空間內的文件。
公共讀:只有該存儲空間的擁有者可以對該存儲空間內的文件進行寫操作,任何人(包括匿名訪問者)可以對該存儲空間中的文件進行讀操作。
警告互聯(lián)網上任何用戶都可以對該Bucket內文件進行訪問,這有可能造成您數據的外泄以及費用激增,請謹慎操作。
公共讀寫:任何人(包括匿名訪問者)都可以對該存儲空間內文件進行讀寫操作。
警告互聯(lián)網上任何用戶都可以對該Bucket內的文件進行訪問,并且向該Bucket寫入數據。這有可能造成您數據的外泄以及費用激增,若被人惡意寫入違法信息還可能會侵害您的合法權益。除特殊場景外,不建議您配置公共讀寫權限。
版本控制
選擇是否開通版本控制功能。
選擇是否開啟服務器端加密。
開通:開通Bucket版本控制功能后,針對數據的覆蓋和刪除操作將會以歷史版本的形式保存下來。當您在錯誤覆蓋或者刪除Object后,能夠將Bucket中存儲的Object恢復至任意時刻的歷史版本。更多詳情請參見版本控制介紹。
不開通:不開通版本控制功能,則不保存覆蓋或刪除的數據。
服務端加密方式
選擇Object的加密方式。
無:不啟用服務器端加密。
OSS完全托管:使用OSS托管的密鑰進行加密。OSS會為每個Object使用不同的密鑰進行加密,作為額外的保護,OSS會使用主密鑰對加密密鑰本身進行加密。
加密算法:選擇AES256或SM4加密算法。
使用圖形化管理工具ossbrowser
ossbrowser支持的Bucket級別的操作與控制臺支持的操作類似,請按照ossbrowser界面指引完成創(chuàng)建Bucket的操作。關于如何使用ossbrowser,請參見快速使用ossbrowser。
使用阿里云SDK
以下僅列舉常見SDK的創(chuàng)建存儲空間代碼示例。關于其他SDK的創(chuàng)建存儲空間代碼示例,請參見SDK簡介。
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.CannedAccessControlList;
import com.aliyun.oss.model.CreateBucketRequest;
import com.aliyun.oss.model.DataRedundancyType;
import com.aliyun.oss.model.StorageClass;
public class CreateBucket {
public static void main(String[] args) throws Exception {
// yourEndpoint填寫B(tài)ucket所在地域對應的Endpoint。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 填寫B(tài)ucket名稱。
String bucketName = "examplebucket";
// 填寫資源組ID。如果不填寫資源組ID,則創(chuàng)建的Bucket屬于默認資源組。
//String rsId = "rg-aek27tc****";
// 填寫B(tài)ucket所在地域。以華東1(杭州)為例,Region填寫為cn-hangzhou。
String region = "cn-hangzhou";
// 創(chuàng)建OSSClient實例。
ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
OSS ossClient = OSSClientBuilder.create()
.endpoint(endpoint)
.credentialsProvider(credentialsProvider)
.clientConfiguration(clientBuilderConfiguration)
.region(region)
.build();
try {
// 創(chuàng)建CreateBucketRequest對象。
CreateBucketRequest createBucketRequest = new CreateBucketRequest(bucketName);
// 如果創(chuàng)建存儲空間的同時需要指定存儲類型、存儲空間的讀寫權限、數據容災類型, 請參考如下代碼。
// 此處以設置存儲空間的存儲類型為標準存儲為例介紹。
//createBucketRequest.setStorageClass(StorageClass.Standard);
// 數據容災類型默認為本地冗余存儲,即DataRedundancyType.LRS。如果需要設置數據容災類型為同城冗余存儲,請設置為DataRedundancyType.ZRS。
//createBucketRequest.setDataRedundancyType(DataRedundancyType.ZRS);
// 設置存儲空間讀寫權限為公共讀,默認為私有。
//createBucketRequest.setCannedACL(CannedAccessControlList.PublicRead);
// 在支持資源組的地域創(chuàng)建Bucket時,您可以為Bucket配置資源組。
//createBucketRequest.setResourceGroupId(rsId);
// 創(chuàng)建存儲空間。
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();
}
}
}
}
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以杭州為例,其它Region請按實際情況填寫。
$endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 填寫B(tài)ucket名稱,例如examplebucket。
$bucket= "examplebucket";
try {
$config = array(
"provider" => $provider,
"endpoint" => $endpoint,
"signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
"region"=> "cn-hangzhou"
);
$ossClient = new OssClient($config);
// 設置Bucket的存儲類型為低頻訪問類型,默認是標準類型。
$options = array(
OssClient::OSS_STORAGE => OssClient::OSS_STORAGE_IA
);
// 設置Bucket的讀寫權限為公共讀,默認是私有讀寫。
$ossClient->createBucket($bucket, OssClient::OSS_ACL_TYPE_PUBLIC_READ, $options);
} catch (OssException $e) {
printf(__FUNCTION__ . ": FAILED\n");
printf($e->getMessage() . "\n");
return;
}
print(__FUNCTION__ . ": OK" . "\n");
const OSS = require('ali-oss');
const client = new OSS({
// yourregion填寫B(tài)ucket所在地域。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
region: 'yourregion',
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// yourBucketName填寫B(tài)ucket名稱。
bucket: 'yourBucketName',
});
// 創(chuàng)建存儲空間。
async function putBucket() {
try {
const options = {
storageClass: 'Standard', // 存儲空間的默認存儲類型為標準存儲,即Standard。如果需要設置存儲空間的存儲類型為歸檔存儲,請?zhí)鎿Q為Archive。
acl: 'private', // 存儲空間的默認讀寫權限為私有,即private。如果需要設置存儲空間的讀寫權限為公共讀,請?zhí)鎿Q為public-read。
dataRedundancyType: 'LRS' // 存儲空間的默認數據容災類型為本地冗余存儲,即LRS。如果需要設置數據容災類型為同城冗余存儲,請?zhí)鎿Q為ZRS。
}
// 填寫B(tài)ucket名稱。
const result = await client.putBucket('examplebucket', options);
console.log(result);
} catch (err) {
console.log(err);
}
}
putBucket();
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫B(tài)ucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region信息,例如cn-hangzhou。注意,v4簽名下,必須填寫該參數
region = "cn-hangzhou"
# yourBucketName填寫存儲空間名稱。
bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region)
# 創(chuàng)建存儲空間。
# 如果需要在創(chuàng)建存儲空間時設置存儲類型、存儲空間訪問權限、數據容災類型,請參考以下代碼。
# 以下以配置存儲空間為標準存儲類型,訪問權限為私有,數據容災類型為同城冗余存儲為例。
# bucketConfig = oss2.models.BucketCreateConfig(oss2.BUCKET_STORAGE_CLASS_STANDARD, oss2.BUCKET_DATA_REDUNDANCY_TYPE_ZRS)
# bucket.create_bucket(oss2.BUCKET_ACL_PRIVATE, bucketConfig)
bucket.create_bucket()
using Aliyun.OSS;
// yourEndpoint填寫B(tài)ucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
var endpoint = "yourEndpoint";
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// 填寫B(tài)ucket名稱。
var bucketName = "examplebucket";
// 填寫B(tài)ucket所在地域對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。
const string region = "cn-hangzhou";
// 創(chuàng)建ClientConfiguration實例,按照您的需要修改默認參數。
var conf = new ClientConfiguration();
// 設置v4簽名。
conf.SignatureVersion = SignatureVersion.V4;
// 創(chuàng)建OssClient實例。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
c.SetRegion(region);
// 創(chuàng)建存儲空間。
try
{
var request = new CreateBucketRequest(bucketName);
//設置讀寫權限ACL為公共讀PublicRead,默認為私有權限。
request.ACL = CannedAccessControlList.PublicRead;
//設置數據容災類型為同城冗余存儲。
request.DataRedundancyType = DataRedundancyType.ZRS;
client.CreateBucket(request);
Console.WriteLine("Create bucket succeeded");
}
catch (Exception ex)
{
Console.WriteLine("Create bucket failed. {0}", ex.Message);
}
// 構建創(chuàng)建Bucket的請求。
// 填寫B(tài)ucket名稱。
CreateBucketRequest createBucketRequest = new CreateBucketRequest("examplebucket");。
// 設置Bucket的讀寫權限ACL。
// createBucketRequest.setBucketACL(CannedAccessControlList.Private);
// 指定Bucket的存儲類型。
// createBucketRequest.setBucketStorageClass(StorageClass.Standard);
// 異步創(chuàng)建存儲空間。
OSSAsyncTask createTask = oss.asyncCreateBucket(createBucketRequest, new OSSCompletedCallback<CreateBucketRequest, CreateBucketResult>() {
@Override
public void onSuccess(CreateBucketRequest request, CreateBucketResult result) {
Log.d("asyncCreateBucket", "Success");
}
@Override
public void onFailure(CreateBucketRequest request, ClientException clientException, ServiceException serviceException) {
// 請求異常。
if (clientException != null) {
// 本地異常如網絡異常等。
clientException.printStackTrace();
}
if (serviceException != null) {
// 服務異常。
Log.e("ErrorCode", serviceException.getErrorCode());
Log.e("RequestId", serviceException.getRequestId());
Log.e("HostId", serviceException.getHostId());
Log.e("RawMessage", serviceException.getRawMessage());
}
}
});
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
/// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 創(chuàng)建OSSClient實例。
// yourEndpoint填寫B(tài)ucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
// yourRegion填寫B(tài)ucket所在地域,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 設置簽名版本
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 創(chuàng)建名為examplebucket的存儲空間,并設置存儲類型為低頻訪問oss.StorageIA、讀寫權限ACL為公共讀oss.ACLPublicRead、數據容災類型為同城冗余存儲oss.RedundancyZRS。
err = client.CreateBucket("examplebucket", oss.StorageClass(oss.StorageIA), oss.ACL(oss.ACLPublicRead), oss.RedundancyType(oss.RedundancyZRS))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
}
// 構建創(chuàng)建Bucket的請求。
OSSCreateBucketRequest * create = [OSSCreateBucketRequest new];
// 設置存儲空間名稱為examplebucket。
create.bucketName = @"examplebucket";
// 設置訪問權限為私有。
create.xOssACL = @"private";
// 設置存儲類型為低頻訪問類型IA。
create.storageClass = OSSBucketStorageClassIA;
OSSTask * createTask = [client createBucket:create];
[createTask continueWithBlock:^id(OSSTask *task) {
if (!task.error) {
NSLog(@"create bucket success!");
} else {
NSLog(@"create bucket failed, error: %@", task.error);
}
return nil;
}];
// 實現同步阻塞等待任務完成。
// [createTask waitUntilFinished];
#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;
int main(void)
{
/*初始化OSS賬號信息。*/
/*yourEndpoint填寫B(tài)ucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
std::string Endpoint = "yourEndpoint";
/ *yourRegion填寫B(tài)ucket所在地域對應的Region。以華東1(杭州)為例,Region填寫為cn - hangzhou。 * /
std::string Region = "yourRegion";
/*填寫B(tài)ucket名稱,例如examplebucket。*/
std::string BucketName = "examplebucket";
/*初始化網絡等資源。*/
InitializeSdk();
ClientConfiguration conf;
conf.signatureVersion = SignatureVersionType::V4;
/* 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
OssClient client(Endpoint, credentialsProvider, conf);
client.SetRegion(Region);
/*指定新創(chuàng)建bucket的名稱、存儲類型和ACL。*/
CreateBucketRequest request(BucketName, StorageClass::IA, CannedAccessControlList::PublicReadWrite);
/*設置數據容災類型為同城冗余存儲。*/
//request.setDataRedundancyType(DataRedundancyType::ZRS);
/*創(chuàng)建Bucket。*/
auto outcome = client.CreateBucket(request);
if (!outcome.isSuccess()) {
/*異常處理。*/
std::cout << "CreateBucket fail" <<
",code:" << outcome.error().Code() <<
",message:" << outcome.error().Message() <<
",requestId:" << outcome.error().RequestId() << std::endl;
return -1;
}
/*釋放網絡等資源。*/
ShutdownSdk();
return 0;
}
#include "oss_api.h"
#include "aos_http_io.h"
/* yourEndpoint填寫B(tài)ucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。*/
const char *endpoint = "yourEndpoint";
/* 填寫B(tài)ucket名稱,例如examplebucket。*/
const char *bucket_name = "examplebucket";
/* yourRegion填寫B(tài)ucket所在地域對應的Region。以華東1(杭州)為例,Region填寫為cn-hangzhou。*/
const char *region = "yourRegion";
void init_options(oss_request_options_t *options)
{
options->config = oss_config_create(options->pool);
/* 用char*類型的字符串初始化aos_string_t類型。*/
aos_str_set(&options->config->endpoint, endpoint);
/* 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。*/
aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
//需要額外配置以下兩個參數
aos_str_set(&options->config->region, region);
options->config->signature_version = 4;
/* 是否使用CNAME域名訪問OSS服務。0表示不使用。 */
options->config->is_cname = 0;
/* 設置網絡相關參數,比如超時時間等。*/
options->ctl = aos_http_controller_create(options->pool, 0);
}
int main(int argc, char *argv[])
{
/* 在程序入口調用aos_http_io_initialize方法來初始化網絡、內存等全局資源。 */
if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
exit(1);
}
/* 用于內存管理的內存池(pool),等價于apr_pool_t。其實現代碼在apr庫中。*/
aos_pool_t *pool;
/* 重新創(chuàng)建一個內存池,第二個參數是NULL,表示沒有繼承其它內存池。*/
aos_pool_create(&pool, NULL);
/* 創(chuàng)建并初始化options,該參數包括endpoint、access_key_id、acces_key_secret、is_cname、 curl等全局配置信息。*/
oss_request_options_t *oss_client_options;
/* 在內存池中分配內存給options。*/
oss_client_options = oss_request_options_create(pool);
/* 初始化Client的選項oss_client_options。*/
init_options(oss_client_options);
/* 初始化參數。*/
aos_string_t bucket;
oss_acl_e oss_acl = OSS_ACL_PRIVATE;
aos_table_t *resp_headers = NULL;
aos_status_t *resp_status = NULL;
/* 將char*類型數據賦值給aos_string_t類型的存儲空間。 */
aos_str_set(&bucket, bucket_name);
/* 創(chuàng)建存儲空間。*/
resp_status = oss_create_bucket(oss_client_options, &bucket, oss_acl, &resp_headers);
/* 判斷請求是否成功。 */
if (aos_status_is_ok(resp_status)) {
printf("create bucket succeeded\n");
} else {
printf("create bucket failed\n");
}
/* 釋放內存池,相當于釋放了請求過程中各資源分配的內存。*/
aos_pool_destroy(pool);
/* 釋放之前分配的全局資源。 */
aos_http_io_deinitialize();
return 0;
}
require 'aliyun/oss'
client = Aliyun::OSS::Client.new(
# Endpoint以華東1(杭州)為例,其它Region請按實際情況填寫。
endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
# 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
access_key_id: ENV['OSS_ACCESS_KEY_ID'],
access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# 填寫B(tài)ucket名稱,例如examplebucket。
client.create_bucket('examplebucket')
使用命令行工具ossutil
以下命令用于創(chuàng)建存儲空間examplebucket。關于該命令的更多信息,請參見put-bucket。
ossutil api put-bucket --bucket examplebucket
使用REST API
如果您的程序自定義要求較高,您可以直接發(fā)起REST API請求。直接發(fā)起REST API請求需要手動編寫代碼計算簽名。更多信息,請參見PutBucket。