安装 Azure SDK for Go

  • 项目

欢迎使用 Azure SDK for Go！ 使用该 SDK 可以管理 Go 应用程序中的 Azure 服务并与之交互。

获取 Azure SDK for Go

Azure SDK for Go 与 Go 1.8 版和更高版本兼容。 对于使用 Azure Stack 配置文件的环境，最低需要 Go 版本 1.9。 如果需要安装 Go，请按照 Go 安装说明进行操作。

可以通过 go get 下载 Azure SDK for Go 及其依赖项。

go get -u -d github.com/Azure/azure-sdk-for-go/...

警告

请务必在 URL 中将 Azure 大写。 否则，在使用该 SDK 时，可能导致大小写相关的导入问题。 此外，还需要在导入语句中将 Azure 大写。

某些 Azure 服务具有其自己的 Go SDK，并未包括在核心 Azure SDK for Go 包中。 下表列出了具有其自己的 SDK 的服务及其包名称。 我们已考虑将这些包置于预览版中。

服务 程序包
Blob 存储 github.com/Azure/azure-storage-blob-go
文件存储 github.com/Azure/azure-storage-file-go
存储队列 github.com/Azure/azure-storage-queue-go
事件中心 github.com/Azure/azure-event-hubs-go
服务总线 github.com/Azure/azure-service-bus-go

引用 (Vendor) Azure SDK for Go

可以通过 dep 引用 Azure SDK for Go。 出于稳定原因，我们建议引用它。 若要在自己的项目中使用 dep，请将 github.com/Azure/azure-sdk-for-go 添加到 Gopkg.toml 的 [[constraint]] 节。 例如，若要引用版本 14.0.0，请添加以下条目：

[[constraint]]
name = "github.com/Azure/azure-sdk-for-go"
version = "14.0.0"

在项目中包含 Azure SDK for Go

若要通过 Go 代码使用 Azure 服务，请导入所要交互的任何服务和所需的 autorest 模块。 可以从 GoDoc 获取可用服务和 AutoRest 包的完整可用模块列表。 需要在 go-autorest 中使用的最常见包为：

程序包 说明
github.com/Azure/go-autorest/autorest 用于处理服务客户端身份验证的对象
github.com/Azure/go-autorest/autorest/azure 用于与 Azure 服务交互的常量
github.com/Azure/go-autorest/autorest/adal 用于访问 Azure 服务的身份验证机制
github.com/Azure/go-autorest/autorest/to 用于使用 Azure SDK 数据结构的类型断言帮助器

Go 包和 Azure 服务独立进行版本控制。 服务版本是模块导入路径的一部分，位于 services 模块下方。 模块的完整路径是服务名称，后接 YYYY-MM-DD 格式的版本，再后接服务名称。 例如，若要导入计算服务的 2017-03-30 版本：

import "github.com/Azure/azure-sdk-for-go/services/compute/mgmt/2017-03-30/compute"

建议你在开始开发时使用最新版本的服务，并保持一致。 即使在此期间没有 Go SDK 更新，服务要求也可能会在版本之间发生变化，从而可能破坏你的代码。

如果需要服务的统一快照，也可以选择单个配置文件版本。 目前，唯一锁定的配置文件为版本 2017-03-09，其中可能不包含服务的最新功能。 配置文件位于 profiles 模块下，其版本采用 YYYY-MM-DD 格式。 服务根据其配置文件版本分组。 例如，若要从 2017-03-09 配置文件导入 Azure 资源管理模块：

import "github.com/Azure/azure-sdk-for-go/profiles/2017-03-09/resources/mgmt/resources"

警告

还可以使用 preview 和 latest 配置文件， 但不建议使用。 这些配置文件的版本会不断滚动更新，服务的行为随时可能更改。

后续步骤

若要开始使用 Azure SDK for Go，请从快速入门着手。

若要立即在 Go SDK 中开始使用其他服务，请查看一些可用的示例代码。