v2.21.0 release

release 日期 2025-10-14

v2.21.0 release (tower version 4.7.0)

features

• 增加 [EcpLicenseApi] 用于 ECP 许可信息的的查询
• 增加 [ReplicationServiceApi] 用于复制服务的查询
• 增加 [BusinessHostApi] 与 [BusinessHostGroupApi] 用于业务主机
• [VmApi]: 创建虚拟机类 API 支持在 ha 字段配置为 true 的情况下配置 haPriority 字段用于配置
• [VmApi]: [updateVmBasicInfo] 支持配置编辑虚拟机的 haPriority 字段，仅当 ha 为 true 或现 vm ha 字段已经为 true 时生效。
• [VmApi]: 为电源操作类 API 引入前置条件检查，避免未定义行为
• [VmApi]: 虚拟机支持 EC 存储策略的配置
• [VmVolumeApi]: 虚拟卷支持 EC 存储策略的配置
• [IscsiLunApi], [IscsiTargetApi], [NfsExportApi], [NfsInodeApi], [NvmfNamespaceApi], [NvmfSubsystemApi]: 增加 EC 存储策略的支持，允许副本数提升，精简置备转厚置备
• [ClusterApi]: 支持查询, 编辑集群常驻缓存功能
• [Host]: 新增字段 mergedStatus, connectStatus 与 commitedMemoryBytes 字段
• [Cluster]: 新增字段 commitedMemoryBytes

bugfix

• 修复 java1.8 版本不支持 Field.canAccess 方法，替换为 Field.isAccessible 方法
• [VmApi]: 为创建虚拟机类 API 修复未配置 VPC 网卡的 IP 时创建出错
• [VmApi]: [createVmFromContentLibraryTemplateBatch] 修复单位未生效的问题

breaking change

• [IscsiTargetApi]: [updateIscsiTarget] 入参的 data 字段类型由 IscsiTargetCommonParams 改为 IscsiTargetUpdationParamsData

v2.20.1-snapshot.1

update to v2.20.1 schema

v2.20.0 release (tower version 4.6.0)

release 日期 2025-06-09

v2.20.0 release (tower version 4.6.0)

feature

• 为所有 model 实现了 ConditionalNullablePojo 用于显式设置某个字段为 null 时，会在序列化时为被显式序列化为 null 还是被忽略（默认会被忽略），可以通过：
  • 新增 ${field}_ExplictlyNull, ${field}_ExplictlyNonNull 方法来控制字段是否被显示设置为 null
  • 新增 set${field}_IsExplictlyNull 方法来设置当前字段是否会被显式序列化为 null
  • 新增 get${field}_IsExplictlyNull 方法来获取字段是否被显式序列化为 null
• [Vm], [VmVolume]: 新增 used_size 与 used_size_usage 字段，用于获取虚拟机与虚拟卷的已使用容量
• [ResourceChangeApi]: 新增 getResourceChange API 用于获取 Resource Change Events
• [PciDeviceApi]: 新增 getPciDevices API 用于获取 PCI 设备列表
• [TaskApi]: 为 createTask 新增 status 字段，用于指定任务状态
• [ReplicationPlanApi]: 新增 getReplicationPlan API 用于获取复制计划列表
• [SmtpServerApi]: 新增 getSmtpServer API 用于获取 SMTP 服务器列表
• [ReplicaVmApi]: 新增 getReplicaVms API 用于获取复制虚拟机列表
• [NetworkPolicyRuleServiceApi]:
  • 新增 getNetworkPolicyRuleServices API 用于获取「网络安全」的服务资源
  • 新增 createNetworkPolicyRuleService API 用于创建「网络安全」的服务资源
  • 新增 updateNetworkPolicyRuleService API 用于更新「网络安全」的服务资源
  • 新增 deleteNetworkPolicyRuleService API 用于删除「网络安全」的服务资源
• [SecurityPolicyApi]: [SecurityPolicyIngressEgressInput]: 支持配置 service_ids 用于指定「网络安全」的服务资源
• [SecurityPolicyApi]: [IPSecurityPolicy]: 支持配置 ip_block，用于从白名单/黑名单中排除部分 IP
• [IsolationPolicyApi]:
  • 新增 createIsolationPolicy API 用于创建「隔离策略」
  • 新增 updateIsolationPolicy API 用于更新「隔离策略」
  • 新增 deleteIsolationPolicy API 用于删除「隔离策略」
• [VirtualPrivateCloudExternalSubnetGroupApi]: 新增 getVirtualPrivateCloudExternalSubnetGroups API 用于获取「外部子网组」
• [VirtualPrivateCloudEdgeGatewayApi]: 新增 getVirtualPrivateCloudEdgeGateways API 用于获取「边缘网关」
• [VirtualPrivateCloudEdgeGatewayGroupApi]: 新增 getVirtualPrivateCloudEdgeGatewayGroups API 用于获取「边缘网关组」
• [VirtualPrivateCloudNatGatewayApi]: [VirtualPrivateCloudNatGatewayCreateParams]: 新增 external_subnet_group_id 用于配置外部子网组；新增 external_ips，用于配置主备转换地址。
• [VirtualPrivateCloudNatGatewayApi]: [VirtualPrivateCloudRouteGatewayUpdateParams]: 新增 external_ips，用于配置主备转换地址。
• [VirtualPrivateCloudRouterGatewayApi]:
  • [VirtualPrivateCloudRouterGatewayCreateParams]: 新增 external_subnet_group_id 用于配置外部子网组；新增 external_ips，用于配置主备转换地址。
  • [VirtualPrivateCloudRouterGatewayUpdateParams]: 新增 external_ips，用于配置主备转换地址。
• [VirtualPrivateCloudFloatingIPApi]: 新增 batchCreateVirtualPrivateCloudFloatingIPs API，用于批量分配浮动 IP。

bugfix

• [VmApi]: [getVmVncInfo]: 修复生成的 vnc redirect url
• [VmApi]: [addVmNic] [updateVmNic] [updateVmNicBasicInfo]: 修复虚拟机网卡无法正确编辑 ip

v2.19.0 release (tower version 4.5.0)

release 日期 2025-02-17

v2.19.0 release (tower version 4.5.0)

breaking change

• [TaskApi]: [updateTask]: description 字段由 string 更新为 TaskDescription

feature

• [BackupPlanApi]: 新增 getBackupRestorePointMetadata API 用于获取备份恢复点元数据;
• [NtpApi]: 新增 getNtpServiceURL API 用于获取 Ntp 服务 URL;
• [ClusterApi]: 新增 getClusterStorageInfo API 用于获取集群存储信息;
• [ObservabilityApi]: 新增 clearSystemServiceAlertNotificationConfig API 用于清除系统服务报警信息

optimize

• [BackupPlanApi]: [createBackupPlan]: 在 incrementalPeriod 为 Weekly 时，校验 incrementalWeekdays 是否已输入;
• 为以下资源新增返回字段
  • [BackupPlan]: 新增 vms, phase, lastExecuteStatusMessage, lastManualExecuteStatusMessage, backupRestorePointCount, validSizeOfRestorePoint, backupTotalSize, logicalSize, backupDelayOption, deleteStrategy, backupPlanExecutions 和 backupRestorePoints 字段;
  • [NestedVirtualPrivateCloudService]: 新增 internalCidr 和 tepIpPools 字段;
  • [VirtualPrivateCloud]: 新增 vpcService 字段;
  • [SecurityPolicy]: 新增 isBlocklist 字段;
  • [ContentLibraryVmTemplate]: 新增 vmDisks, vmNics, clockOffset, cpu, cpuModel, firmware, ha, ioPolicy, localCreatedAt, maxBandwidth, maxBandwidthPolicy, maxIops, maxIopsPolicy, templateConfig, videoType, winOpt 和 zbsStorageInfo 字段;
  • [VirtualPrivateCloudExternalSubnets]: 新增 edgeGateway 和 exclusive 字段;
• [TaskApi]: [createTask], [updateTask]: 支持传入 startedAt 和 finishedAt 字段;

bugfix

• [IscsiLunApi]: [copyIscsiLun]: 修复跨集群克隆 iscsi lun 失败;
• [ObservabilityApi]: [disassociateSystemServiceFromObsService]: 修复解除关系错误时无法正确返回错误信息。

v2.18.2-snapshot.2

update to v2.18.2.snapshot.2 schema

v2.18.2-snapshot.1

add used_size/used_size_usage for vm and vm_volume

v2.18.1-snapshot.2

update to v2.18.1-snapshot.2 schema

v2.18.1-snapshot.1

为 backup plan 提供 vm 查询

v2.18.0 release (tower version 4.4.0)

release 日期 2024-10-14

v2.18.0 release (tower version 4.4.0)

feature

• [VmApi]: [createVmFromContentLibraryTemplateBatch]: 支持批量通过内容库模板创建虚拟机
• 新增备份相关 API
  • [BackupPlanExecutionApi] 备份计划执行记录 API
  • [BackupPlanApi] 备份计划管理 API
  • [BackupRestoreExecutionApi] 备份计划恢复点执行记录 API
  • [BackupRestorePointApi] 备份计划恢复点管理 API
  • [BackupServiceApi] 备份服务 API
  • [BackupStoreRepositoryApi] 备份存储库 API
  • [BackupTargetExecutionApi] 备份虚拟机执行记录 API

optimize

• [VmApi]: [installVmTools]: 优化虚拟机镜像挂载，现在无需输入虚拟机工具镜像 ID 即可挂载
• [LogCollectionApi]: [forceStopLogCollection]: 优化执行，不再会将日志收集任务置为失败
• [ContentLanguage]: 支持配置为 * 以同时返回所有支持的语言，返回值依旧是 string 类型，可以被 JSON 序列化为语言和实际值的键值对
• [SecurityPolicyIngressEgressInput]: 新增 type 字段 SecurityPolicyFlowControlType 以支持配置全部流量
• [SecurityPolicyApi] 支持配置 alg_protocol
• [HostApi]: [createHost]: 支持添加主机时配置主机账户密码

bugfix

• [SecurityGroupApi]: [updateSecurityGroup]: 修复无法正确更新安全组名称与描述

v2.13.1 release (tower version 3.4.4)

release 日期 2024-10-10

v2.13.1 release (tower version 3.4.4)

update

• enum 兼容性处理:
  为所有的 enum 都添加了一个 ${ENUM_NAME}_UNSUPPORTED_ENUM 项，用于兼容未来新增的枚举值，当未来新增的枚举值不在当前版本的枚举值中时，会返回该项，而不是报错
• [VmApi]: [createVmFromContentLibraryTemplateBatch] 批量从内容库模板创建虚拟机 API

bugfix

• pick 2.14.0 ~ 2.17.0 的已有 api 的 bugfix，详见 master 分支的 release_note