使用 JAVA 建立 Blob 容器

發行項
03/25/2024

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

必要條件

本文假設您已設定一個專案，要使用適用於 JAVA 的 Azure Blob 儲存體用戶端程式庫。若要了解如何設定專案，包括封裝安裝、新增 import 指示詞以及建立已授權的用戶端物件，請參閱開始使用 Azure 儲存體和 Java。
授權機制必須具有建立 Blob 容器的權限。若要深入了解，請參閱下列 REST API 作業的授權指導：
- 建立容器

關於容器命名

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

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

容器資源的 URI 格式如下：

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

建立容器

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

您也可以使用下列其中一種方法，從 BlobContainerClient 類別建立容器：

容器會在儲存體帳戶下方直接建立。您無法將某個容器以巢狀方式置於另一個容器下方。針對 create 和 createBlobContainer 方法，若已有相同名稱的容器存在，則會擲回例外狀況。

下列範例會建立來自 BlobServiceClient 物件的容器：

public BlobContainerClient createContainer(BlobServiceClient blobServiceClient, String containerName) {
    // Create the container using the service client object
    BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer(containerName);

    return blobContainerClient;
}

建立根容器

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

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

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

下列範例會使用容器名稱 $root 建立新的 BlobContainerClient 物件，然後建立容器 (若尚未存在於儲存體帳戶中)：

public void createRootContainer(BlobServiceClient blobServiceClient) {
    // Creates a new BlobContainerClient object by appending the containerName to
    // the end of the URI
    BlobContainerClient blobContainerClient = blobServiceClient.getBlobContainerClient("$root");

    // If the container does not already exist, create it using the container client
    blobContainerClient.createIfNotExists();
}

資源

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

REST API 操作

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

建立容器 (REST API)

程式碼範例

檢視本文中的程式碼範例 (GitHub) (英文)