Object Storage Service：Node.js建立儲存空間

注意事項

• 本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。

• 北京時間2025年10月13日10:00:00起，OSS逐步調整所有地區通過API、SDK、ossutil建立Bucket時預設開啟阻止公用訪問。各個地區的生效變更時間，請參見公告說明。開啟後，不允許建立公用存取權限，包括公用讀取或者公用讀寫ACL、以及公用訪問語義的Bucket Policy。如果您的業務有公用訪問需求，可在Bucket建立後關閉阻止公用訪問。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。

範例程式碼

以下代碼用於建立名為examplebucket的儲存空間。

const OSS = require('ali-oss');

const client = new OSS({
  // yourregion填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為oss-cn-hangzhou。
  region: 'yourregion',
  // 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數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填寫Bucket名稱。
  bucket: 'yourBucketName',
});

// 建立儲存空間。
async function putBucket() {
  try {
    const options = {
      storageClass: 'Standard', // 儲存空間的預設儲存類型為標準儲存，即Standard。如果需要設定儲存空間的儲存類型為Archive Storage，請替換為Archive。
      acl: 'private', // 儲存空間的預設讀寫權限為私人，即private。如果需要設定儲存空間的讀寫權限為公用讀取，請替換為public-read。
      dataRedundancyType: 'LRS' // 儲存空間的預設資料容災類型為本地備援儲存體，即LRS。如果需要設定資料容災類型為同城冗餘儲存，請替換為ZRS。
    }
    // 填寫Bucket名稱。
    const result = await client.putBucket('examplebucket', options);
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

putBucket();        

相關文檔

關於建立儲存空間的API介面說明，請參見PutBucket。