Skip to content

Latest commit

 

History

History
419 lines (306 loc) · 21.1 KB

RELEASENOTE.md

File metadata and controls

419 lines (306 loc) · 21.1 KB
Raw

RELEASE NOTE

release 日期 2024-10-14

v2.18.0 release (tower version 4.4.0)

feature

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

optimize

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

bugfix

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

release 日期 2024-08-21

v2.17.0 release (tower version 4.3.0)

feature

  • 新增 VPC 相关 API
    • [VirtualPrivateCloudApi] VPC 服务管理
    • [VirtualPrivateCloudClusterBindingApi] VPC 服务与集群关联关系
    • [VirtualPrivateCloudExternalSubnetApi] VPC 网络外部子网
    • [VirtualPrivateCloudFloatingIpApi] VPC 网络浮动 IP 管理
    • [VirtualPrivateCloudNatGatewayApi] VPC 网络 NAT 网关管理
    • [VirtualPrivateCloudRouterGatewayApi] VPC 网络路由网关管理
    • [VirtualPrivateCloudRouteTableApi] VPC 网络路由表管理
    • [VirtualPrivateCloudSecurityGroupApi] VPC 网络安全组管理
    • [VirtualPrivateCloudSecurityPolicyApi] VPC 网络安全策略管理
    • [VirtualPrivateCloudSubnetApi] VPC 子网管理
  • [VmApi]: [update_vm_nic_vpc]: 更新虚拟机的 VPC 网卡

update

  • [ContentLibraryImage]: 新增 iscsi_luns 字段，用于记录分发至存算分离节点中的镜像的 lun 。
  • [ContentLibraryImageApi]: []支持使用 iscsi_luns 进行搜索
  • [VmApi]:
    • [create_vm], create_vm_from_content_library_template, [create_vm_from_template], [clone_vm], [rebuild_vm_from_snapshot] 支持配置虚拟机的 VPC 网卡
    • [add_vm_nic], [update_vm_nic] 支持配置 VPC 网卡

bugfix

  • [VmApi]: [update_vm_disk], [add_vm_disk], [expand_vm_disk], [remove_vm_disk], [add_vm_cd_rom], [remove_vm_cd_rom], [eject_iso_from_vm_cd_rom], [toggle_vm_cd_rom_disable]: 修复被修改虚拟机的虚拟盘会丢失限速设置以及 cdrom 的禁用的问题
  • [vmApi]: create_vm_from_content_library_template: 修复当内容库模板仅分发在存算分离的集群时，无法创建虚拟机的问题。

release 日期 2024-07-16

v2.16.0 release (tower version 4.2.0)

bugfix

  • [utils]: 移除代码中的 type annotation 以支持 python2
  • [VmApi], [VmVolumeApi],[ContentLIbraryVmTemplateApi]:
    • 移除 [export_content_library_vm_template], [import_content_library_vm_template], [export_vm_volume], [import_vm_volume], [update_vm_nic_qos_option], [get_vm_vnc_info] 被错误增加必须的 content-language 参数

update

  • [HostApi]:
    • [create_host]: 新增 vdses 字段适配网络融合，新增 zbsSpec 字段适配 zbs 560 以上版本集群的添加
  • [VmApi]:
    • [get_vms]: 新增 bios_uuid 字段
  • 新增 [image_utils] 工具类，支持通过 uploadTask 来获取上传后的 elfImage 与 contentLibraryImage

release 日期 2024-05-30

v2.15.1 release (tower version 4.1.0)

bugfix

  • [Vm], [VmVolume], [IscsiLun], [NvmfNameSpace], [NfsInode]: 更新 unique_logical_size 类型为 double

release 日期 2024-05-11

v2.15.0 release (tower version 4.1.0)

update

  • [CommonHeader]: 新增默认返回 Header 类
  • [ContentLanguage]: 新增枚举规范返回语言，用于设置请求头的 content-language
  • [NestedLabel], [LabelApi]: LabelApi 将会返回一致的 Label 相关的属性，NestedLabel 额外返回 key 和 value。
  • [Vm], [VmVolume], [IscsiLun], [NvmfNameSpace], [NfsInode]: 新增返回 unique_logical_size 用于表示资源的独占逻辑容量

bugfix

  • [VmApi]
    • [add_vm_nic], [remove_vm_nic], [remove_vm_nic_by_where], [update_vm_nic], [update_vm_nic_basic_info], [update_vm_nic_advance_info], [update_vm_nic_qos_option]: 修复更新虚拟机网卡类 API 编辑后丢失部分网卡信息的问题
  • [VmPlacementGroupApi]
    • [create_vm_placement_group], [update_vm_placement_group]: 修复了创建与更新放置组时，vm_vm_policy_enabled 为 false 时无法更新组内虚拟机成员

release 日期 2024-01-09

v2.14.2 release (tower version 4.0.0)

bugfix

  • [Utils]: 修复错误的 ldap 登陆

release 日期 2024-01-09

v2.14.1 release (tower version 4.0.0)

bugfix

  • [VmVolumeElfStoragePolicyType]: 修复错误的枚举类型

release 日期 2024-01-04

v2.14.0 release (tower version 4.0.0)

update

  • [ContentLIbraryImageApi]:
    • [import_content_library_image]: 新增通过 url 导入内容库镜像 API
  • [GpuDeviceApi]:
    • [get_detail_vm_info_by_gpu_devices]: 新增获取 GPU 设备关联的虚拟机 API
  • [HostApi]:
    • [enter_maintenance_mode]: 新增进入维护模式 API
    • [enter_maintenance_mode_pre_check]: 新增进入维护模式预检 API
    • [enter_maintenance_mode_precheck_result]: 新增获取进入维护模式预检结果 API
    • [exit_maintenance_mode]: 新增离开维护模式 API
    • [exit_maintenance_mode_precheck_result]: 新增离开维护模式预检 API
    • [power_off_host]: 新增主机电源操作 API，用于关闭、重启主机
  • [IscsiLunAPi]:
    • [copy_iscsi_lun]: 新增复制 iscsi lun API
  • [NicApi]:
    • [get_nics]: 额外返回 iommu_status 以及关联的虚拟机
  • [TaskApi]:
    • [create_task]: 新增创建 Task API
    • [update_task]: 新增更新 Task API
  • [UserAuditLogApi]:
    • [create_user_audit_log]: 新增创建事件审计 API
  • [VmApi]:
    • [get_vm_gpu_device_info]: 新增根据虚拟机获取其挂载的 GPU 设备信息 API
    • [get_vm_Vnc_info]: 新增获取 vm vnc 信息 API
    • [rebuild_vm_from_snapshot]: 重建虚拟机 API 支持配置 PCI 网卡
    • [create_vm], [create_vm_from_template], create_vm_from_content_library_template, [clone_vm], [rebuild_vm_from_snapshot]: 创建虚拟机时支持配置虚拟机所属用户

bugfix

  • [ContentLibraryImageApi]:
    • [update_content_library_image]: 修复了更新内容库镜像时，没有传递 name 会失败的问题
  • [ElfImageApi]:
    • [update_elf_image]: 修复了更新镜像时，没有传递 name 会失败的问题
  • [vmApi]:

release 日期 2023-11-07

v2.13.0 release (tower version 3.4.0)

update

  • [ROLEACTION] 新增 SMTX_INSPECTOR

release 日期 2023-10-19

v2.12.0 release (tower version 3.3.0)

update

  • [GpuDeviceApi] 新增 GPU 设备的支持，新增以下 API：
    • [get_gpu_devices] 获取 GPU 设备列表
    • [get_gpuDevice_connections] 获取 GPU 设备数量
    • [switch_gpu_device_sriov] 切换 GPU 设备 sr-iov 开启
    • [update_gpu_device_description] 更新 GPU 设备描述
    • [update_gpu_device_usage] 更新 GPU 设备用途
  • [VmApi] 新增 GPU 设备支持：
    • 支持创建虚拟机，克隆虚拟机，从内容库模板创建虚拟机时额外配置 GPU 设备，需要指定主机
    • 新增 [add_vm_gpu_device] 为已有虚拟机挂载 GPU 设备
    • 新增 [remove_vm_gpu_device] 为已有虚拟机卸载 GPU 设备
  • [VmApi] 新增 PCI 网卡支持：
    • 支持创建虚拟机，克隆虚拟机，从内容库模板创建虚拟机时额外配置 PCI 网卡，需要指定主机
    • 新增 [add_vm_pci_nic] 支持为已有虚拟机挂载 PCI 网卡
    • 新增 [remove_vm_pci_nic] 支持为已有的虚拟机卸载 PCI 网卡
  • [VmApi] 优化卸载网卡:
    • [remove_vm_nic] nic_index 作为删除标记不够稳定，弃用
    • [remove_vm_nic_by_where] 新方法，支持使用 where 条件来筛选需要的网卡，对于 _vm_nic 而言，可以配合使用 vm + mac_address 的筛选， {vm:<vm_where>, mac_address:<mac_address>} 的形式来较为稳定的筛选出需要的 _vm_nic
  • [NicApi] [update_nic] 支持通过 nic_user_usage 更新网口用途
  • [LabelApi] 支持为 GPU 设备打标签

bugfix

  • 去除 python2.7 不兼容的内容

v2.11.1 release (tower version 3.2.0)

  • bugfix: 修复 utils.login LDAP 登陆失败的问题

release 日期 2023-09-01

v2.11.0 release (tower version 3.2.0)

breaking change

  • [VmApi] [VmImportParams]: 由于 _vm_nicParams 支持配置 qos 配置，现在设计网卡的参数由 _vm_nicParams 更新为了 VmImportNicParams，类型和过去一致，没有 qos 支持。

update

  • feature: [VmVolumeApi]: [import_vm_volume] [export_vm_volume]: 现在支持虚拟卷的导入与导出
  • feature: [ContentLibraryVmTemplateApi]: [import_content_library_vm_template] [export_content_library_vm_template]: 现在支持虚拟机模板的导入与导出
  • feature: [VmApi]: [update_vm_nic_qos_option]: 现在支持通过 api 更新现有虚拟机网卡的 qos 属性
  • optimize: [_vm_nicParams]: 现在支持配置 qos 参数，用于在创建虚拟机（直接创建，模板创建，快照重建，克隆创建）时配置虚拟机网卡的 qos 参数

bugfix

  • [VmApi]: [create_vm_from_template] create_vm_from_content_library_template [clone_vm] [rebuild_vm_from_snapshot]: 修复了磁盘限速无法正确配置的问题， 目前从模板创建，快照重建，克隆虚拟机时，仅支持配置与模板，快照或源虚拟机一致的 io_policy 并进行创建，原参数的 io_policy 被弃用
  • [IscsiTargetApi] [IscsiLunApi] [NvmfSubsystemApi] [NvmfNamespaceApi]: [create_iscsi_target] [update_iscsi_target] [create_iscsi_lun] [update_iscsi_lun] [create_nvmf_subsystem] [update_nvmf_subsystem] [create_nvmf_namespace] [update_nvmf_namespace]: bps_wr_max_length 可以被正常设置了
  • [VmApi]: [create_vm_from_template] create_vm_from_content_library_template: 修复了单位无法被正常应用的 bug
  • [GlobalAlertRuleApi]: [update_customize_alert_rule] 修复了特例报警无法正常更新的问题

release 日期 2023-08-01

v2.10.0 release (tower version 3.1.0)

  • feature: [AlertNotifierApi] 支持更新，删除以及创建新的报警通知配置
  • optimize: [utils] 优化了 WaitTask 以及 WaitTasks，在任务失败的时候会返回失败任务的原因

releae 日期 2023-07-18

v2.9.1 release (tower version 3.0.0)

  • optimize: 优化了 utils.login，当使用 UserSource.LDAP 进行登录时，自动使用 LDAP 登录源进行登陆，方便迁移

release 日期 2023-07-03

v2.9.0 release (tower version 3.0.0)

  • feature: [SecurityGroupApi] 支持创建，更新与删除安全组
  • feature: [SecurityPolicy] 支持创建，更新与删除自定义安全策略
  • feature: [OvfApi], [VmExportFileApi], [VmApi] 支持虚拟机的导入与导出
  • feature: [VlanApi] 支持 trunk vlan 的创建与编辑
  • feature: [UserApi] [Login] 支持使用 authn_id 登陆，旧 LDAP 登陆方式被废弃
  • optimize: 为 [Host], [Nic], [UsbDevice], [VmVolume], [VmVolumeSnapshot] 添加了 EntityAsyncStatus 已判断资源目前的状态

release 日期 2023-05-04

v2.8.0 release

  • optimize: VlanApi: [vm_vlan_creation_params], [vm_vlan_updation_params_data], [management_vlan_updation_params_data] 限制 VlanId 范围为 0~4095

release 日期 2023-03-22

v2.7.0 release

  • optimize: VmApi: [delete_vm] 更新参数类型为 VmDeleteParams，添加 effect 允许删除相关的快照
  • feature: [vm_usage] 枚举添加:
    • BUNDLE_APPLICATION
  • feature: [ROLE_ACTION] 枚举添加:
    • MANAGE_OBSERVABILITY_PACKAGE
    • MANAGE_OBSERVABILITY_SERVICE
  • feature: [software_edition] 枚举添加：
    • ENTERPRISE_PLUS
  • feature: [upload_resource_type] 枚举添加:
    • HOST_PLUGIN_PACKAGE
  • feature: [task_type] 枚举添加:
    • HOST_PLUGIN

release 日期 2023-02-20

v2.6.0 release

  • feature: [vm_usage] 枚举添加 SKS_MANAGEMENT 与 REGISTRY
  • feature: [ROLEACTION] 枚举添加:
    • MANAGE_SKS_SERVICE
    • MANAGE_SKS_LICENSE
    • CONFIGURE_SKS_SERVICE
    • CREATE_SKS_WORKLOAD_CLUSTER
    • DELETE_SKS_WORKLOAD_CLUSTER
    • UPDATE_SKS_WORKLOAD_CLUSTER
    • DOWNLOAD_SKS_WORKLOAD_CLUSTER_KUBECONFIG

release 日期 2023-01-03

v2.5.0 release

  • bugfix: [IscsiTargetCommonParams]: 修复错误的 BpsWrMaxSize 为 BpsWrMaxUnit
  • feature: IscsiLunSnapshotApi: [create_iscsi_lun_snapshot] 增加了同步创建 lun 快照的选项。
  • feature: ClusterApi: [get_meta_leader]: 增加了获取集群 meta leader 的 api
  • optimize: 增加 header 定义，可以从返回值中获取对应的 XTowerRequestID
  • optimize: [NestedHost]: 嵌套的主机类型额外返回 management_ip

release 日期 2022-11-18

v2.4.0 release

  • feature:CloudTowerApplicationApi: [cloud_tower_application_api] 新增 CloudTowerApplicationApi;
    • [get_cloud_tower_applications] 获取应用;
    • [upload_cloud_tower_application_package] 上传应用包;
    • [delete_cloud_tower_application_package] 删除应用包;
    • [deploy_cloud_tower_application] 部署应用;
    • [upgrade_cloud_tower_application] 升级应用;
    • [uninstall_cloud_tower_application] 删除应用;
  • feature:CloudTowerApplicationPackageApi: [cloud_tower_application_package_api] 新增 CloudTowerApplicationPackageApi;
    • [get_cloud_tower_application_packages] 获取应用包.
  • optimize: 存储容量, 内存容量相关的 api 参数都允许传入 ${field}_unit 形式的参数来为输入参数设置单位，类型为 ByteUnit，默认为 ByteUnit.B;
  • optimize: 带宽相关的 api 参数都允许传入 ${field}_unit 形式的参数来为输入参数设置单位，类型为 BpsUnit，默认为 BpsUnit.Bps.

release 日期 2022-09-05

v2.3.0 release

  • feature:VmVolumeSnapshotApi: [get_vm_volume_snapshots] 新增虚拟卷快照查询 api
  • feature:VmVolumeSnapshotApi: [create_vm_volume_snapshot] 新增创建虚拟卷快照 api
  • feature:VmVolumeSnapshotApi: [delete_vm_volume_snapshot] 新增删除虚拟卷快照 api
  • feature:VmVolumeApi: [clone_vm_volume] 新增克隆虚拟卷 api
  • feature:VmVolumeApi: [rebuild_vm_volume] 新增通过虚拟卷快照重建虚拟卷 api
  • feature:VmVolumeApi: [rollback_vm_volume] 新增回滚虚拟卷至指定虚拟卷快照 api
  • feature:VmVolumeApi: [update_vm_volume] 新增编辑虚拟卷 api
  • feature:UserApi: [get_my_info] 新增查询当前 client 对应用户 api
  • feature:VersionApi: [get_api_info] 新增查询当前 api 版本 api
  • feature:VmApi: 新增内容库镜像支持，[vm_cd_rom_params] 支持传入 content_library_image_id 来挂载内容库镜像
  • optimize: 优化 WaitTask, WaitTasks 方法，并且在没有搜索到对应 taskId 的 task 情况下，尝试等待 task 被创建或直到超时

release 日期 2022-08-12

v2.2.0 release

release 日期 2022-07-08

v2.1.0 release

  • feature:ClusterApi: [update_cluster_network_setting] 新增更新集群网络配置 api

  • feature:ClusterApi: [update_cluster_virtualization_setting] 新增更新集群虚拟化设置 api

  • feature:ClusterApi: [update_cluster_ha_setting] 新增更新集群高可用设置 api

  • feature:ClusterApi: [update_cluster_enable_iscsi_setting] 新增更新集群块功能启用设置 api

  • feature:VmApi: [migratevm_across_cluster] 新增跨集群迁移虚拟机 api

  • feature:VmApi: [abort_migrate_vm_across_cluster] 新增取消跨集群迁移 api

  • feature:VmApi: [stop_vm_in_cutover_migration] 新增关闭源虚拟机 api

  • feature:VmApi: [update_vmHostOptions] 新增更新虚拟机 guest os 设置 api，更新 dns, hostname 与 ntp server，需要虚拟机工具的支持。

  • feature:VmApi: [reset_vmG_guest_ss_password] 新增更新虚拟机 guest os 用户密码 api，需要虚拟机工具的支持。

  • feature:VmApi: [update_vm_owner] 新增更新虚拟机拥有者 api

  • feature:SecurityApi: [update_password_security] 新增更新密码安全设置 api

  • feature:SecurityApi: [update_access_restriction] 新增更新访问限制 api

  • feature:SecurityApi: [update_session_timeout] 新增更新会话超时 api

  • feature:VcenterAccountApi: [update_vcenter_account] 新增更新 vcenter 账号 api

  • feature:VcenterAccountApi: [create_vcenter_account] 新增添加 vcenter 账号 api

  • feature:VsphereEsxiAccountApi: [update_vsphere_esxi_account] 新增更新 vsphere esxi 账号 api

  • feature:SvtImageApi: [upload_svt_image] 新增上传虚拟机镜像 api 工具

  • feature:TableReporterApi: [export_csv] 新增导出 CSV 报表 api

  • feature:UploadTaskApi: [cancel_upload_task] 新增取消上传 api

  • feature:LabelApi: [add_labels_to_resources],[remove_labels_from_resources] 新增想内容库模板，内容库镜像，隔离策略，安全策略添加，删除标签

  • bugfix:ContentLibraryImageApi,ElfImageApi: 修复了上传类 Api 无法正确执行的问题，并优化了上传类 Api 的执行逻辑，第一次上传时会上传第一个分片而非只是创建一个上传任务，详见示例

  • optimize:VmTemplateApi: 优化了模板创建时根据传入的 cpu 参数和模板参数计算缺省值的逻辑

  • optimize:ContentLibraryImageApi: 优化了分发的逻辑，不再同时上传一个镜像至多个集群，等待上传置单个集群后再分发。

  • optimize: 添加了 util.login 方法来维护登录逻辑，不再需要手动赋值 token。

  • optimize: 添加了 util.get_svt_image_version 方法来获取一个虚拟机工具镜像的版本号

  • optimize: 优化了对文件参数的处理，现在可以传递一个 bytes 来作为文件类的参数，而非只能使用文件路径

release 日期：2022-06-13

v2.0.0.post1 release

  • bugfix: [Cluster],[ClusterWhereInput]: 修复 usedMemoryBytes, usedCpuUsage 的数据类型 Long -> Double
  • bugfix: [Host],[HostWhereInput]: 修复 usedMemoryBytes, usedCpuUsage的数据类型 Long -> Double
  • bugfix: [Datacenter],[DatacenterWhereInput]: 修复 usedMemoryBytes, usedCpuUsage 的数据类型 Long -> Double

release 日期：2022-05-20

v2.0.0 release

  • feature: 开放内容库相关 Api [ContentLibraryImage], [ContentLibraryVMTemplate]
  • feature: 新增 [Metric] 功能，用于查询资源性能指标

release 日期：2022-05-20

v1.10.0.post1 release

  • bugfix: [Witness] 从 Witness 中移除了 management_ip

release 日期：2022-05-17

v1.10.0 release

  • breaking change: 直接使用 **kwargs 来构造参数，避免部分构造函数的参数数量超过 255 导致的 3.7- 及以下版本的 Python3 无法使用 sdk 的问题, 如果使用 param = Param(args1,args2,args3) 形式构建参数，需要替换为 param = Param(args1=args1,args2=args2,args3=args3) 或者 param = Param(**{'args1':args1,'args2':args2,'args3':args3})
  • feature: UserApi: [createRootUser]: 创建初始 root 用户，创建用户需要传递 role id，而获取 role id 需要鉴权，提供一个接口在没有账号被建立的情况下创建一个默认的 root 用户，不需要鉴权;
  • feature: VmApi: [expand_vm_disk]: 提供扩容指定虚拟盘的能力;
  • feature: VmApi: [eject_iso_from_vm_cd_rom]: 将 iso 从 vm cdrom 中卸载;
  • feature: VmApi: [toggle_vm_cd_rom_disable]: 禁用、启用 vm cdrom;
  • feature: VmApi: [update_vm_nic_basic_info]: 更新一个虚拟机网卡的常用信息，包括 IP 地址，网关地址，子网掩码，需要虚拟机工具的支持;
  • feature: VmApi: [update_vm_nic_advance_info]: 更新一个虚拟机网卡的非常用信息，包括接入的虚拟网络，sriov 网卡的直连网卡，mac 地址，是否启用，以及是否开启镜像模式;
  • feature: VmApi: [update_vm_advanced_options]: 更新虚拟机的高级信息，包括 CPU 兼容性，虚拟机时钟(UTC、LocalTime)，是否开启为 windows 优化，以及虚拟机显卡型号;
  • optimize: 提供了更加完整的错误返回信息，包含了错误发生的位置，graphql operationName，并透传 tower server 状态码。
  • optimize: 缩短了部分变量类型名称。
  • bugfix: VmApi: [create_vm_from_template], []: 修复了无法在使用模板创建虚拟机时挂载已存在的虚拟机和 cd-rom 的问题，修正 MountDiskParams 中的 index 为可选项。
  • bugfix: 使用了更加准确的数字类型，将以 Byte，HZ 为单位的数字类型从 Double 转为了 Long;
  • bugfix: 修复 waitTask 在 task 出错时会轮询直到超时;
  • bugfix: 将分类错误的 endpoint 移至正确的 api 下:
    • [get_iscsi_connections]: IscsiApi -> IscsiConnectionApi
    • [create_nvmf_subsystem]: DefaultApi -> NvmfSubsystemApi
    • [delete_nvmf_subsystem]: DefaultApi -> NvmfSubsystemApi
    • [update_nvmf_subsystem]: DefaultApi -> NvmfSubsystemApi