Azure SDK for Go 中 Workloads SAP Virtual Instance 1.0.0 版本发布解析

项目简介

Azure SDK for Go 是微软官方提供的用于访问 Azure 服务的 Go 语言开发工具包。其中的 workloadsapvirtualinstance 模块专门用于管理 Azure 上的 SAP 虚拟实例工作负载，为开发者提供了在 Go 中操作 SAP 系统的标准化接口。

版本 1.0.0 重大变更

类型重构与命名优化

1. 文件共享配置类型统一
   原先分散的 ConfigurationType 被统一为更明确的 FileShareConfigurationType，包含三种具体类型：

   • CreateAndMount：创建并挂载文件共享
   • Mount：仅挂载现有文件共享
   • Skip：跳过文件共享配置

2. 身份认证体系重构
   移除了通用的 ManagedServiceIdentityType，引入了专用的 SAPVirtualInstanceIdentityType，提供更符合 SAP 场景的两种身份类型：

   • None：不使用托管身份
   • UserAssigned：使用用户分配的托管身份

3. 错误信息结构优化
   ErrorAdditionalInfo.Info 从泛型 any 类型改为具体的 *ErrorAdditionalInfoInfo 结构体，增强了类型安全性。

API 端点调整

1. 中央服务实例管理升级
   废弃了 SAPCentralInstancesClient，引入了功能更完善的 SAPCentralServerInstancesClient，提供完整的 CRUD 操作：

   • 创建/删除实例的异步操作
   • 启动/停止实例控制
   • 实例信息更新

2. 工作负载客户端整合
   移除了独立的 WorkloadsClient，将其功能整合到 SAPVirtualInstancesClient 中，包括：

   • 可用区详情查询
   • 磁盘配置获取
   • SAP 规格推荐
   • 支持的 SKU 查询

3. 操作状态增强
   OperationStatusResult 新增 ResourceID 字段，可追踪操作关联的资源，同时 PercentComplete 从 float32 升级为 float64 提高精度。

新增功能与改进

实例控制增强

1. 标准化的启停接口
   所有实例类型（应用服务器、中央服务器、数据库）都统一了启停操作接口：

   // 启动实例示例
   poller, err := client.BeginStart(ctx, "rg", "sapSystem", "instance01", nil)
   
   // 停止实例示例  
   poller, err := client.BeginStop(ctx, "rg", "sapSystem", "instance01", nil)
   

2. 列表响应结构标准化
   所有列表接口返回统一的结构：

   type SAPApplicationServerInstanceListResult struct {
       Value []*SAPApplicationServerInstance
       NextLink *string
   }
   

身份管理改进

新的 SAPVirtualInstanceIdentity 结构专为 SAP 场景设计：

type SAPVirtualInstanceIdentity struct {
    Type *SAPVirtualInstanceIdentityType
    UserAssignedIdentities map[string]*UserAssignedIdentity
}

迁移指南

1. 文件共享配置迁移
   将原有的 ConfigurationType 常量替换为对应的 FileShareConfigurationType 值。

2. 中央实例客户端迁移
   从使用 SAPCentralInstancesClient 切换到新的 SAPCentralServerInstancesClient。

3. 工作负载查询迁移
   原 WorkloadsClient 的功能现在通过 SAPVirtualInstancesClient 的对应方法访问。

总结

1.0.0 版本标志着 Azure SDK for Go 的 SAP 工作负载管理模块进入稳定阶段。通过本次更新，API 设计更加符合 SAP 系统的管理范式，类型系统更加严谨，同时提供了更完整的实例生命周期管理能力。建议现有用户尽快评估迁移方案，以利用新版本带来的改进和稳定性提升。