安裝 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

廠商 Azure SDK for Go

Azure SDK for Go 可能會透過 dep 進行廠商。 基於穩定性考慮，建議使用廠商。 若要在您自己的專案中使用 dep ，請將 新增 github.com/Azure/azure-sdk-for-go 至 [[constraint]] 的 Gopkg.toml 區段。 例如，在 版本 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 最常見套件包括：

Package 描述
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 中的其他服務，請查看一些可用的範例程式碼。