在 Azure Stack Hub 中使用 Go 搭配 API 版本設定檔

Go 和版本配置檔

配置檔是不同資源類型與不同服務不同版本的組合。 使用配置檔可協助您混合和比對不同的資源類型。 設定檔可以提供下列優點：

• 藉由鎖定特定 API 版本，為您的應用程式提供穩定性。
• 應用程式與 Azure Stack Hub 和區域 Azure 資料中心的相容性。

在 Go SDK 中，配置檔可在設定檔路徑下取得。 配置檔版本號碼會以 YYYY-MM-DD 格式標示。 例如，Azure Stack Hub API 配置檔 版本 2020-09-01 適用於 Azure Stack Hub 2102 版或更新版本。 若要從配置檔匯入指定的服務，請從配置檔匯入其對應的模組。 例如，若要從 2020-09-01 設定檔匯入計算服務，請使用下列程式代碼：

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

安裝 Azure SDK for Go

1. 安裝 Git。 請參閱 用戶入門 - 安裝 Git。
2. 安裝 Go。 Azure 的 API 配置檔需要 Go 1.9 版或更新版本。 請參閱 Go 程式設計語言。

個人檔案

若要使用不同的 SDK 設定檔或版本，請取代匯入語句中的日期，例如 github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage。 例如，在 2008 版本中，設定檔為 2019-03-01，且字串變成 github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage。 請注意，有時候 SDK 小組會變更套件的名稱，因此只要以不同的日期取代字串的日期可能無法運作。 配置檔與 Azure Stack 版本的關聯請參見下表。

如需 Azure Stack Hub 和 API 配置檔的詳細資訊，請參閱 API 設定檔的摘要。

請參閱 Go SDK 設定檔。

訂閱

如果您還沒有訂用帳戶，請建立訂用帳戶，並儲存稍後要使用的訂用帳戶標識碼。 如需如何建立訂用帳戶的資訊，請參閱本 檔。

服務主體

服務主體及其相關聯的環境信息應該建立並儲存在某處。 建議使用具備 owner 角色的服務主體，但根據範例，使用角色 contributor 可能也足夠。 如需必要值，請參閱範例存放 庫中 的自述檔。 您可以使用 SDK 語言所支援的任何格式讀取這些值，例如來自 JSON 檔案（我們的範例使用）。 視所執行的範例而定，並非所有這些值都會被使用。 如需更新範例程式代碼或進一步資訊，請參閱範例存放庫。

租戶識別碼

若要尋找 Azure Stack Hub 的目錄或租用戶標識碼，請遵循 本文中的指示。

註冊資源提供者

遵循本 文件，註冊必要的資源提供者。 視您想要執行的範例而定，需要這些資源提供者。 例如，如果您想要執行 VM 範例， Microsoft.Compute 則需要資源提供者註冊。

Azure Stack 資源管理員端點

Azure Resource Manager （ARM） 是一種管理架構，可讓系統管理員部署、管理及監視 Azure 資源。 Azure Resource Manager 可以在單一作業中以群組而非個別方式處理這些工作。 您可以從 Resource Manager 端點取得元數據資訊。 端點會傳回 JSON 檔案，其中包含執行程式碼所需的資訊。

• Azure Stack 開發工具包中的 ResourceManagerEndpointUrl 是： https://management.local.azurestack.external/。
• 整合式系統中的 ResourceManagerEndpointUrl 是：https://management.region.<fqdn>/，其中 <fqdn> 是完全合格的域名。
• 若要擷取所需的元數據： <ResourceManagerUrl>/metadata/endpoints?api-version=1.0。 如需可用的 API 版本，請參閱 Azure rest API 規格。 例如，在2020-09-01設定檔版本中，您可以針對資源提供者 api-version將 變更2019-10-01為 microsoft.resources 。

範例 JSON：

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

範例

請參閱更新至最新範例程式代碼的 範例存放庫 。 根 README.md 目錄描述一般需求，而每個子目錄都包含一個特定範例，並有自己的 README.md 範例，說明如何執行該範例。

後續步驟

深入瞭解 API 設定檔：

• 在 Azure Stack Hub 中管理 API 版本設定檔
• 配置檔所支援的資源提供者 API 版本