Node.js初始化
更新時間:
Client是OSS Node.js的客戶端,用于管理存儲空間和文件等OSS資源。使用Node.js SDK發(fā)起OSS請求時,您需要初始化一個Client實例,并根據(jù)需要修改默認配置項。
新建Client
V4簽名(推薦)
推薦使用更安全的V4簽名算法。使用V4簽名初始化時,需要聲明authorizationV4。OSS Node.js SDK 6.20.0及以上版本支持V4簽名。
以使用OSS域名初始化時使用V4簽名為例,其他通過自定義域名等初始化的場景可參考以下示例執(zhí)行相應(yīng)修改。
const OSS = require('ali-oss');
const client = new OSS({
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
// yourRegion填寫B(tài)ucket所在地域。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
region: 'yourRegion',
authorizationV4: true,
// yourBucketName填寫B(tài)ucket名稱。
bucket: 'yourBucketName',
});
V1簽名(不推薦)
重要
阿里云對象存儲OSS自2025年03月01日起不再對新用戶(即新UID )開放使用V1簽名,并將于2025年09月01日起停止更新與維護且不再對新增Bucket開放使用V1簽名。請盡快切換到V4簽名,避免影響服務(wù)。更多信息,請參見公告說明。
使用OSS域名新建Client
以下代碼用于使用OSS域名初始化。
const OSS = require('ali-oss');
const client = new OSS({
// yourRegion填寫B(tài)ucket所在地域。以華東1(杭州)為例,Region填寫為oss-cn-hangzhou。
region: 'yourRegion',
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
// yourBucketName填寫B(tài)ucket名稱。
bucket: 'yourBucketName',
});
使用自定義域名新建Client
以下代碼用于使用自定義域名新建Client。關(guān)于使用自定義域名訪問OSS的更多信息,請參見綁定自定義域名至Bucket默認域名。
重要
使用自定義域名無法使用client.listBuckets()方法。
const OSS = require('ali-oss')
const client = new OSS({
// 使用自定義域名作為Endpoint。
endpoint: 'http://img.example.com',
// 從環(huán)境變量中獲取訪問憑證。運行本代碼示例之前,請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
cname: true,
// yourBucketName填寫B(tài)ucket名稱。
bucket: 'yourBucketName',
});
配置Client
您可以在初始化Client時按需添加配置項,例如通過timeout
指定請求超時時間,通過stsToken
指定臨時訪問憑證等。關(guān)于Node.js支持的配置項以及配置示例,請參見配置項。
文檔內(nèi)容是否對您有幫助?