在 Azure Stack Hub 中将 API 版本配置文件与 GO 配合使用

项目
10/31/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 编程语言。

配置文件

若要使用另一 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 文件格式。并非所有这些值都可以使用，具体取决于所运行的示例。有关更新的示例代码或详细信息，请参阅示例存储库。

租户 ID

若要查找 Azure Stack Hub 的目录或租户 ID，请按照此文中的说明进行操作。

注册资源提供程序

遵循此文档注册所需的资源提供程序。根据要运行的示例，将需要这些资源提供程序。例如，如果要运行 VM 示例，则需要 Microsoft.Compute 资源提供程序注册。

Azure Stack 资源管理器终结点

Azure 资源管理器 (ARM) 是一种管理框架，可供管理员用来部署、管理和监视 Azure 资源。 Azure 资源管理器可以通过单个操作以组任务而不是单个任务的形式处理这些任务。可以从资源管理器终结点获取元数据信息。该终结点返回 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.chinacloudapi.cn/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.chinacloudapi.cn/",
         "audiences": ["https://management.yourtenant.partner.onmschina.cn/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

示例

有关最新的示例代码，请参阅示例存储库。根 README.md 描述一般要求，每个子目录都包含一个特定示例，内有其自己的关于如何运行该示例的 README.md。

有关适用于 Azure Stack 版本 2008 或配置文件 2019-03-01 及更低版本的示例，请参阅此文。

后续步骤

了解有关 API 配置文件的详细信息：

通过