開始使用 Azure Blob 儲存體 和 JavaScript 或 TypeScript
本文說明如何使用適用於 JavaScript 的 Azure Blob 儲存體用戶端程式庫來連線至 Azure Blob 儲存體。 線上之後，請使用 開發人員指南 來瞭解如何在 Blob 記憶體服務的容器、Blob 和功能上運作程式碼。
如果您想要從完整的範例開始，請參閱 JavaScript 或 TypeScript 的用戶端連結庫快速入門。
API 參考 | 套件 (npm) | 程式庫原始程式碼 | 範例 | 提供意見反應
必要條件
- Azure 訂用帳戶 - 建立免費帳戶
- Azure 儲存體帳戶 - 建立儲存體帳戶
- Node.js LTS
- TypeScript，如果適用
- 適用於用戶端 (瀏覽器) 應用程式，您需要統合工具。
設定您的專案
本節將逐步引導您準備專案，以使用適用於 JavaScript 的 Azure Blob 儲存體 用戶端連結庫。
開啟命令提示字元並流覽至您的項目資料夾。 將 <project-directory> 變更為您的資料夾名稱：
cd <project-directory>
如果您的目錄中還沒有 package.json 檔案，請初始化該專案以建立檔案：
npm init -y
從您的項目目錄中，使用 npm install 或 yarn add 命令安裝 Azure Blob 儲存體 和 Azure 身分識別客戶端連結庫的套件。 需要 @azure/身分識別套件才能對 Azure 服務進行無密碼連線。
npm install @azure/storage-blob @azure/identity
授權存取權並連線到 Blob 儲存體
若要將應用程式連線至 Blob 儲存體，請建立 BlobServiceClient 類別的執行個體。 此物件是您與儲存體帳戶層級的資料資源互動的起點。 您可以使用它來操作儲存體帳戶及其容器。 您也可以使用服務用戶端來建立容器用戶端或 Blob 用戶端，視您需要使用的資源而定。
若要深入了解如何建立和管理客戶端物件，包括最佳做法，請參閱 建立和管理與資料資源互動的客戶端物件。
您可以使用 Microsoft Entra 授權權杖、帳戶存取密鑰或共用存取簽章 (SAS) 來授權 BlobServiceClient 物件。 為了實現最佳安全性，Microsoft 建議使用具有受控識別的 Microsoft Entra ID 來授權針對 Blob 資料的要求。 如需更多資訊，請參閱使用 Microsoft Entra ID 授與 Blob 的存取權。
若要使用 Microsoft Entra ID 進行授權，您必須使用 安全性主體。 需要何種安全性主體取決於應用程式的執行位置。 參考下表：
| 應用程式的執行位置 | 安全性主體 | 指引 |
|---|---|---|
| 本機電腦 (開發和測試) | 服務主體 | 若要了解如何註冊應用程式、設定 Microsoft Entra 群組、指派角色及設定環境變數，請參閱 使用開發人員服務主體授權存取 |
| 本機電腦 (開發和測試) | 使用者身分識別 | 若要了解如何設定 Microsoft Entra 群組、指派角色並登入 Azure，請參閱 使用開發人員認證授權存取 |
| 裝載於 Azure 中 | 受控識別 | 若要了解如何啟用受控識別並指派角色，請參閱 使用受控識別從 Azure 裝載的應用程式授權存取 |
| 裝載在 Azure 外部 (例如內部部署應用程式) | 服務主體 | 若要了解如何註冊應用程式、指派角色及設定環境變數，請參閱 使用應用程式服務主體從内部部署應用程式授權存取 |
使用 DefaultAzureCredential 授權存取
授權存取權並連線到 Blob 儲存體簡單又安全的方式，是藉由建立 DefaultAzureCredential 執行個體來取得 OAuth 權杖。 然後，您可以使用該認證來建立 BlobServiceClient 物件。
下列範例會使用 DefaultAzureCredential 來建立 BlobServiceClient 物件:
const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
accountURL,
new DefaultAzureCredential()
);
此程式代碼範例可用於 JavaScript 或 TypeScript 專案。
建置應用程式
當您建置應用程式以在 Azure Blob 儲存體中使用資料資源時，您的程式碼主要會與三種資源類型互動：儲存體帳戶、容器和 Blob。 若要深入了解這些資源類型、彼此的關係，以及應用程式如何與資源互動，請參閱了解應用程式如何與 Blob 儲存體資料資源互動。
下列指南示範如何使用適用於 JavaScript 的 Azure 儲存體 用戶端連結庫來存取資料並執行特定動作：
| 指南 | 描述 |
|---|---|
| 設定重試原則 (部分機器翻譯) | 實作用戶端作業的重試原則。 |
| 複製 Blob | 將 Blob 從一個位置複製到另一個位置。 |
| 建立容器 | 建立 Blob 容器 |
| 建立使用者委派 SAS | 建立容器或 Blob 的使用者委派 SAS。 |
| 建立和管理 blob 租用 | 建立和管理 Blob 上的鎖定。 |
| 建立和管理容器租用 | 在容器上建立和管理鎖定。 |
| 刪除及還原 | 刪除 Blob 並還原虛刪除的 Blob。 |
| 刪除和還原容器 | 刪除容器並還原虛刪除的容器。 |
| 下載 Blob | 使用字串、串流和檔案路徑來下載 Blob。 |
| 使用標籤來尋找 Blob | 設定和擷取標籤，以及使用標籤來尋找 Blob。 |
| 列出 Blob | 以各種方式列出 Blob。 |
| 列出容器 | 列出帳戶中的容器，以及可用來自訂清單的各種選項。 |
| 管理屬性和中繼資料 (Blob) | 取得和設定 Blob 的屬性和中繼資料。 |
| 管理屬性和中繼資料 (容器) | 取得和設定容器的屬性和中繼資料。 |
| 資料傳輸的效能微調 | 最佳化資料傳輸作業的效能。 |
| 設定或變更 Blob 的存取層 | 設定及變更區塊 Blob 的存取層。 |
| 上傳 Blob | 了解如何使用字串、串流、檔案路徑和其他方法來上傳 Blob。 |