使用 JavaScript 或 TypeScript 建立 Blob 容器

• .NET
• Java
• JavaScript
• Python
• Go

Azure 儲存體中的 Blob 會組織成容器。 在您可以上傳 Blob 之前，您必須先建立一個容器。 本文說明如何使用適用於 JavaScript 的 Azure 儲存體用戶端程式庫來建立容器。

必要條件

• 本文中的範例假設您已設定專案，以搭配使用適用於 JavaScript 的 Azure Blob 儲存體用戶端程式庫。 若要了解如何設定專案，包括套件安裝、匯入模組，以及建立授權的用戶端物件來處理資料資源，請參閱開始使用 Azure Blob 儲存體和 JavaScript。
• 授權機制必須具有建立 Blob 容器的權限。 若要深入了解，請參閱下列 REST API 作業的授權指導：
  • 建立容器

關於容器命名

容器名稱必須是有效的 DNS 名稱，因為它會形成用來定址容器或其 blob 的唯一 URI 的一部分。 命名容器時，請遵循下列規則：

• 容器名稱長度可介於 3 到 63 個字元之間。
• 容器名稱必須以字母或數字開頭，而且只能包含小寫字母、數字和虛線 (-) 字元。
• 容器名稱中不允許連續的虛線字元。

容器資源的 URI 格式如下：

https://my-account-name.blob.core.windows.net/my-container-name

建立容器

若要建立容器，請從 BlobServiceClient 類別呼叫下列方法：

• BlobServiceClient.createContainer

您也可以使用 ContainerClient 類別的下列其中一種方法來建立容器：

• ContainerClient.create
• ContainerClient.createIfNotExists

容器會在儲存體帳戶下方直接建立。 您無法將某個容器巢於另一個容器下方。 如果已經有相同名稱的容器存在，則會擲回例外狀況。

下列範例會從 BlobServiceClient 物件異步建立容器：

JavaScript

async function createContainer(blobServiceClient, containerName){
  
  const containerClient = await blobServiceClient.createContainer(containerName);

  return containerClient;
}

TypeScript

async function createContainer(
  blobServiceClient: BlobServiceClient,
  containerName: string
): Promise<ContainerClient> {
  
  const {
    containerClient,
    containerCreateResponse
  }: {
    containerClient: ContainerClient;
    containerCreateResponse: ContainerCreateResponse;
  } = await blobServiceClient.createContainer(containerName);

  if (containerCreateResponse.errorCode)
    throw Error(containerCreateResponse.errorCode);

  return containerClient;
}

建立根容器

根容器會做為儲存體帳戶的預設容器。 每個儲存體帳戶可以有一個根容器，必須命名為 $root。 根容器必須明確建立或刪除。

您可以參考儲存在根容器中的 Blob，而不包含根容器名稱。 根容器可讓您參考儲存體帳戶階層最上層的 blob。 例如，您可以依照下述方式參考位於根容器中的 Blob：

https://accountname.blob.core.windows.net/default.html

若要建立根容器，請呼叫任何 create 方法，並將容器名稱指定為 $root。

資源

若要深入了解如何使用適用於 JavaScript 的 Azure Blob 儲存體用戶端程式庫建立容器，請參閱下列資源。

程式碼範例

• 檢視本文中的 JavaScript 和 TypeScript 程式代碼範例 （GitHub）

REST API 操作

適用於 JavaScript 的 Azure SDK 包含建置在 Azure REST API 之上的程式庫，可讓您透過熟悉的 JavaScript 範例與 REST API 作業進行互動。 用來建立容器的用戶端程式庫方法會使用下列 REST API 作業：

• 建立容器 (REST API)

用戶端程式庫資源

• 用戶端程式庫參考文件
• 用戶端程式庫原始程式碼
• 套件 (npm)

相關內容

• 本文是 JavaScript/TypeScript 的 Blob 記憶體開發人員指南的一部分。 若要深入瞭解，請參閱建置 JavaScript/TypeScript 應用程式的完整開發人員指南文章清單。