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

發行項
10/30/2024

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

安裝 GIT。請參閱使用者入門 - 安裝 Git。
安裝 Go。 Azure 的 API 設定檔將需要 Go 1.9 版或更新版本。請參閱 Go 程式設計語言。

Profiles

若要使用不同的 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 版本	設定檔
2311	2020_09_01
2301	2020_09_01
2206	2020_09_01
2108	2020-09-01
2102	2020-09-01
2008	2019-03-01

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

請參閱 Go SDK 設定檔。

訂用帳戶

如果您還沒有訂用帳戶，請建立訂用帳戶，並儲存訂用帳戶識別碼以供稍後使用。如需有關如何建立訂閱的詳細資訊，請參閱此文件。

服務主體

您應建立服務主體及其相關聯的環境資訊，並將其儲存。建議使用 owner 角色的服務主體，但視範例而定，contributor 角色可能已足夠。如需必要值，請參閱範例存放庫中的讀我檔案。您可以使用 SDK 語言所支援的任何格式讀取這些值，例如透過 JSON 檔案 (即我們的範例所使用的檔案)。視正在執行的範例而定，並非這些所有值皆可以使用。如需更新的範例程式碼或進一步資訊，請參閱範例存放庫。

租用戶識別碼

若要尋找 Azure Stack Hub 的目錄或租用戶識別碼，請遵循這篇文章的指示。

註冊資源提供者

遵循此文件來註冊所需的資源提供者。根據要執行的範例而定會需要這些資源提供者。例如如果您想要執行 VM 範例，則需要註冊 Microsoft.Compute 資源提供者。

Azure Stack Resource Manager 端點

Azure Resource Manager (ARM) 是可讓系統管理員進行部署、管理及監視 Azure 資源的管理架構。 Azure Resource Manager 能夠以群組方式處理這些工作，而非個別單獨作業的方式。您可以從 Resource Manager 端點取得中繼資料資訊。此端點會傳回 JSON 檔案，以及執行程式碼所需的資訊。

Azure Stack 開發套件 (ASDK) 中的 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 設定檔版本中，您可以將資源提供者 microsoft.resources 的 api-version 變更為 2019-10-01。

範例 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 說明如何執行該範例。

如需適用於 Azure Stack 版本 2008 或設定檔 2019-03-01 以及下列範例的詳細資訊，請參閱此處。

後續步驟

深入了解 API 設定檔：

共用方式為