v2.17.0 release (tower version 4.3.0)
- 新增 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 网卡
- [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 网卡
- [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: 修复当内容库模板仅分发在存算分离的集群时,无法创建虚拟机的问题。
v2.16.0 release (tower version 4.2.0)
- [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 参数
- [HostApi]:
- [create_host]: 新增
vdses
字段适配网络融合,新增zbsSpec
字段适配 zbs 560 以上版本集群的添加
- [create_host]: 新增
- [VmApi]:
- [get_vms]: 新增
bios_uuid
字段
- [get_vms]: 新增
- 新增 [image_utils] 工具类,支持通过 uploadTask 来获取上传后的 elfImage 与 contentLibraryImage
v2.15.1 release (tower version 4.1.0)
- [Vm], [VmVolume], [IscsiLun], [NvmfNameSpace], [NfsInode]: 更新
unique_logical_size
类型为double
v2.15.0 release (tower version 4.1.0)
- [CommonHeader]: 新增默认返回 Header 类
- [ContentLanguage]: 新增枚举规范返回语言,用于设置请求头的
content-language
- [NestedLabel], [LabelApi]:
LabelApi
将会返回一致的Label
相关的属性,NestedLabel 额外返回key
和value
。 - [Vm], [VmVolume], [IscsiLun], [NvmfNameSpace], [NfsInode]: 新增返回
unique_logical_size
用于表示资源的独占逻辑容量
- [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 时无法更新组内虚拟机成员
- [create_vm_placement_group], [update_vm_placement_group]: 修复了创建与更新放置组时,
v2.14.2 release (tower version 4.0.0)
- [Utils]: 修复错误的 ldap 登陆
v2.14.1 release (tower version 4.0.0)
- [VmVolumeElfStoragePolicyType]: 修复错误的枚举类型
v2.14.0 release (tower version 4.0.0)
- [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]: 创建虚拟机时支持配置虚拟机所属用户
- [ContentLibraryImageApi]:
- [update_content_library_image]: 修复了更新内容库镜像时,没有传递 name 会失败的问题
- [ElfImageApi]:
- [update_elf_image]: 修复了更新镜像时,没有传递 name 会失败的问题
- [vmApi]:
v2.13.0 release (tower version 3.4.0)
- [ROLEACTION] 新增
SMTX_INSPECTOR
v2.12.0 release (tower version 3.3.0)
- [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
- [remove_vm_nic]
- [NicApi] [update_nic] 支持通过
nic_user_usage
更新网口用途 - [LabelApi] 支持为 GPU 设备打标签
- 去除 python2.7 不兼容的内容
v2.11.1 release (tower version 3.2.0)
- bugfix: 修复
utils.login
LDAP 登陆失败的问题
v2.11.0 release (tower version 3.2.0)
- [VmApi] [VmImportParams]: 由于
_vm_nicParams
支持配置 qos 配置,现在设计网卡的参数由_vm_nicParams
更新为了VmImportNicParams
,类型和过去一致,没有 qos 支持。
- 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 参数
- [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] 修复了特例报警无法正常更新的问题
v2.10.0 release (tower version 3.1.0)
- feature: [AlertNotifierApi] 支持更新,删除以及创建新的报警通知配置
- optimize: [utils] 优化了 WaitTask 以及 WaitTasks,在任务失败的时候会返回失败任务的原因
v2.9.1 release (tower version 3.0.0)
- optimize: 优化了 utils.login,当使用 UserSource.LDAP 进行登录时,自动使用 LDAP 登录源进行登陆,方便迁移
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
已判断资源目前的状态
v2.8.0 release
- optimize: VlanApi: [vm_vlan_creation_params], [vm_vlan_updation_params_data], [management_vlan_updation_params_data] 限制
VlanId
范围为 0~4095
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
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
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
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
.
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 被创建或直到超时
v2.2.0 release
- feature:VmApi: create_vm_from_content_library_template 新增通过内容库模板创建虚拟机 api
- bugfix: 正确生成嵌套类型的数字类型
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
来作为文件类的参数,而非只能使用文件路径
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
v2.0.0 release
- feature: 开放内容库相关 Api [ContentLibraryImage], [ContentLibraryVMTemplate]
- feature: 新增 [Metric] 功能,用于查询资源性能指标
v1.10.0.post1 release
- bugfix: [Witness] 从
Witness
中移除了management_ip
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