安装 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 的服务及其包名称。 我们已考虑将这些包置于预览版中。
引用 (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 中开始使用其他服务,请查看一些可用的示例代码。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈