使用 Go 创建 Blob 容器

项目
10/15/2024

本文介绍如何使用适用于 Go 的 Azure 存储客户端模块来创建容器。 Azure 存储中的 Blob 已组织成容器。必须先创建容器，才能上传 Blob。

先决条件

Azure 订阅 - 创建试用订阅。
Azure 存储帐户 - 创建存储帐户
Go 1.18+

设置你的环境

如果没有现有项目，请查看本部分，其中介绍了如何设置项目来使用适用于 Go 的 Azure Blob 存储客户端模块。步骤包括模块安装、添加 import 路径以及创建授权的客户端对象。有关详细信息，请参阅 Azure Blob 存储和 Go 入门。

安装模块

使用以下命令安装 azblob 模块：

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

若要使用 Microsoft Entra ID 进行身份验证（建议），请使用以下命令安装 azidentity 模块：

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

添加导入路径

在代码文件中添加以下导入路径：

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
)

这些导入路径代表了开始之前需要满足的最低要求。本文中的某些代码示例可能需要其他导入路径。有关具体详细信息和示例用法，请参阅代码示例。

创建客户端对象

若要将应用连接到 Blob 存储，请使用 azblob.NewClient 创建客户端对象。以下示例演示如何使用 DefaultAzureCredential 创建客户端对象进行授权：

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

授权

授权机制必须具有创建容器所需的权限。若要使用 Microsoft Entra ID 进行授权（建议），需有 Azure RBAC 内置角色“存储 Blob 数据参与者”或更高级别的角色。有关详细信息，请参阅创建容器 (REST API) 的授权指南。

关于容器命名

容器名称必须是有效的 DNS 名称，因为它是用于对容器或其 Blob 寻址的唯一 URI 的一部分。为容器命名时，请遵循以下规则：

容器名称的长度可以是 3 到 63 个字符。
容器名称必须以字母或数字开头，并且只能包含小写字母、数字和短划线 (-) 字符。
容器名称中不允许出现连续的短划线字符。

容器资源的 URI 的格式如下：

https://my-account-name.blob.core.chinacloudapi.cn/my-container-name

创建容器

若要创建容器，请调用以下方法：

CreateContainer

将立即在存储帐户下创建容器。无法将一个容器嵌套在另一个容器下。如果已存在同名的容器，将引发异常。

以下示例演示如何创建容器：

func createContainer(client *azblob.Client, containerName string) {
    // Create a container
    _, err := client.CreateContainer(context.TODO(), containerName, nil)
    handleError(err)
}

创建根容器

根容器充当存储帐户的默认容器。每个存储帐户只能包含一个根容器，该容器必须命名为 $root。必须显式创建或删除根容器。

可以引用存储在根容器中的 Blob，而无需包含根容器名称。根容器允许引用位于存储帐户层次结构顶层的 Blob。例如，可通过以下方式引用根容器中的 blob：

https://<storage-account-name>.blob.core.chinacloudapi.cn/default.html

如果存储帐户中尚不存在该容器，以下示例将创建该容器：

func createRootContainer(client *azblob.Client) {
    // Create root container
    _, err := client.CreateContainer(context.TODO(), "$root", nil)
    handleError(err)
}

注意

本指南中的代码示例旨在帮助你开始使用 Azure Blob 存储和 Go。你应该修改错误处理和 Context 值以满足应用程序的需求。

资源

若要详细了解如何使用适用于 Go 的 Azure Blob 存储客户端模块来创建容器，请参阅以下资源。

代码示例

查看本文中的代码示例 (GitHub)

REST API 操作

Azure SDK for Go 包含基于 Azure REST API 而生成的库，允许你通过熟悉的 Go 范式来与 REST API 操作进行交互。用于创建容器的客户端库方法使用以下 REST API 操作：

创建容器 (REST API)

客户端模块资源

本文是适用于 Go 的 Blob 存储开发人员指南的一部分。若要了解详细信息，请参阅构建 Go 应用中的完整开发人员指南文章列表。

通过