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

發行項
10/30/2024

重要

.NET SDK 已從追蹤 1 更新為追蹤 2。強烈建議儘快移轉至追蹤 2 SDK。如需相關指示，請參閱此移轉指南。

適用於 Azure Stack Hub Resource Manager 的 .NET SDK 會提供工具來協助您建置及管理基礎結構。 SDK 中的資源提供者包括計算、網路、儲存體、應用程式服務和 Key Vault。 .NET SDK 包含 14 個 NuGet 套件。如果您使用已被取代的追蹤 1 .NET SDK (不建議) ，這些套件會以 API 配置檔進行版本設定，例如 2020-09-01-hybrid 和 2019-03-01-hybrid。 .NET SDK 中的 API 配置檔可協助您在全域 Azure 資源和 Azure Stack Hub 資源之間切換，以啟用混合式雲端開發。如需詳細資訊，請參閱 .NET 和 API 版本配置檔一節。

安裝 Azure .NET SDK

安裝 GIT。如需相關指示，請參閱使用者入門 - 安裝 Git。
若要安裝正確的 NuGet 套件，請參閱可用的 NuGet 發行版本。

.NET 和 API 版本設定檔

API 設定檔是資源提供者和 API 版本的組合。使用 API 設定檔，取得資源提供者套件中每個資源類型的最新、最穩定版本。

如果您使用追蹤 2 .NET SDK (建議) ，您可以使用標準 Azure.* 套件，並在程式碼中設定 API 版本。如需此範例和此標準套件的Azure.*查詢範例，請參閱範例一節。
如果您使用追蹤 1 .NET SDK (不建議) ，您必須下載下列其中一個套件，以利用您的 Azure Stack Hub 服務。請務必下載與您 API 設定檔對應的檔案：
- Microsoft.Azure.Management.Profiles.hybrid_2020_09_01.<ResourceProvider>.1.0.0.nupkg
- Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.<ResourceProvider>.0.9.0-preview.nupkg

注意

NuGet 套件規格的 ResourceProvider 部分必須變更。此外，追蹤 1 .NET SDK 的套件已被取代，因此您可能會遇到錯誤。建議您儘快更新至追蹤 2 .NET SDK。

Profiles

針對包含日期的設定檔，若要使用不同的 SDK 設定檔或版本，請以 Microsoft.Azure.Management.Profiles.hybrid_<date>.ResourceManager 格式取代日期。例如，在 2008 版本中，設定檔為 2019_03_01，而該字串則會變成 Microsoft.Azure.Management.Profiles.hybrid_2019_03_01.ResourceManager。請注意，有時候 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 設定檔的摘要。

訂用帳戶

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

服務主體

您應建立服務主體及其相關聯的環境資訊，並將其儲存。建議使用 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"]
      }
}

範例

請參閱此範例存放庫，以取得更新到最新的 (追蹤 2) 範例程式代碼。如需追蹤 1 範例程式代碼，請參閱此範例存放庫。根 README.md 目錄描述一般需求，而每個子目錄都包含一個專屬的範例 README.md ，描述如何執行該範例。

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

後續步驟

深入了解 API 設定檔：

共用方式為