[教學] HiCloud S3

1.      先取得hicloud s3 Access key id與secret key，這兩個其官方網站登入後皆可以取得。

2.      參考s3 Javascript SDK，其範例如下。

AWS.config.update({

    accessKeyId: ' accessKeyId ',

    secretAccessKey: ' secretAccessKey ',

    "sslEnabled": false,

    "endpoint": "s3.hicloud.net.tw",

    "s3ForcePathStyle": false,

    "region": "us"

});

var s3 = new AWS.S3();

將access key id與secret key帶入並將endpoint指向hicloud s3的伺服器，就可以開啟s3的連線了。

3.      列出s3 Bucket裡面檔案與資料夾。

var params = {

    Bucket: 'Your_Bucket_Name',

    Prefix: ''

}

s3.listObjects(params, function (err, data) {

if(err)throw err;

console.log(data);

}

在參數那邊輸入您要取得的bucket，prefix是如果您的bucket裡面有資料夾，而要對特定的資料夾做取得清單時，就需要輸入prefix，空字串的話就是取得bucket根目錄所有資料夾與檔案。

4.      檔案上傳至s3伺服器。

var objKey = 'upload_file_name';

var params = {

    Bucket: 'Your_Bucket_Name',

    Key: 'save_path/'+objKey,

ContentType: file.type, //檔案類別

    Body: file,

ACL: 'private' //權限設定

};

s3.putObject(params, function (err, data) {

    if (err) {

}

});

參數bucket為檔案儲存的bucket，key為檔案儲存在bucket時候的路徑，ACL為設定檔案的權限，private為不公開，public-read為公開等。

5.      S3 CORS設定

每個bucket都可以設定cores configuration，其作用在於您的檔案是否對外開放，或對某個伺服器(IP)開放，其設定如下。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

  <CORSRule>

    <AllowedMethod>GET</AllowedMethod>

    <AllowedMethod>PUT</AllowedMethod>

    <AllowedMethod>POST</AllowedMethod>

    <AllowedMethod>DELETE</AllowedMethod>

    <AllowedOrigin>*</AllowedOrigin>

    <AllowedHeader>*</AllowedHeader>

  </CORSRule>

</CORSConfiguration>