diff --git a/ucloud/services/uhost/client.py b/ucloud/services/uhost/client.py index d80f90c..1da46a1 100644 --- a/ucloud/services/uhost/client.py +++ b/ucloud/services/uhost/client.py @@ -71,7 +71,7 @@ def check_uhost_resource_capacity( - **MinimalCpuPlatform** (str) - 最低cpu平台,枚举值["Intel/Auto", "Intel/IvyBridge", "Intel/Haswell", "Intel/Broadwell", "Intel/Skylake", "Intel/Cascadelake", "Intel/CascadelakeR", "Intel/IceLake", "Amd/Epyc2", "Amd/Auto","Ampere/Auto","Ampere/Altra"],默认值是"Intel/Auto"。 - **NetCapability** (str) - 网络增强特性。枚举值:Normal,不开启; Super,开启网络增强1.0; Ultra,开启网络增强2.0(详情参考官网文档) - **SecurityMode** (str) - 主机安全模式。Firewall:防火墙;SecGroup:安全组;默认值:Firewall。 - - **UHostFamily** (str) - 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"\"OM"\"OPRO"\"OPROG"(快杰系列)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o1h: 快杰型 O1 代,Hygon 平台- o2i:快杰型 O2 代,Intel 平台 默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台- om1a:快杰内存增强型 OM1 代,Amd 平台默认值:om1i 或 om1a当 MachineType 为 "OPROG"(快杰PRO通用型)时,支持以下取值: - oprog1i:快杰PRO通用型 OPROG1 代,Intel 平台 - oprog2i:快杰PRO通用型 OPROG2 代,Intel 平台 - oprog1a:快杰PRO通用型 OPROG1 代,Amd 平台 当 MachineType 为 "OPRO"(快杰PRO增强型)时,支持以下取值: - opro1a:快杰PRO增强型 OPRO1 代,Amd 平台 - opro2a:快杰PRO增强型 OPRO2 代,Amd 平台 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。 + - **UHostFamily** (str) - 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"\"OM"\"OPRO"\"OPROG"(快杰系列)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o1h:快杰型 O1 代,Hygon 平台- o2i:快杰型 O2 代,Intel 平台 - o2a:快杰型 O2 代,AMD 平台默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台- om1a:快杰内存增强型 OM1 代,Amd 平台默认值:om1i 或 om1a当 MachineType 为 "OPROG"(快杰PRO通用型)时,支持以下取值: - oprog1i:快杰PRO通用型 OPROG1 代,Intel 平台 - oprog2i:快杰PRO通用型 OPROG2 代,Intel 平台 - oprog1a:快杰PRO通用型 OPROG1 代,Amd 平台 当 MachineType 为 "OPRO"(快杰PRO增强型)时,支持以下取值: - opro1a:快杰PRO增强型 OPRO1 代,Amd 平台 - opro2a:快杰PRO增强型 OPRO2 代,Amd 平台 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。 **Response** @@ -86,6 +86,10 @@ def check_uhost_resource_capacity( - **Journal** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以12小时秒级为基础进行倍数扩增,如12、24、36、48。 + **CheckUHostResourceCapacityParamFeatures** + - **UNI** (bool) - 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启,仅与 NetCapability Normal 兼容。 + + **CheckUHostResourceCapacityParamDisks** - **BackupMode** (str) - 指定快照备份策略。当Disks.N.BackupType为"SNAPSHOT"时此参数生效。枚举值:"Lite":轻量版,"Base":基础版,"Ultimate":旗舰版,"Custom":自定义备份链;默认值:"Base" - **BackupType** (str) - 磁盘备份方案。枚举值:\\ > NONE,无备份 \\ > DATAARK,数据方舟 \\ > SNAPSHOT,快照 \\当前磁盘支持的备份模式参考 `磁盘类型 `_ ,默认值:NONE @@ -97,10 +101,6 @@ def check_uhost_resource_capacity( - **Type** (str) - 磁盘类型。请参考 `磁盘类型 `_ 。 - **CheckUHostResourceCapacityParamFeatures** - - **UNI** (bool) - 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启,仅与 NetCapability Normal 兼容。 - - """ # build request d = { @@ -272,7 +272,7 @@ def create_uhost_instance( - **Tag** (str) - 业务组。默认:Default(Default即为未分组)。请遵照 `字段规范 `_ 设定业务组。 - **UDHostId** (str) - 【私有专区属性】专区宿主机id - **UDSetId** (str) - 【私有专区属性】专区id - - **UHostFamily** (str) - 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"\"OM"\"OPRO"\"OPROG"(快杰系列)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o1h: 快杰型 O1 代,Hygon 平台- o2i:快杰型 O2 代,Intel 平台 默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台- om1a:快杰内存增强型 OM1 代,Amd 平台默认值:om1i 或 om1a当 MachineType 为 "OPROG"(快杰PRO通用型)时,支持以下取值: - oprog1i:快杰PRO通用型 OPROG1 代,Intel 平台 - oprog2i:快杰PRO通用型 OPROG2 代,Intel 平台 - oprog1a:快杰PRO通用型 OPROG1 代,Amd 平台 当 MachineType 为 "OPRO"(快杰PRO增强型)时,支持以下取值: - opro1a:快杰PRO增强型 OPRO1 代,Amd 平台 - opro2a:快杰PRO增强型 OPRO2 代,Amd 平台 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。 + - **UHostFamily** (str) - 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"\"OM"\"OPRO"\"OPROG"(快杰系列)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o1h:快杰型 O1 代,Hygon 平台- o2i:快杰型 O2 代,Intel 平台 - o2a:快杰型 O2 代,AMD 平台默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台- om1a:快杰内存增强型 OM1 代,Amd 平台默认值:om1i 或 om1a当 MachineType 为 "OPROG"(快杰PRO通用型)时,支持以下取值: - oprog1i:快杰PRO通用型 OPROG1 代,Intel 平台 - oprog2i:快杰PRO通用型 OPROG2 代,Intel 平台 - oprog1a:快杰PRO通用型 OPROG1 代,Amd 平台 当 MachineType 为 "OPRO"(快杰PRO增强型)时,支持以下取值: - opro1a:快杰PRO增强型 OPRO1 代,Amd 平台 - opro2a:快杰PRO增强型 OPRO2 代,Amd 平台 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。 - **UHostType** (str) - 【建议后续不再使用】云主机机型(V1.0),在本字段和字段MachineType中,仅需要其中1个字段即可。参考 `云主机机型说明 `_ 。 - **UserData** (str) - 用户自定义数据。当镜像支持Cloud-init Feature时可填写此字段。注意:1、总数据量大小不超过 16K;2、使用base64编码 - **VPCId** (str) - VPC ID。默认为当前地域的默认VPC。 @@ -284,7 +284,23 @@ def create_uhost_instance( **Request Model** - **CreateUHostInstanceParamVolumes** + **CreateUHostInstanceParamDisksCustomBackup** + - **Day** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以5天级为基础进行倍数扩增,如5、10、15、20、25、30。 + - **Hour** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以24小时级为基础进行倍数扩增,如24、48、72、96。 + - **Journal** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以12小时秒级为基础进行倍数扩增,如12、24、36、48。 + + + **CreateUHostInstanceParamDisks** + - **BackupMode** (str) - 指定快照备份策略。当Disks.N.BackupType为"SNAPSHOT"时此参数生效。枚举值:"Base":标准版,"Ultimate":旗舰版,"Custom":自定义备份链;默认值:"Base"。 + - **BackupType** (str) - 磁盘备份方案。枚举值:\\ > NONE,无备份 \\ > SNAPSHOT,快照 \\当前磁盘支持的备份模式参考 `磁盘类型 `_ ,默认值:NONE + - **CouponId** (str) - 云盘代金券id。不适用于系统盘/本地盘。请通过DescribeCoupon接口查询,或登录用户中心查看 + - **CustomBackup** (dict) - 见 **CreateUHostInstanceParamDisksCustomBackup** 模型定义 + - **Encrypted** (bool) - 【功能仅部分可用区开放,详询技术支持】磁盘是否加密。加密:true, 不加密: false加密必须传入对应的的KmsKeyId,默认值false + - **IsBoot** (str) - 是否是系统盘。枚举值:\\ > True,是系统盘 \\ > False,是数据盘(默认)。Disks数组中有且只能有一块盘是系统盘。 + - **KmsKeyId** (str) - 【功能仅部分可用区开放,详询技术支持】kms key id。选择加密盘时必填。 + - **Size** (int) - 磁盘大小,单位GB。请参考 `磁盘类型 `_ 。 + - **SnapshotId** (str) - 从快照创建盘时所用快照id,目前仅支持数据盘 + - **Type** (str) - 磁盘类型。请参考 `磁盘类型 `_ 。 **CreateUHostInstanceParamNetworkInterfaceEIPGlobalSSH** @@ -302,14 +318,9 @@ def create_uhost_instance( - **ShareBandwidthId** (str) - 绑定的共享带宽Id,仅当PayMode为ShareBandwidth时有效 - **CreateUHostInstanceParamDisksCustomBackup** - - **Day** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以5天级为基础进行倍数扩增,如5、10、15、20、25、30。 - - **Hour** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以24小时级为基础进行倍数扩增,如24、48、72、96。 - - **Journal** (str) - Disks.N.BackupMode为"Custom"时,进行设置, 以12小时秒级为基础进行倍数扩增,如12、24、36、48。 - - - **CreateUHostInstanceParamFeatures** - - **UNI** (bool) - 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启。 + **CreateUHostInstanceParamLabels** + - **Key** (str) - 用户资源标签的键值 + - **Value** (str) - 用户资源标签的值 **CreateUHostInstanceParamNetworkInterfaceIPv6** @@ -322,27 +333,16 @@ def create_uhost_instance( - **IPv6** (dict) - 见 **CreateUHostInstanceParamNetworkInterfaceIPv6** 模型定义 - **CreateUHostInstanceParamSecGroupId** - - **Id** (str) - 安全组 ID。至多可以同时绑定5个安全组。 - - **Priority** (int) - 安全组优先级。取值范围[1, 5] + **CreateUHostInstanceParamFeatures** + - **UNI** (bool) - 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启。 - **CreateUHostInstanceParamDisks** - - **BackupMode** (str) - 指定快照备份策略。当Disks.N.BackupType为"SNAPSHOT"时此参数生效。枚举值:"Base":标准版,"Ultimate":旗舰版,"Custom":自定义备份链;默认值:"Base"。 - - **BackupType** (str) - 磁盘备份方案。枚举值:\\ > NONE,无备份 \\ > SNAPSHOT,快照 \\当前磁盘支持的备份模式参考 `磁盘类型 `_ ,默认值:NONE - - **CouponId** (str) - 云盘代金券id。不适用于系统盘/本地盘。请通过DescribeCoupon接口查询,或登录用户中心查看 - - **CustomBackup** (dict) - 见 **CreateUHostInstanceParamDisksCustomBackup** 模型定义 - - **Encrypted** (bool) - 【功能仅部分可用区开放,详询技术支持】磁盘是否加密。加密:true, 不加密: false加密必须传入对应的的KmsKeyId,默认值false - - **IsBoot** (str) - 是否是系统盘。枚举值:\\ > True,是系统盘 \\ > False,是数据盘(默认)。Disks数组中有且只能有一块盘是系统盘。 - - **KmsKeyId** (str) - 【功能仅部分可用区开放,详询技术支持】kms key id。选择加密盘时必填。 - - **Size** (int) - 磁盘大小,单位GB。请参考 `磁盘类型 `_ 。 - - **SnapshotId** (str) - 从快照创建盘时所用快照id,目前仅支持数据盘 - - **Type** (str) - 磁盘类型。请参考 `磁盘类型 `_ 。 + **CreateUHostInstanceParamVolumes** - **CreateUHostInstanceParamLabels** - - **Key** (str) - 用户资源标签的键值 - - **Value** (str) - 用户资源标签的值 + **CreateUHostInstanceParamSecGroupId** + - **Id** (str) - 安全组 ID。至多可以同时绑定5个安全组。 + - **Priority** (int) - 安全组优先级。取值范围[1, 5] """ @@ -475,6 +475,34 @@ def describe_available_instance_types( **Response Model** + **FeatureModes** + - **MinimalCpuPlatform** (list) - 这个特性必须是列出来的CPU平台及以上的CPU才支持 + - **Name** (str) - 模式|特性名称 + - **RelatedToImageFeature** (list) - 为镜像上支持这个特性的标签。例如DescribeImage返回的字段Features包含HotPlug,说明该镜像支持热升级。 + + + **Features** + - **Modes** (list) - 见 **FeatureModes** 模型定义 + - **Name** (str) - 可支持的特性名称。目前支持的特性网络增强|NetCapability、热升级|Hotplug + + + **Collection** + - **Cpu** (int) - CPU规格 + - **Memory** (list) - 内存规格 + - **MinimalCpuPlatform** (list) - CPU和内存规格只能在列出来的CPU平台支持 + + + **MachineSizes** + - **Collection** (list) - 见 **Collection** 模型定义 + - **Gpu** (int) - Gpu为GPU可支持的规格即GPU颗数,非GPU机型,Gpu为0 + + + **CpuPlatforms** + - **Amd** (list) - 返回AMD的CPU平台信息,例如:AMD: ['Amd/Epyc2'] + - **Ampere** (list) - 返回Arm的CPU平台信息,例如:Ampere: ['Ampere/Altra'] + - **Intel** (list) - 返回Intel的CPU平台信息,例如:Intel: ['Intel/CascadeLake','Intel/CascadelakeR','Intel/IceLake'] + + **BootDiskInfo** - **Features** (list) - 磁盘可支持的服务 - **InstantResize** (bool) - 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。 @@ -495,25 +523,14 @@ def describe_available_instance_types( - **Name** (str) - 磁盘介质类别信息,磁盘主要分类如下:云盘|cloudDisk、普通本地盘|normalLocalDisk和SSD本地盘|ssdLocalDisk。 - **Performance** - - **Rate** (int) - 交互展示参数,可忽略 - - **Value** (float) - 值,单位是TFlops - - **GraphicsMemory** - **Rate** (int) - 交互展示参数,可忽略 - **Value** (int) - 值,单位是GB - **Collection** - - **Cpu** (int) - CPU规格 - - **Memory** (list) - 内存规格 - - **MinimalCpuPlatform** (list) - CPU和内存规格只能在列出来的CPU平台支持 - - - **MachineSizes** - - **Collection** (list) - 见 **Collection** 模型定义 - - **Gpu** (int) - Gpu为GPU可支持的规格即GPU颗数,非GPU机型,Gpu为0 + **Performance** + - **Rate** (int) - 交互展示参数,可忽略 + - **Value** (float) - 值,单位是TFlops **CpuPlatformWithModels** @@ -522,23 +539,6 @@ def describe_available_instance_types( - **Name** (str) - CPU平台 - **FeatureModes** - - **MinimalCpuPlatform** (list) - 这个特性必须是列出来的CPU平台及以上的CPU才支持 - - **Name** (str) - 模式|特性名称 - - **RelatedToImageFeature** (list) - 为镜像上支持这个特性的标签。例如DescribeImage返回的字段Features包含HotPlug,说明该镜像支持热升级。 - - - **Features** - - **Modes** (list) - 见 **FeatureModes** 模型定义 - - **Name** (str) - 可支持的特性名称。目前支持的特性网络增强|NetCapability、热升级|Hotplug - - - **CpuPlatforms** - - **Amd** (list) - 返回AMD的CPU平台信息,例如:AMD: ['Amd/Epyc2'] - - **Ampere** (list) - 返回Arm的CPU平台信息,例如:Ampere: ['Ampere/Altra'] - - **Intel** (list) - 返回Intel的CPU平台信息,例如:Intel: ['Intel/CascadeLake','Intel/CascadelakeR','Intel/IceLake'] - - **UHostFamily** - **CpuFrequency** (str) - CPU频率信息 - **CpuPlatforms** (list) - 见 **CpuPlatformWithModels** 模型定义 @@ -589,72 +589,69 @@ def describe_host_machine_type_families( **Response Model** - **NameOperationStatus** - - **Name** (str) - 名称 - - **OperationStatus** (str) - 标记 - - - **DiskFeature** - - **Modes** (list) - 见 **NameOperationStatus** 模型定义 - - **Name** (str) - 特性名称 - - - **FamiliesDataDiskInfo** - - **Features** (list) - 见 **DiskFeature** 模型定义 - - **MaximalSize** (int) - MaximalSize为磁盘最大值 - - **MinimalSize** (int) - 磁盘最小值,如果没有该字段,最小值取基础镜像Size值即可(linux为20G,windows为40G)。 - - **Name** (str) - 数据盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 - - **CpuPlatformWithModels** - **CpuFrequency** (str) - CPU频率 - **CpuModels** (list) - CPU Model列表 - **Name** (str) - CPU平台 - **UHostFamily** - - **CpuFrequency** (str) - CPU频率信息 - - **CpuPlatforms** (list) - 见 **CpuPlatformWithModels** 模型定义 - - **Name** (str) - 规格族 - - - **FamiliesBootDiskInfo** - - **Features** (list) - 见 **DiskFeature** 模型定义 - - **InstantResize** (bool) - 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。 - - **MaximalSize** (int) - MaximalSize为磁盘最大值 - - **Name** (str) - 系统盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 - - **FeatureModes** - **MinimalCpuPlatform** (list) - 这个特性必须是列出来的CPU平台及以上的CPU才支持 - **Name** (str) - 模式|特性名称 - **RelatedToImageFeature** (list) - 为镜像上支持这个特性的标签。例如DescribeImage返回的字段Features包含HotPlug,说明该镜像支持热升级。 + **CpuPlatformStatus** + - **Name** (str) - CPU平台 + - **OperationStatus** (str) - 运营Commpont Code + + + **Performance** + - **Rate** (int) - 交互展示参数,可忽略 + - **Value** (float) - 值,单位是TFlops + + **GraphicsMemory** - **Rate** (int) - 交互展示参数,可忽略 - **Value** (int) - 值,单位是GB - **FamiliesDisks** - - **BootDisk** (list) - 见 **FamiliesBootDiskInfo** 模型定义 - - **DataDisk** (list) - 见 **FamiliesDataDiskInfo** 模型定义 - - **Name** (str) - 磁盘介质类别信息,磁盘主要分类如下:云盘|cloudDisk、普通本地盘|normalLocalDisk和SSD本地盘|ssdLocalDisk。 - - **OperationStatus** (str) - 权限位 + **FamiliesGpuType** + - **GraphicsMemory** (dict) - 见 **GraphicsMemory** 模型定义 + - **Name** (str) - 机型名称 + - **Performance** (dict) - 见 **Performance** 模型定义 - **Features** - - **Modes** (list) - 见 **FeatureModes** 模型定义 - - **Name** (str) - 可支持的特性名称。目前支持的特性网络增强|NetCapability、热升级|Hotplug + **NameOperationStatus** + - **Name** (str) - 名称 + - **OperationStatus** (str) - 标记 + + + **DiskFeature** + - **Modes** (list) - 见 **NameOperationStatus** 模型定义 + - **Name** (str) - 特性名称 + + + **FamiliesBootDiskInfo** + - **Features** (list) - 见 **DiskFeature** 模型定义 + - **InstantResize** (bool) - 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。 + - **MaximalSize** (int) - MaximalSize为磁盘最大值 + - **Name** (str) - 系统盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 + + + **UHostFamily** + - **CpuFrequency** (str) - CPU频率信息 + - **CpuPlatforms** (list) - 见 **CpuPlatformWithModels** 模型定义 + - **Name** (str) - 规格族 **Frequency** - **Value** (float) - 值 - **CpuPlatformStatus** - - **Name** (str) - CPU平台 - - **OperationStatus** (str) - 运营Commpont Code + **NameFrequency** + - **Frequency** (dict) - 见 **Frequency** 模型定义 + - **Name** (str) - 机型名称 **Collection** @@ -663,25 +660,28 @@ def describe_host_machine_type_families( - **MinimalCpuPlatform** (list) - CPU和内存规格只能在列出来的CPU平台支持 - **NameFrequency** - - **Frequency** (dict) - 见 **Frequency** 模型定义 - - **Name** (str) - 机型名称 + **MachineSizes** + - **Collection** (list) - 见 **Collection** 模型定义 + - **Gpu** (int) - Gpu为GPU可支持的规格即GPU颗数,非GPU机型,Gpu为0 - **Performance** - - **Rate** (int) - 交互展示参数,可忽略 - - **Value** (float) - 值,单位是TFlops + **FamiliesDataDiskInfo** + - **Features** (list) - 见 **DiskFeature** 模型定义 + - **MaximalSize** (int) - MaximalSize为磁盘最大值 + - **MinimalSize** (int) - 磁盘最小值,如果没有该字段,最小值取基础镜像Size值即可(linux为20G,windows为40G)。 + - **Name** (str) - 数据盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 - **FamiliesGpuType** - - **GraphicsMemory** (dict) - 见 **GraphicsMemory** 模型定义 - - **Name** (str) - 机型名称 - - **Performance** (dict) - 见 **Performance** 模型定义 + **FamiliesDisks** + - **BootDisk** (list) - 见 **FamiliesBootDiskInfo** 模型定义 + - **DataDisk** (list) - 见 **FamiliesDataDiskInfo** 模型定义 + - **Name** (str) - 磁盘介质类别信息,磁盘主要分类如下:云盘|cloudDisk、普通本地盘|normalLocalDisk和SSD本地盘|ssdLocalDisk。 + - **OperationStatus** (str) - 权限位 - **MachineSizes** - - **Collection** (list) - 见 **Collection** 模型定义 - - **Gpu** (int) - Gpu为GPU可支持的规格即GPU颗数,非GPU机型,Gpu为0 + **Features** + - **Modes** (list) - 见 **FeatureModes** 模型定义 + - **Name** (str) - 可支持的特性名称。目前支持的特性网络增强|NetCapability、热升级|Hotplug **MachineTypes** @@ -845,13 +845,6 @@ def describe_uhost_available_disk_types( **Response Model** - **BootDiskInfo** - - **Features** (list) - 磁盘可支持的服务 - - **InstantResize** (bool) - 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。 - - **MaximalSize** (int) - MaximalSize为磁盘最大值 - - **Name** (str) - 系统盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 - - **DataDiskInfo** - **BackupMode** (list) - 支持的快照备份策略 - **Features** (list) - 数据盘可支持的服务 @@ -860,6 +853,13 @@ def describe_uhost_available_disk_types( - **Name** (str) - 数据盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 + **BootDiskInfo** + - **Features** (list) - 磁盘可支持的服务 + - **InstantResize** (bool) - 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。 + - **MaximalSize** (int) - MaximalSize为磁盘最大值 + - **Name** (str) - 系统盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。 + + **Disks** - **BootDisk** (list) - 见 **BootDiskInfo** 模型定义 - **DataDisk** (list) - 见 **DataDiskInfo** 模型定义 @@ -910,6 +910,12 @@ def describe_uhost_instance( **Response Model** + **UDSetUDHostAttribute** + - **HostBinding** (bool) - 是否绑定私有专区宿主机 + - **UDHostId** (str) - 私有专区宿主机 + - **UDSetId** (str) - 私有专区 + + **SpotAttribute** - **RecycleTime** (int) - 回收时间 @@ -919,18 +925,6 @@ def describe_uhost_instance( - **KeyPairState** (str) - 主机密钥对状态,Normal 正常,Deleted 删除 - **UHostDiskSet** - - **BackupType** (str) - 备份方案。若开通了数据方舟,则为DATAARK - - **DiskId** (str) - 磁盘ID - - **DiskType** (str) - 磁盘类型。请参考 `磁盘类型 `_ 。 - - **Drive** (str) - 磁盘盘符 - - **Encrypted** (str) - "true": 加密盘 "false":非加密盘 - - **IsBoot** (str) - 是否是系统盘。枚举值:\\ > True,是系统盘 \\ > False,是数据盘(默认)。Disks数组中有且只能有一块盘是系统盘。 - - **Name** (str) - UDisk名字(仅当磁盘是UDisk时返回) - - **Size** (int) - 磁盘大小,单位: GB - - **Type** (str) - 【建议不再使用】磁盘类型。系统盘: Boot,数据盘: Data,网络盘:Udisk - - **UHostIPSet** - **Bandwidth** (int) - IP对应的带宽, 单位: Mb (内网IP不显示带宽信息) - **Default** (str) - 内网 Private 类型下,表示是否为默认网卡。true: 是默认网卡;其他值:不是。 @@ -945,10 +939,16 @@ def describe_uhost_instance( - **Weight** (int) - 当前EIP的权重。权重最大的为当前的出口IP。 - **UDSetUDHostAttribute** - - **HostBinding** (bool) - 是否绑定私有专区宿主机 - - **UDHostId** (str) - 私有专区宿主机 - - **UDSetId** (str) - 私有专区 + **UHostDiskSet** + - **BackupType** (str) - 备份方案。若开通了数据方舟,则为DATAARK + - **DiskId** (str) - 磁盘ID + - **DiskType** (str) - 磁盘类型。请参考 `磁盘类型 `_ 。 + - **Drive** (str) - 磁盘盘符 + - **Encrypted** (str) - "true": 加密盘 "false":非加密盘 + - **IsBoot** (str) - 是否是系统盘。枚举值:\\ > True,是系统盘 \\ > False,是数据盘(默认)。Disks数组中有且只能有一块盘是系统盘。 + - **Name** (str) - UDisk名字(仅当磁盘是UDisk时返回) + - **Size** (int) - 磁盘大小,单位: GB + - **Type** (str) - 【建议不再使用】磁盘类型。系统盘: Boot,数据盘: Data,网络盘:Udisk **UHostInstanceSet** @@ -1199,7 +1199,7 @@ def get_uhost_instance_price( - **Quantity** (int) - 购买时长。默认: 1。按小时购买(Dynamic)时无需此参数。 月付时,此参数传0,代表了购买至月末。 - **ShowPriceDetails** (bool) - 返回价格详细信息 - **UDSetUHostInstance** (bool) - 专区云主机。如果要在专区宿主机上创建云主机,该参数可以填写为true - - **UHostFamily** (str) - 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"\"OM"\"OPRO"\"OPROG"(快杰系列)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o1h: 快杰型 O1 代,Hygon 平台- o2i:快杰型 O2 代,Intel 平台 默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台- om1a:快杰内存增强型 OM1 代,Amd 平台默认值:om1i 或 om1a当 MachineType 为 "OPROG"(快杰PRO通用型)时,支持以下取值: - oprog1i:快杰PRO通用型 OPROG1 代,Intel 平台 - oprog2i:快杰PRO通用型 OPROG2 代,Intel 平台 - oprog1a:快杰PRO通用型 OPROG1 代,Amd 平台 当 MachineType 为 "OPRO"(快杰PRO增强型)时,支持以下取值: - opro1a:快杰PRO增强型 OPRO1 代,Amd 平台 - opro2a:快杰PRO增强型 OPRO2 代,Amd 平台 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。 + - **UHostFamily** (str) - 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"\"OM"\"OPRO"\"OPROG"(快杰系列)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o1h:快杰型 O1 代,Hygon 平台- o2i:快杰型 O2 代,Intel 平台 - o2a:快杰型 O2 代,AMD 平台默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台- om1a:快杰内存增强型 OM1 代,Amd 平台默认值:om1i 或 om1a当 MachineType 为 "OPROG"(快杰PRO通用型)时,支持以下取值: - oprog1i:快杰PRO通用型 OPROG1 代,Intel 平台 - oprog2i:快杰PRO通用型 OPROG2 代,Intel 平台 - oprog1a:快杰PRO通用型 OPROG1 代,Amd 平台 当 MachineType 为 "OPRO"(快杰PRO增强型)时,支持以下取值: - opro1a:快杰PRO增强型 OPRO1 代,Amd 平台 - opro2a:快杰PRO增强型 OPRO2 代,Amd 平台 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。 - **UHostType** (str) - 【待废弃】云主机机型(V1版本概念)。参考 `云主机机型说明 `_ 。 - **Zone** (str) - 可用区。参见 `可用区列表 `_ diff --git a/ucloud/services/uhost/schemas/apis.py b/ucloud/services/uhost/schemas/apis.py index ded40c2..321423f 100644 --- a/ucloud/services/uhost/schemas/apis.py +++ b/ucloud/services/uhost/schemas/apis.py @@ -53,6 +53,14 @@ class CheckUHostResourceCapacityParamDisksCustomBackupSchema( } +class CheckUHostResourceCapacityParamFeaturesSchema(schema.RequestSchema): + """CheckUHostResourceCapacityParamFeatures -""" + + fields = { + "UNI": fields.Bool(required=False, dump_to="UNI"), + } + + class CheckUHostResourceCapacityParamDisksSchema(schema.RequestSchema): """CheckUHostResourceCapacityParamDisks -""" @@ -70,14 +78,6 @@ class CheckUHostResourceCapacityParamDisksSchema(schema.RequestSchema): } -class CheckUHostResourceCapacityParamFeaturesSchema(schema.RequestSchema): - """CheckUHostResourceCapacityParamFeatures -""" - - fields = { - "UNI": fields.Bool(required=False, dump_to="UNI"), - } - - class CheckUHostResourceCapacityRequestSchema(schema.RequestSchema): """CheckUHostResourceCapacity - 主机创建资源余量检查""" @@ -230,10 +230,33 @@ class CreateIsolationGroupResponseSchema(schema.ResponseSchema): """ -class CreateUHostInstanceParamVolumesSchema(schema.RequestSchema): - """CreateUHostInstanceParamVolumes -""" +class CreateUHostInstanceParamDisksCustomBackupSchema(schema.RequestSchema): + """CreateUHostInstanceParamDisksCustomBackup -""" - fields = {} + fields = { + "Day": fields.Str(required=False, dump_to="Day"), + "Hour": fields.Str(required=False, dump_to="Hour"), + "Journal": fields.Str(required=False, dump_to="Journal"), + } + + +class CreateUHostInstanceParamDisksSchema(schema.RequestSchema): + """CreateUHostInstanceParamDisks -""" + + fields = { + "BackupMode": fields.Str(required=False, dump_to="BackupMode"), + "BackupType": fields.Str(required=False, dump_to="BackupType"), + "CouponId": fields.Str(required=False, dump_to="CouponId"), + "CustomBackup": CreateUHostInstanceParamDisksCustomBackupSchema( + required=False, dump_to="CustomBackup" + ), + "Encrypted": fields.Bool(required=False, dump_to="Encrypted"), + "IsBoot": fields.Str(required=True, dump_to="IsBoot"), + "KmsKeyId": fields.Str(required=False, dump_to="KmsKeyId"), + "Size": fields.Int(required=True, dump_to="Size"), + "SnapshotId": fields.Str(required=False, dump_to="SnapshotId"), + "Type": fields.Str(required=True, dump_to="Type"), + } class CreateUHostInstanceParamNetworkInterfaceEIPGlobalSSHSchema( @@ -266,21 +289,12 @@ class CreateUHostInstanceParamNetworkInterfaceEIPSchema(schema.RequestSchema): } -class CreateUHostInstanceParamDisksCustomBackupSchema(schema.RequestSchema): - """CreateUHostInstanceParamDisksCustomBackup -""" - - fields = { - "Day": fields.Str(required=False, dump_to="Day"), - "Hour": fields.Str(required=False, dump_to="Hour"), - "Journal": fields.Str(required=False, dump_to="Journal"), - } - - -class CreateUHostInstanceParamFeaturesSchema(schema.RequestSchema): - """CreateUHostInstanceParamFeatures -""" +class CreateUHostInstanceParamLabelsSchema(schema.RequestSchema): + """CreateUHostInstanceParamLabels -""" fields = { - "UNI": fields.Bool(required=False, dump_to="UNI"), + "Key": fields.Str(required=False, dump_to="Key"), + "Value": fields.Str(required=False, dump_to="Value"), } @@ -309,40 +323,26 @@ class CreateUHostInstanceParamNetworkInterfaceSchema(schema.RequestSchema): } -class CreateUHostInstanceParamSecGroupIdSchema(schema.RequestSchema): - """CreateUHostInstanceParamSecGroupId -""" +class CreateUHostInstanceParamFeaturesSchema(schema.RequestSchema): + """CreateUHostInstanceParamFeatures -""" fields = { - "Id": fields.Str(required=False, dump_to="Id"), - "Priority": fields.Int(required=False, dump_to="Priority"), + "UNI": fields.Bool(required=False, dump_to="UNI"), } -class CreateUHostInstanceParamDisksSchema(schema.RequestSchema): - """CreateUHostInstanceParamDisks -""" +class CreateUHostInstanceParamVolumesSchema(schema.RequestSchema): + """CreateUHostInstanceParamVolumes -""" - fields = { - "BackupMode": fields.Str(required=False, dump_to="BackupMode"), - "BackupType": fields.Str(required=False, dump_to="BackupType"), - "CouponId": fields.Str(required=False, dump_to="CouponId"), - "CustomBackup": CreateUHostInstanceParamDisksCustomBackupSchema( - required=False, dump_to="CustomBackup" - ), - "Encrypted": fields.Bool(required=False, dump_to="Encrypted"), - "IsBoot": fields.Str(required=True, dump_to="IsBoot"), - "KmsKeyId": fields.Str(required=False, dump_to="KmsKeyId"), - "Size": fields.Int(required=True, dump_to="Size"), - "SnapshotId": fields.Str(required=False, dump_to="SnapshotId"), - "Type": fields.Str(required=True, dump_to="Type"), - } + fields = {} -class CreateUHostInstanceParamLabelsSchema(schema.RequestSchema): - """CreateUHostInstanceParamLabels -""" +class CreateUHostInstanceParamSecGroupIdSchema(schema.RequestSchema): + """CreateUHostInstanceParamSecGroupId -""" fields = { - "Key": fields.Str(required=False, dump_to="Key"), - "Value": fields.Str(required=False, dump_to="Value"), + "Id": fields.Str(required=False, dump_to="Id"), + "Priority": fields.Int(required=False, dump_to="Priority"), } diff --git a/ucloud/services/uhost/schemas/models.py b/ucloud/services/uhost/schemas/models.py index ac15f36..c5b2985 100644 --- a/ucloud/services/uhost/schemas/models.py +++ b/ucloud/services/uhost/schemas/models.py @@ -63,12 +63,32 @@ class DisksSchema(schema.ResponseSchema): } -class PerformanceSchema(schema.ResponseSchema): - """Performance - GPU的性能指标""" +class FeatureModesSchema(schema.ResponseSchema): + """FeatureModes - 可以支持的模式类别""" fields = { - "Rate": fields.Int(required=False, load_from="Rate"), - "Value": fields.Float(required=False, load_from="Value"), + "MinimalCpuPlatform": fields.List(fields.Str()), + "Name": fields.Str(required=False, load_from="Name"), + "RelatedToImageFeature": fields.List(fields.Str()), + } + + +class FeaturesSchema(schema.ResponseSchema): + """Features - 虚机可支持的特性""" + + fields = { + "Modes": fields.List(FeatureModesSchema()), + "Name": fields.Str(required=False, load_from="Name"), + } + + +class CpuPlatformsSchema(schema.ResponseSchema): + """CpuPlatforms - CPU平台信息""" + + fields = { + "Amd": fields.List(fields.Str()), + "Ampere": fields.List(fields.Str()), + "Intel": fields.List(fields.Str()), } @@ -91,16 +111,6 @@ class MachineSizesSchema(schema.ResponseSchema): } -class FeatureModesSchema(schema.ResponseSchema): - """FeatureModes - 可以支持的模式类别""" - - fields = { - "MinimalCpuPlatform": fields.List(fields.Str()), - "Name": fields.Str(required=False, load_from="Name"), - "RelatedToImageFeature": fields.List(fields.Str()), - } - - class CpuPlatformWithModelsSchema(schema.ResponseSchema): """CpuPlatformWithModels -""" @@ -111,21 +121,12 @@ class CpuPlatformWithModelsSchema(schema.ResponseSchema): } -class CpuPlatformsSchema(schema.ResponseSchema): - """CpuPlatforms - CPU平台信息""" - - fields = { - "Amd": fields.List(fields.Str()), - "Ampere": fields.List(fields.Str()), - "Intel": fields.List(fields.Str()), - } - - -class FeaturesSchema(schema.ResponseSchema): - """Features - 虚机可支持的特性""" +class UHostFamilySchema(schema.ResponseSchema): + """UHostFamily -""" fields = { - "Modes": fields.List(FeatureModesSchema()), + "CpuFrequency": fields.Str(required=False, load_from="CpuFrequency"), + "CpuPlatforms": fields.List(CpuPlatformWithModelsSchema()), "Name": fields.Str(required=False, load_from="Name"), } @@ -139,13 +140,12 @@ class GraphicsMemorySchema(schema.ResponseSchema): } -class UHostFamilySchema(schema.ResponseSchema): - """UHostFamily -""" +class PerformanceSchema(schema.ResponseSchema): + """Performance - GPU的性能指标""" fields = { - "CpuFrequency": fields.Str(required=False, load_from="CpuFrequency"), - "CpuPlatforms": fields.List(CpuPlatformWithModelsSchema()), - "Name": fields.Str(required=False, load_from="Name"), + "Rate": fields.Int(required=False, load_from="Rate"), + "Value": fields.Float(required=False, load_from="Value"), } @@ -170,16 +170,6 @@ class AvailableInstanceTypesSchema(schema.ResponseSchema): } -class FamiliesGpuTypeSchema(schema.ResponseSchema): - """FamiliesGpuType -""" - - fields = { - "GraphicsMemory": GraphicsMemorySchema(), - "Name": fields.Str(required=False, load_from="Name"), - "Performance": PerformanceSchema(), - } - - class NameOperationStatusSchema(schema.ResponseSchema): """NameOperationStatus - 名称及标记""" @@ -211,27 +201,20 @@ class FamiliesDataDiskInfoSchema(schema.ResponseSchema): } -class FamiliesBootDiskInfoSchema(schema.ResponseSchema): - """FamiliesBootDiskInfo - 系统盘信息""" +class FrequencySchema(schema.ResponseSchema): + """Frequency - 频率""" fields = { - "Features": fields.List(DiskFeatureSchema()), - "InstantResize": fields.Bool(required=False, load_from="InstantResize"), - "MaximalSize": fields.Int(required=False, load_from="MaximalSize"), - "Name": fields.Str(required=False, load_from="Name"), + "Value": fields.Float(required=False, load_from="Value"), } -class FamiliesDisksSchema(schema.ResponseSchema): - """FamiliesDisks - 磁盘信息""" +class NameFrequencySchema(schema.ResponseSchema): + """NameFrequency - 名称及频率""" fields = { - "BootDisk": fields.List(FamiliesBootDiskInfoSchema()), - "DataDisk": fields.List(FamiliesDataDiskInfoSchema()), + "Frequency": FrequencySchema(), "Name": fields.Str(required=False, load_from="Name"), - "OperationStatus": fields.Str( - required=False, load_from="OperationStatus" - ), } @@ -246,20 +229,37 @@ class CpuPlatformStatusSchema(schema.ResponseSchema): } -class FrequencySchema(schema.ResponseSchema): - """Frequency - 频率""" +class FamiliesBootDiskInfoSchema(schema.ResponseSchema): + """FamiliesBootDiskInfo - 系统盘信息""" fields = { - "Value": fields.Float(required=False, load_from="Value"), + "Features": fields.List(DiskFeatureSchema()), + "InstantResize": fields.Bool(required=False, load_from="InstantResize"), + "MaximalSize": fields.Int(required=False, load_from="MaximalSize"), + "Name": fields.Str(required=False, load_from="Name"), } -class NameFrequencySchema(schema.ResponseSchema): - """NameFrequency - 名称及频率""" +class FamiliesDisksSchema(schema.ResponseSchema): + """FamiliesDisks - 磁盘信息""" fields = { - "Frequency": FrequencySchema(), + "BootDisk": fields.List(FamiliesBootDiskInfoSchema()), + "DataDisk": fields.List(FamiliesDataDiskInfoSchema()), "Name": fields.Str(required=False, load_from="Name"), + "OperationStatus": fields.Str( + required=False, load_from="OperationStatus" + ), + } + + +class FamiliesGpuTypeSchema(schema.ResponseSchema): + """FamiliesGpuType -""" + + fields = { + "GraphicsMemory": GraphicsMemorySchema(), + "Name": fields.Str(required=False, load_from="Name"), + "Performance": PerformanceSchema(), } @@ -374,6 +374,15 @@ class UDSetUDHostAttributeSchema(schema.ResponseSchema): } +class UHostKeyPairSchema(schema.ResponseSchema): + """UHostKeyPair - 主机密钥信息""" + + fields = { + "KeyPairId": fields.Str(required=False, load_from="KeyPairId"), + "KeyPairState": fields.Str(required=False, load_from="KeyPairState"), + } + + class UHostIPSetSchema(schema.ResponseSchema): """UHostIPSet - DescribeUHostInstance""" @@ -394,12 +403,11 @@ class UHostIPSetSchema(schema.ResponseSchema): } -class UHostKeyPairSchema(schema.ResponseSchema): - """UHostKeyPair - 主机密钥信息""" +class SpotAttributeSchema(schema.ResponseSchema): + """SpotAttribute - 竞价实例属性""" fields = { - "KeyPairId": fields.Str(required=False, load_from="KeyPairId"), - "KeyPairState": fields.Str(required=False, load_from="KeyPairState"), + "RecycleTime": fields.Int(required=False, load_from="RecycleTime"), } @@ -419,14 +427,6 @@ class UHostDiskSetSchema(schema.ResponseSchema): } -class SpotAttributeSchema(schema.ResponseSchema): - """SpotAttribute - 竞价实例属性""" - - fields = { - "RecycleTime": fields.Int(required=False, load_from="RecycleTime"), - } - - class UHostInstanceSetSchema(schema.ResponseSchema): """UHostInstanceSet - DescribeUHostInstance""" diff --git a/ucloud/version.py b/ucloud/version.py index 3b9cfb0..36de724 100644 --- a/ucloud/version.py +++ b/ucloud/version.py @@ -1 +1 @@ -version = "0.11.144" +version = "0.11.145"