@ucloud-sdks/ucloud-sdk-js 0.2.18 → 0.2.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,6 +9,12 @@ export default class UHostClient extends Client {
9
9
  config: ConfigOptions;
10
10
  credential: CredentialOptions;
11
11
  });
12
+ /**
13
+ * CheckUHostResourceCapacity - 主机创建资源余量检查
14
+ *
15
+ * See also: https://docs.ucloud.cn/api/uhost-api/check_uhost_resource_capacity
16
+ */
17
+ checkUHostResourceCapacity(request?: CheckUHostResourceCapacityRequest): Promise<CheckUHostResourceCapacityResponse>;
12
18
  /**
13
19
  * CopyCustomImage - 复制自制镜像
14
20
  *
@@ -57,6 +63,12 @@ export default class UHostClient extends Client {
57
63
  * See also: https://docs.ucloud.cn/api/uhost-api/describe_available_instance_types
58
64
  */
59
65
  describeAvailableInstanceTypes(request?: DescribeAvailableInstanceTypesRequest): Promise<DescribeAvailableInstanceTypesResponse>;
66
+ /**
67
+ * DescribeHostMachineTypeFamilies - 获取实例规格族列表(所有机型的信息)
68
+ *
69
+ * See also: https://docs.ucloud.cn/api/uhost-api/describe_host_machine_type_families
70
+ */
71
+ describeHostMachineTypeFamilies(request?: DescribeHostMachineTypeFamiliesRequest): Promise<DescribeHostMachineTypeFamiliesResponse>;
60
72
  /**
61
73
  * DescribeImage - 获取指定数据中心镜像列表,用户可通过指定操作系统类型,镜像Id进行过滤。
62
74
  *
@@ -69,6 +81,12 @@ export default class UHostClient extends Client {
69
81
  * See also: https://docs.ucloud.cn/api/uhost-api/describe_isolation_group
70
82
  */
71
83
  describeIsolationGroup(request?: DescribeIsolationGroupRequest): Promise<DescribeIsolationGroupResponse>;
84
+ /**
85
+ * DescribeUHostAvailableDiskTypes - 获取主机可挂载的磁盘信息
86
+ *
87
+ * See also: https://docs.ucloud.cn/api/uhost-api/describe_uhost_available_disk_types
88
+ */
89
+ describeUHostAvailableDiskTypes(request?: DescribeUHostAvailableDiskTypesRequest): Promise<DescribeUHostAvailableDiskTypesResponse>;
72
90
  /**
73
91
  * DescribeUHostInstance - 获取主机或主机列表信息,并可根据数据中心,主机ID等参数进行过滤。
74
92
  *
@@ -105,6 +123,18 @@ export default class UHostClient extends Client {
105
123
  * See also: https://docs.ucloud.cn/api/uhost-api/get_uhost_instance_vnc_info
106
124
  */
107
125
  getUHostInstanceVncInfo(request?: GetUHostInstanceVncInfoRequest): Promise<GetUHostInstanceVncInfoResponse>;
126
+ /**
127
+ * GetUHostRefundPrice - 获取主机删除扣除费用。包括主机、磁盘、快照服务、EIP等资源的费用
128
+ *
129
+ * See also: https://docs.ucloud.cn/api/uhost-api/get_uhost_refund_price
130
+ */
131
+ getUHostRefundPrice(request?: GetUHostRefundPriceRequest): Promise<GetUHostRefundPriceResponse>;
132
+ /**
133
+ * GetUHostRenewPrice - 获取主机续费价格
134
+ *
135
+ * See also: https://docs.ucloud.cn/api/uhost-api/get_uhost_renew_price
136
+ */
137
+ getUHostRenewPrice(request?: GetUHostRenewPriceRequest): Promise<GetUHostRenewPriceResponse>;
108
138
  /**
109
139
  * GetUHostUpgradePrice - 获取UHost实例升级配置的价格。可选配置范围请参考[[api:uhost-api:uhost_type|云主机机型说明]]。
110
140
  *
@@ -213,12 +243,147 @@ export default class UHostClient extends Client {
213
243
  * See also: https://docs.ucloud.cn/api/uhost-api/terminate_uhost_instance
214
244
  */
215
245
  terminateUHostInstance(request?: TerminateUHostInstanceRequest): Promise<TerminateUHostInstanceResponse>;
246
+ }
247
+ /**
248
+ * CheckUHostResourceCapacity - 主机创建资源余量检查
249
+ */
250
+ export interface CheckUHostResourceCapacityRequest {
251
+ /**
252
+ * 可用区。参见 [可用区列表](https://docs.ucloud.cn/api/summary/regionlist)
253
+ */
254
+ Zone: string;
255
+ /**
256
+ * 镜像ID。 请通过 [DescribeImage](describe_image.html)获取
257
+ */
258
+ ImageId: string;
216
259
  /**
217
- * UpgradeToArkUHostInstance - 普通升级为方舟机型
218
260
  *
219
- * See also: https://docs.ucloud.cn/api/uhost-api/upgrade_to_ark_uhost_instance
220
261
  */
221
- upgradeToArkUHostInstance(request?: UpgradeToArkUHostInstanceRequest): Promise<UpgradeToArkUHostInstanceResponse>;
262
+ Disks?: {
263
+ /**
264
+ * 是否是系统盘。枚举值:\\ > True,是系统盘 \\ > False,是数据盘(默认)。Disks数组中有且只能有一块盘是系统盘。
265
+ */
266
+ IsBoot: string;
267
+ /**
268
+ * 磁盘类型。请参考[[api:uhost-api:disk_type|磁盘类型]]。
269
+ */
270
+ Type: string;
271
+ /**
272
+ * 磁盘大小,单位GB。请参考[[api:uhost-api:disk_type|磁盘类型]]。
273
+ */
274
+ Size: number;
275
+ /**
276
+ * 磁盘备份方案。枚举值:\\ > NONE,无备份 \\ > DATAARK,数据方舟 \\ > SNAPSHOT,快照 \\当前磁盘支持的备份模式参考 [[api:uhost-api:disk_type|磁盘类型]],默认值:NONE
277
+ */
278
+ BackupType?: string;
279
+ /**
280
+ * 云盘代金券id。不适用于系统盘/本地盘。请通过DescribeCoupon接口查询,或登录用户中心查看
281
+ */
282
+ CouponId?: string;
283
+ /**
284
+ * 指定快照备份策略。当Disks.N.BackupType为"SNAPSHOT"时此参数生效。枚举值:"Lite":轻量版,"Base":基础版,"Ultimate":旗舰版,"Custom":自定义备份链;默认值:"Base"
285
+ */
286
+ BackupMode?: string;
287
+ /**
288
+ *
289
+ */
290
+ CustomBackup?: {
291
+ /**
292
+ * Disks.N.BackupMode为"Custom"时,进行设置, 以12小时秒级为基础进行倍数扩增,如12、24、36、48。
293
+ */
294
+ Journal?: string;
295
+ /**
296
+ * Disks.N.BackupMode为"Custom"时,进行设置, 以24小时级为基础进行倍数扩增,如24、48、72、96。
297
+ */
298
+ Hour?: string;
299
+ /**
300
+ * Disks.N.BackupMode为"Custom"时,进行设置, 以5天级为基础进行倍数扩增,如5、10、15、20、25、30。
301
+ */
302
+ Day?: string;
303
+ };
304
+ /**
305
+ * 从快照创建盘时所用快照id,目前仅支持数据盘
306
+ */
307
+ SnapshotId?: string;
308
+ }[];
309
+ /**
310
+ * 计费模式。枚举值为: \\ > Year,按年付费; \\ > Month,按月付费;\\ > Dynamic,按小时预付费 \\ > Postpay,按小时后付费(支持关机不收费,目前仅部分可用区支持,请联系您的客户经理) \\ > Spot计费为抢占式实例(内测阶段) \\ 默认为月付
311
+ */
312
+ ChargeType?: string;
313
+ /**
314
+ * 虚拟CPU核数。可选参数:1-64(具体机型与CPU的对应关系参照控制台)。默认值: 4。
315
+ */
316
+ CPU?: number;
317
+ /**
318
+ * 内存大小。单位:MB。范围 :[1024, 262144],取值为1024的倍数(可选范围参考控制台)。默认值:8192
319
+ */
320
+ Memory?: number;
321
+ /**
322
+ * GPU类型,枚举值["K80", "P40", "V100", "T4","T4A", "T4S","2080Ti","2080Ti-4C","1080Ti", "T4/4", "MI100", "V100S",2080","2080TiS","2080TiPro","3090","A100", "4090", "4090Pro", "4090_48G", "5090"],MachineType为G时必填
323
+ */
324
+ GpuType?: string;
325
+ /**
326
+ * GPU卡核心数。仅GPU机型支持此字段(可选范围与MachineType+GpuType相关)
327
+ */
328
+ GPU?: number;
329
+ /**
330
+ * 网络增强特性。枚举值:Normal,不开启; Super,开启网络增强1.0; Ultra,开启网络增强2.0(详情参考官网文档)
331
+ */
332
+ NetCapability?: string;
333
+ /**
334
+ * 热升级特性。True为开启,False为未开启,默认False。
335
+ */
336
+ HotplugFeature?: boolean;
337
+ /**
338
+ * 硬件隔离组id。可通过DescribeIsolationGroup获取。
339
+ */
340
+ IsolationGroup?: string;
341
+ /**
342
+ * 云主机机型(V2.0),在本字段和字段UHostType中,仅需要其中1个字段即可。枚举值["N", "C", "G", "O", "OS", "OM", "OPRO", "OMAX", "O.BM", "O.EPC"]。参考[[api:uhost-api:uhost_type|云主机机型说明]]。
343
+ */
344
+ MachineType?: string;
345
+ /**
346
+ * 最低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"。
347
+ */
348
+ MinimalCpuPlatform?: string;
349
+ /**
350
+ * 本次最大创建主机数量,取值范围是[1,100],默认值为1。
351
+ */
352
+ MaxCount?: number;
353
+ /**
354
+ *
355
+ */
356
+ Features?: {
357
+ /**
358
+ * 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启,仅与 NetCapability Normal 兼容。
359
+ */
360
+ UNI?: boolean;
361
+ };
362
+ /**
363
+ * 主机安全模式。Firewall:防火墙;SecGroup:安全组;默认值:Firewall。
364
+ */
365
+ SecurityMode?: string;
366
+ /**
367
+ * 规格族。由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。当 MachineType 为 "O"(快杰型)时,支持以下取值:o1i:快杰型 O1 代,Intel 平台o1a:快杰型 O1 代,AMD 平台o1r:快杰型 O1 代,ARM 平台o2i:快杰型 O2 代,Intel 平台默认值:o1i 或 o1a(系统将根据资源情况自动选择)当 MachineType 为 "OM"(快杰共享型)时,支持以下取值:om1i:快杰内存增强型 OM1 代,Intel 平台om2i:快杰内存增强型 OM2 代,Intel 平台⚠️ 注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。
368
+ */
369
+ UHostFamily?: string;
370
+ /**
371
+ * 本次最小创建主机数量,取值范围是[1,100],默认值为1。
372
+ */
373
+ MinCount?: number;
374
+ }
375
+ /**
376
+ * CheckUHostResourceCapacity - 主机创建资源余量检查
377
+ */
378
+ export interface CheckUHostResourceCapacityResponse {
379
+ /**
380
+ * 资源是否充足
381
+ */
382
+ ResourceEnough?: boolean;
383
+ /**
384
+ * 随机的资源对应的RdmaClusterId数组,若资源不足则为空,只有快杰系列机型,以及A800才可能有此字段
385
+ */
386
+ RdmaClusterIds?: string[];
222
387
  }
223
388
  /**
224
389
  * CopyCustomImage - 复制自制镜像
@@ -237,7 +402,7 @@ export interface CopyCustomImageRequest {
237
402
  */
238
403
  TargetProjectId: string;
239
404
  /**
240
- * 目标地域,不跨地域不用填
405
+ * 目标地域,不跨地域可不填
241
406
  */
242
407
  TargetRegion?: string;
243
408
  /**
@@ -248,15 +413,44 @@ export interface CopyCustomImageRequest {
248
413
  * 目标镜像描述
249
414
  */
250
415
  TargetImageDescription?: string;
416
+ /**
417
+ * 目标镜像业务组
418
+ */
419
+ TargetImageTag?: string;
420
+ /**
421
+ * 目标地域的集合,批量复制时填写
422
+ */
423
+ TargetRegionList?: string[];
251
424
  }
252
425
  /**
253
426
  * CopyCustomImage - 复制自制镜像
254
427
  */
255
428
  export interface CopyCustomImageResponse {
256
429
  /**
257
- * 目标镜像Id
430
+ * 目标镜像Id,只有非批量复制的时候该字段才存在
258
431
  */
259
432
  TargetImageId?: string;
433
+ /**
434
+ * 目标镜像复制的任务Id,只有非批量复制的时候该字段才存在
435
+ */
436
+ TaskId?: string;
437
+ /**
438
+ * 批量复制时的任务信息,参考下方的CopyImageTaskInfo
439
+ */
440
+ Infos?: {
441
+ /**
442
+ * 目标镜像复制的任务Id
443
+ */
444
+ TaskId?: string;
445
+ /**
446
+ * 目标镜像Id
447
+ */
448
+ TargetImageId?: string;
449
+ /**
450
+ * 目标地域
451
+ */
452
+ TargetRegion?: string;
453
+ }[];
260
454
  }
261
455
  /**
262
456
  * CreateCustomImage - 从指定UHost实例,生成自定义镜像。
@@ -278,6 +472,14 @@ export interface CreateCustomImageRequest {
278
472
  * 镜像描述
279
473
  */
280
474
  ImageDescription?: string;
475
+ /**
476
+ * 镜像业务组。默认:Default
477
+ */
478
+ Tag?: string;
479
+ /**
480
+ * 【数组】关联的云盘数据盘id列表。注意: 云盘数据盘需要开启快照服务
481
+ */
482
+ DataUDiskIds?: string[];
281
483
  }
282
484
  /**
283
485
  * CreateCustomImage - 从指定UHost实例,生成自定义镜像。
@@ -287,6 +489,10 @@ export interface CreateCustomImageResponse {
287
489
  * 镜像Id
288
490
  */
289
491
  ImageId?: string;
492
+ /**
493
+ * 云盘数据盘快照id列表
494
+ */
495
+ DataSnapshotIds?: string[];
290
496
  }
291
497
  /**
292
498
  * CreateIsolationGroup - 创建硬件隔离组,组内机器严格隔离在不同宿主机上。
@@ -339,7 +545,7 @@ export interface CreateUHostInstanceRequest {
339
545
  */
340
546
  Size: number;
341
547
  /**
342
- * 磁盘备份方案。枚举值:\\ > NONE,无备份 \\ > DATAARK,数据方舟 \\ > SNAPSHOT,快照 \\当前磁盘支持的备份模式参考 [[api:uhost-api:disk_type|磁盘类型]],默认值:NONE
548
+ * 磁盘备份方案。枚举值:\\ > NONE,无备份 \\ > SNAPSHOT,快照 \\当前磁盘支持的备份模式参考 [[api:uhost-api:disk_type|磁盘类型]],默认值:NONE
343
549
  */
344
550
  BackupType?: string;
345
551
  /**
@@ -354,17 +560,38 @@ export interface CreateUHostInstanceRequest {
354
560
  * 云盘代金券id。不适用于系统盘/本地盘。请通过DescribeCoupon接口查询,或登录用户中心查看
355
561
  */
356
562
  CouponId?: string;
563
+ /**
564
+ * 指定快照备份策略。当Disks.N.BackupType为"SNAPSHOT"时此参数生效。枚举值:"Base":标准版,"Ultimate":旗舰版,"Custom":自定义备份链;默认值:"Base"。
565
+ */
566
+ BackupMode?: string;
357
567
  /**
358
568
  *
359
569
  */
360
- CustomBackup?: object;
570
+ CustomBackup?: {
571
+ /**
572
+ * Disks.N.BackupMode为"Custom"时,进行设置, 以12小时秒级为基础进行倍数扩增,如12、24、36、48。
573
+ */
574
+ Journal?: string;
575
+ /**
576
+ * Disks.N.BackupMode为"Custom"时,进行设置, 以24小时级为基础进行倍数扩增,如24、48、72、96。
577
+ */
578
+ Hour?: string;
579
+ /**
580
+ * Disks.N.BackupMode为"Custom"时,进行设置, 以5天级为基础进行倍数扩增,如5、10、15、20、25、30。
581
+ */
582
+ Day?: string;
583
+ };
584
+ /**
585
+ * 从快照创建盘时所用快照id,目前仅支持数据盘
586
+ */
587
+ SnapshotId?: string;
361
588
  }[];
362
589
  /**
363
- * 主机登陆模式。密码(默认选项): Password,密钥:KeyPair。
590
+ * 主机登陆模式。密码(默认选项): Password,密钥:KeyPair,Password,自制镜像密码:ImagePasswd
364
591
  */
365
592
  LoginMode: string;
366
593
  /**
367
- * UHost密码。请遵照[[api:uhost-api:specification|字段规范]]设定密码。密码需使用base64进行编码,举例如下:# echo -n Password1 | base64UGFzc3dvcmQx
594
+ * UHost密码。请遵照[[api:uhost-api:specification|字段规范]]设定密码。密码需使用base64进行编码,举例如下:# echo -n Password1 | base64 UGFzc3dvcmQx
368
595
  */
369
596
  Password?: string;
370
597
  /**
@@ -376,7 +603,7 @@ export interface CreateUHostInstanceRequest {
376
603
  */
377
604
  Tag?: string;
378
605
  /**
379
- * 计费模式。枚举值为: \\ > Year,按年付费; \\ > Month,按月付费;\\ > Dynamic,按小时预付费 \\ > Postpay,按小时后付费(支持关机不收费,目前仅部分可用区支持,请联系您的客户经理) \\Preemptive计费为抢占式实例(内测阶段) \\ 默认为月付
606
+ * 计费模式。枚举值为: \\ > Year,按年付费; \\ > Month,按月付费;\\ > Dynamic,按小时预付费 \\ > Postpay,按小时后付费(支持关机不收费,目前仅部分可用区支持,请联系您的客户经理) \\ > Spot计费为抢占式实例(内测阶段) \\ 默认为月付
380
607
  */
381
608
  ChargeType?: string;
382
609
  /**
@@ -396,7 +623,7 @@ export interface CreateUHostInstanceRequest {
396
623
  */
397
624
  Memory?: number;
398
625
  /**
399
- * GPU类型,枚举值["K80", "P40", "V100", "T4", "T4S","2080Ti","2080Ti-4C","1080Ti", "T4/4", "MI100", "V100S"]MachineType为G时必填
626
+ * GPU类型,枚举值["K80", "P40", "V100", "T4","T4A", "T4S","2080Ti","2080Ti-4C","1080Ti", "T4/4", "V100S",2080","2080TiS","2080TiPro","3090","4090","4090Pro","4090_48G","A100","A800","H20"]MachineType为G时必填
400
627
  */
401
628
  GpuType?: string;
402
629
  /**
@@ -404,7 +631,7 @@ export interface CreateUHostInstanceRequest {
404
631
  */
405
632
  GPU?: number;
406
633
  /**
407
- * 网络增强特性。枚举值:Normal,不开启; Super,开启网络增强1.0; Ultra,开启网络增强2.0(详情参考官网文档)
634
+ * 网络增强特性。枚举值:Normal,不开启; Super,开启网络增强1.0; Ultra,开启网络增强2.0;Extreme,开启网络增强3.0(详情参考官网文档)
408
635
  */
409
636
  NetCapability?: string;
410
637
  /**
@@ -432,19 +659,19 @@ export interface CreateUHostInstanceRequest {
432
659
  */
433
660
  IsolationGroup?: string;
434
661
  /**
435
- * 告警模板id,如果传了告警模板id,且告警模板id正确,则绑定告警模板。绑定告警模板失败只会在后台有日志,不会影响创建主机流程,也不会在前端报错。
662
+ * 告警模板id,如果传了告警模板id,且告警模板id正确,则绑定告警模板。绑定告警模板失败不会影响创建主机流程。
436
663
  */
437
664
  AlarmTemplateId?: number;
438
665
  /**
439
- * 云主机机型(V2.0),在本字段和字段UHostType中,仅需要其中1个字段即可。枚举值["N", "C", "G", "O", "OS", "OM", "OPRO", "OMAX", "O.BM", "O.EPC"]。参考[[api:uhost-api:uhost_type|云主机机型说明]]。
666
+ * 云主机机型(V2.0),在本字段和字段UHostType中,仅需要其中1个字段即可。枚举值["N", "C", "G", "O", "OM", "OMEM" "OPRO", "OPROG"]。参考[[api:uhost-api:uhost_type|云主机机型说明]]。
440
667
  */
441
668
  MachineType?: string;
442
669
  /**
443
- * 最低cpu平台,枚举值["Intel/Auto", "Intel/IvyBridge", "Intel/Haswell", "Intel/Broadwell", "Intel/Skylake", "Intel/Cascadelake", "Intel/CascadelakeR", "Intel/IceLake", "Amd/Epyc2", "Amd/Auto"],默认值是"Intel/Auto"。
670
+ * 最低cpu平台,枚举值["Intel/Auto", "Intel/IvyBridge", "Intel/Haswell", "Intel/Broadwell", "Intel/Skylake", "Intel/Cascadelake", "Intel/CascadelakeR", "Intel/IceLake", "Intel/SapphireRapids", "Amd/Epyc2", "Amd/Auto","Ampere/Auto","Ampere/Altra"],默认值是"Intel/Auto"。
444
671
  */
445
672
  MinimalCpuPlatform?: string;
446
673
  /**
447
- * 本次最大创建主机数量,取值范围是[1,100],默认值为1
674
+ * 本次最大创建主机数量,取值范围是[1,100],默认值为1。- 库存数量不足时,按库存数量创建。- 配额不足时,返回错误。- 使用隔离组时,以隔离组可用数量为准。
448
675
  */
449
676
  MaxCount?: number;
450
677
  /**
@@ -456,7 +683,7 @@ export interface CreateUHostInstanceRequest {
456
683
  */
457
684
  EIP?: {
458
685
  /**
459
- * 【若绑定EIP,此参数必填】弹性IP的外网带宽, 单位为Mbps. 共享带宽模式必须指定0M带宽, 非共享带宽模式必须指定非0Mbps带宽. 各地域非共享带宽的带宽范围如下: 流量计费[1-300],带宽计费[1-800]
686
+ * 【若绑定EIP,此参数必填】弹性IP的外网带宽, 单位为Mbps. 共享带宽模式下非必传, 非共享带宽模式必须指定非0Mbps带宽. 各地域非共享带宽的带宽范围如下: 流量计费[1-300],带宽计费[1-800]
460
687
  */
461
688
  Bandwidth?: number;
462
689
  /**
@@ -479,7 +706,12 @@ export interface CreateUHostInstanceRequest {
479
706
  /**
480
707
  *
481
708
  */
482
- IPv6?: object;
709
+ IPv6?: {
710
+ /**
711
+ * 第N个网卡对应的IPv6地址,默认不分配IPv6,“Auto”自动分配,不为空的其他字符串为实际要分配的IPv6地址。当前仅支持分配一个IPv6地址
712
+ */
713
+ Address?: string;
714
+ };
483
715
  /**
484
716
  * 申请并绑定一个教育网EIP。True为申请并绑定,False为不会申请绑定,默认False。当前只支持具有HPC特性的机型。
485
717
  */
@@ -506,14 +738,64 @@ export interface CreateUHostInstanceRequest {
506
738
  */
507
739
  Features?: {
508
740
  /**
509
- * 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启,仅与 NetCapability Normal 兼容。
741
+ * 弹性网卡特性。开启了弹性网卡权限位,此特性才生效,默认 false 未开启,true 开启。
510
742
  */
511
743
  UNI?: boolean;
512
744
  };
513
745
  /**
514
746
  *
515
747
  */
516
- SecGroupId?: object[];
748
+ SecGroupId?: {
749
+ /**
750
+ * 安全组 ID。至多可以同时绑定5个安全组。
751
+ */
752
+ Id?: string;
753
+ /**
754
+ * 安全组优先级。取值范围[1, 5]
755
+ */
756
+ Priority?: number;
757
+ }[];
758
+ /**
759
+ * 主机安全模式。Firewall:防火墙;SecGroup:安全组;默认值:Firewall。
760
+ */
761
+ SecurityMode?: string;
762
+ /**
763
+ * 【私有专区属性】专区id
764
+ */
765
+ UDSetId?: string;
766
+ /**
767
+ * 【私有专区属性】专区宿主机id
768
+ */
769
+ UDHostId?: string;
770
+ /**
771
+ * 【私有专区属性】专区云主机开启宿住关联属性
772
+ */
773
+ HostBinding?: boolean;
774
+ /**
775
+ * 本次最小创建主机数量,取值范围是[1,100],默认值为1。- 配额不足时,返回错误。
776
+ */
777
+ MinCount?: number;
778
+ /**
779
+ *
780
+ */
781
+ Labels?: {
782
+ /**
783
+ * 用户资源标签的键值
784
+ */
785
+ Key?: string;
786
+ /**
787
+ * 用户资源标签的值
788
+ */
789
+ Value?: string;
790
+ }[];
791
+ /**
792
+ * 删除保护,设置删除保护参数,true表示不允许控制台删除
793
+ */
794
+ DeletionProtection?: boolean;
795
+ /**
796
+ * 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"(快杰型)时,支持以下取值:- o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o2i:快杰型 O2 代,Intel 平台 默认值:o1i 或 o1a当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。
797
+ */
798
+ UHostFamily?: string;
517
799
  /**
518
800
  * 主机代金券ID。请通过DescribeCoupon接口查询,或登录用户中心查看
519
801
  */
@@ -622,7 +904,11 @@ export interface DescribeAvailableInstanceTypesRequest {
622
904
  /**
623
905
  * 可用区。参见 [可用区列表](https://docs.ucloud.cn/api/summary/regionlist)
624
906
  */
625
- Zone: string;
907
+ Zone?: string;
908
+ /**
909
+ * 指定机型列表
910
+ */
911
+ MachineTypes?: string[];
626
912
  }
627
913
  /**
628
914
  * DescribeAvailableInstanceTypes - DescribeAvailableInstanceTypes
@@ -632,6 +918,14 @@ export interface DescribeAvailableInstanceTypesResponse {
632
918
  * AvailableInstanceTypes
633
919
  */
634
920
  AvailableInstanceTypes: {
921
+ /**
922
+ * 可用区信息
923
+ */
924
+ Zone?: string;
925
+ /**
926
+ * 实例类型,枚举值["uhost", "spot"]
927
+ */
928
+ InstanceType?: string;
635
929
  /**
636
930
  * 机型名称:快杰O型|O 、快杰共享型|OM 、快杰内存型|OMEM 、 快杰PRO型|OPRO、通用N型|N、高主频C型|C和GPU G型|G等
637
931
  */
@@ -657,6 +951,36 @@ export interface DescribeAvailableInstanceTypesResponse {
657
951
  */
658
952
  Ampere?: string[];
659
953
  };
954
+ /**
955
+ * 规格族信息
956
+ */
957
+ UHostFamilies?: {
958
+ /**
959
+ * 规格族
960
+ */
961
+ Name?: string;
962
+ /**
963
+ * CPU频率信息
964
+ */
965
+ CpuFrequency?: string;
966
+ /**
967
+ * CPU平台信息
968
+ */
969
+ CpuPlatforms?: {
970
+ /**
971
+ * CPU平台
972
+ */
973
+ Name?: string;
974
+ /**
975
+ * CPU Model列表
976
+ */
977
+ CpuModels?: string[];
978
+ /**
979
+ * CPU频率
980
+ */
981
+ CpuFrequency?: string;
982
+ }[];
983
+ }[];
660
984
  /**
661
985
  * 磁盘信息。磁盘主要分类如下:云盘|cloudDisk、普通本地盘|normalLocalDisk和SSD本地盘|ssdLocalDisk。其中云盘主要包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。MinimalSize为磁盘最小值,如果没有该字段,最小值取基础镜像Size值即可(linux为20G,windows为40G)。MaximalSize为磁盘最大值。InstantResize表示系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。Features为磁盘可支持的服务:数据方舟|DATAARK,快照服务|SNAPSHOT,加密盘|Encrypted。
662
986
  */
@@ -706,6 +1030,10 @@ export interface DescribeAvailableInstanceTypesResponse {
706
1030
  * 数据盘可支持的服务
707
1031
  */
708
1032
  Features?: string[];
1033
+ /**
1034
+ * 支持的快照备份策略
1035
+ */
1036
+ BackupMode?: string[];
709
1037
  }[];
710
1038
  }[];
711
1039
  /**
@@ -790,6 +1118,300 @@ export interface DescribeAvailableInstanceTypesResponse {
790
1118
  */
791
1119
  Rate?: number;
792
1120
  };
1121
+ /**
1122
+ * 父机型
1123
+ */
1124
+ ParentType?: string;
1125
+ /**
1126
+ * 机型描述
1127
+ */
1128
+ Description?: string;
1129
+ }[];
1130
+ /**
1131
+ * 当前区域是否可售
1132
+ */
1133
+ Status?: string;
1134
+ }
1135
+ /**
1136
+ * DescribeHostMachineTypeFamilies - 获取实例规格族列表(所有机型的信息)
1137
+ */
1138
+ export interface DescribeHostMachineTypeFamiliesRequest {
1139
+ }
1140
+ /**
1141
+ * DescribeHostMachineTypeFamilies - 获取实例规格族列表(所有机型的信息)
1142
+ */
1143
+ export interface DescribeHostMachineTypeFamiliesResponse {
1144
+ /**
1145
+ * 机型配置列表
1146
+ */
1147
+ MachineTypes?: {
1148
+ /**
1149
+ * 机型名称
1150
+ */
1151
+ Name?: string;
1152
+ /**
1153
+ * 机型中文名称
1154
+ */
1155
+ Description?: string;
1156
+ /**
1157
+ * 机型ComponentCode
1158
+ */
1159
+ OperationStatus?: string;
1160
+ /**
1161
+ * CPU平台列表
1162
+ */
1163
+ CpuPlatforms?: {
1164
+ /**
1165
+ * CPU平台
1166
+ */
1167
+ Name?: string;
1168
+ /**
1169
+ * 运营Commpont Code
1170
+ */
1171
+ OperationStatus?: string;
1172
+ }[];
1173
+ /**
1174
+ * 磁盘信息
1175
+ */
1176
+ Disks?: {
1177
+ /**
1178
+ * 磁盘介质类别信息,磁盘主要分类如下:云盘|cloudDisk、普通本地盘|normalLocalDisk和SSD本地盘|ssdLocalDisk。
1179
+ */
1180
+ Name?: string;
1181
+ /**
1182
+ * 系统盘信息
1183
+ */
1184
+ BootDisk?: {
1185
+ /**
1186
+ * 系统盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。
1187
+ */
1188
+ Name?: string;
1189
+ /**
1190
+ * 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。
1191
+ */
1192
+ InstantResize?: boolean;
1193
+ /**
1194
+ * MaximalSize为磁盘最大值
1195
+ */
1196
+ MaximalSize?: number;
1197
+ /**
1198
+ * 磁盘可支持的服务
1199
+ */
1200
+ Features?: {
1201
+ /**
1202
+ * 特性名称
1203
+ */
1204
+ Name?: string;
1205
+ /**
1206
+ * 特性详情
1207
+ */
1208
+ Modes?: {
1209
+ /**
1210
+ * 名称
1211
+ */
1212
+ Name?: string;
1213
+ /**
1214
+ * 标记
1215
+ */
1216
+ OperationStatus?: string;
1217
+ }[];
1218
+ }[];
1219
+ }[];
1220
+ /**
1221
+ * 数据盘信息
1222
+ */
1223
+ DataDisk?: {
1224
+ /**
1225
+ * 磁盘最小值,如果没有该字段,最小值取基础镜像Size值即可(linux为20G,windows为40G)。
1226
+ */
1227
+ MinimalSize?: number;
1228
+ /**
1229
+ * 数据盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。
1230
+ */
1231
+ Name?: string;
1232
+ /**
1233
+ * MaximalSize为磁盘最大值
1234
+ */
1235
+ MaximalSize?: number;
1236
+ /**
1237
+ * 数据盘可支持的服务
1238
+ */
1239
+ Features?: {
1240
+ /**
1241
+ * 特性名称
1242
+ */
1243
+ Name?: string;
1244
+ /**
1245
+ * 特性详情
1246
+ */
1247
+ Modes?: {
1248
+ /**
1249
+ * 名称
1250
+ */
1251
+ Name?: string;
1252
+ /**
1253
+ * 标记
1254
+ */
1255
+ OperationStatus?: string;
1256
+ }[];
1257
+ }[];
1258
+ }[];
1259
+ /**
1260
+ * 权限位
1261
+ */
1262
+ OperationStatus?: string;
1263
+ }[];
1264
+ /**
1265
+ * 规格信息
1266
+ */
1267
+ MachineSizes?: {
1268
+ /**
1269
+ * Gpu为GPU可支持的规格即GPU颗数,非GPU机型,Gpu为0
1270
+ */
1271
+ Gpu?: number;
1272
+ /**
1273
+ * CPU和内存可支持的规格
1274
+ */
1275
+ Collection?: {
1276
+ /**
1277
+ * CPU规格
1278
+ */
1279
+ Cpu?: number;
1280
+ /**
1281
+ * 内存规格
1282
+ */
1283
+ Memory?: number[];
1284
+ /**
1285
+ * CPU和内存规格只能在列出来的CPU平台支持
1286
+ */
1287
+ MinimalCpuPlatform?: string[];
1288
+ }[];
1289
+ }[];
1290
+ /**
1291
+ * 特性信息
1292
+ */
1293
+ Features?: {
1294
+ /**
1295
+ * 可支持的特性名称。目前支持的特性网络增强|NetCapability、热升级|Hotplug
1296
+ */
1297
+ Name?: string;
1298
+ /**
1299
+ * 可以提供的模式类别
1300
+ */
1301
+ Modes?: {
1302
+ /**
1303
+ * 模式|特性名称
1304
+ */
1305
+ Name?: string;
1306
+ /**
1307
+ * 为镜像上支持这个特性的标签。例如DescribeImage返回的字段Features包含HotPlug,说明该镜像支持热升级。
1308
+ */
1309
+ RelatedToImageFeature?: string[];
1310
+ /**
1311
+ * 这个特性必须是列出来的CPU平台及以上的CPU才支持
1312
+ */
1313
+ MinimalCpuPlatform?: string[];
1314
+ }[];
1315
+ }[];
1316
+ /**
1317
+ * 父类型。如GPU机型的父类型为"G"
1318
+ */
1319
+ ParentType?: string;
1320
+ /**
1321
+ * GPU信息
1322
+ */
1323
+ GpuType?: {
1324
+ /**
1325
+ * 机型名称
1326
+ */
1327
+ Name?: string;
1328
+ /**
1329
+ * 显存信息
1330
+ */
1331
+ GraphicsMemory?: {
1332
+ /**
1333
+ * 值,单位是GB
1334
+ */
1335
+ Value?: number;
1336
+ /**
1337
+ * 交互展示参数,可忽略
1338
+ */
1339
+ Rate?: number;
1340
+ };
1341
+ /**
1342
+ * 性能信息
1343
+ */
1344
+ Performance?: {
1345
+ /**
1346
+ * 值,单位是TFlops
1347
+ */
1348
+ Value?: number;
1349
+ /**
1350
+ * 交互展示参数,可忽略
1351
+ */
1352
+ Rate?: number;
1353
+ };
1354
+ };
1355
+ /**
1356
+ * 场景分类
1357
+ */
1358
+ SceneCategories?: string[];
1359
+ /**
1360
+ * GPU系列
1361
+ */
1362
+ GpuSeries?: string;
1363
+ /**
1364
+ * 规格族信息
1365
+ */
1366
+ UHostFamilies?: {
1367
+ /**
1368
+ * 规格族
1369
+ */
1370
+ Name?: string;
1371
+ /**
1372
+ * CPU频率信息
1373
+ */
1374
+ CpuFrequency?: string;
1375
+ /**
1376
+ * CPU平台信息
1377
+ */
1378
+ CpuPlatforms?: {
1379
+ /**
1380
+ * CPU平台
1381
+ */
1382
+ Name?: string;
1383
+ /**
1384
+ * CPU Model列表
1385
+ */
1386
+ CpuModels?: string[];
1387
+ /**
1388
+ * CPU频率
1389
+ */
1390
+ CpuFrequency?: string;
1391
+ }[];
1392
+ }[];
1393
+ /**
1394
+ * 是否为非真实机型
1395
+ */
1396
+ Virtual?: boolean;
1397
+ /**
1398
+ * 仅OPROG\OPRO机型返回
1399
+ */
1400
+ ProType?: {
1401
+ /**
1402
+ * 机型名称
1403
+ */
1404
+ Name?: string;
1405
+ /**
1406
+ * 频率
1407
+ */
1408
+ Frequency?: {
1409
+ /**
1410
+ * 值
1411
+ */
1412
+ Value?: number;
1413
+ };
1414
+ };
793
1415
  }[];
794
1416
  }
795
1417
  /**
@@ -804,6 +1426,10 @@ export interface DescribeImageRequest {
804
1426
  * 镜像类型。标准镜像:Base,镜像市场:Business, 自定义镜像:Custom,默认返回所有类型
805
1427
  */
806
1428
  ImageType?: string;
1429
+ /**
1430
+ * 镜像归属,枚举值:["gpu","app","uhost"]。"gpu": 对gpu进行处理过的行业镜像;"app":轻量云主机专用的镜像;"uhost":云主机镜像市场的行业镜像。FuncType传参错误会被忽略
1431
+ */
1432
+ FuncType?: string;
807
1433
  /**
808
1434
  * 操作系统类型:Linux, Windows 默认返回所有类型
809
1435
  */
@@ -812,6 +1438,14 @@ export interface DescribeImageRequest {
812
1438
  * 镜像Id
813
1439
  */
814
1440
  ImageId?: string;
1441
+ /**
1442
+ * 镜像Id列表
1443
+ */
1444
+ ImageIds?: string[];
1445
+ /**
1446
+ * 业务组Id。默认:Default
1447
+ */
1448
+ Tag?: string;
815
1449
  /**
816
1450
  * 列表起始位置偏移量,默认为0
817
1451
  */
@@ -849,6 +1483,10 @@ export interface DescribeImageResponse {
849
1483
  * 镜像名称
850
1484
  */
851
1485
  ImageName?: string;
1486
+ /**
1487
+ * 业务组
1488
+ */
1489
+ Tag?: string;
852
1490
  /**
853
1491
  * 操作系统类型:Linux,Windows
854
1492
  */
@@ -862,11 +1500,11 @@ export interface DescribeImageResponse {
862
1500
  */
863
1501
  ImageType?: string;
864
1502
  /**
865
- * 特殊状态标识, 目前包含NetEnhnced(网络增强1.0), NetEnhanced_Ultra](网络增强2.0), HotPlug(热升级), CloudInit, IPv6
1503
+ * 特殊状态标识,目前包含NetEnhnced(网络增强1.0), NetEnhanced_Ultra(网络增强2.0), NetEnhanced_Extreme(网络增强3.0), HotPlug(热升级), GPU(GPU镜像),CloudInit, IPv6(支持IPv6网络),RssdAttachable(支持RSSD云盘),Vgpu_AMD(支持AMD的vgpu),Vgpu_NVIDIA(支持NVIDIA的vgpu),Aarch64_Type(支持arm64架构)
866
1504
  */
867
1505
  Features?: string[];
868
1506
  /**
869
- * 行业镜像类型(仅行业镜像将返回这个值)
1507
+ * 镜像归属,枚举值:["gpu","app","uhost"]。"gpu": 对gpu进行处理过的行业镜像;"app":轻量云主机专用的镜像;"uhost":云主机镜像市场的行业镜像
870
1508
  */
871
1509
  FuncType?: string;
872
1510
  /**
@@ -882,7 +1520,7 @@ export interface DescribeImageResponse {
882
1520
  */
883
1521
  Links?: string;
884
1522
  /**
885
- * 镜像状态, 可用:Available,制作中:Making, 不可用:Unavailable
1523
+ * 镜像状态, 可用:Available,制作中:Making, 不可用:Unavailable,复制中:Copying
886
1524
  */
887
1525
  State?: string;
888
1526
  /**
@@ -901,6 +1539,43 @@ export interface DescribeImageResponse {
901
1539
  * 默认值为空'''。当CentOS 7.3/7.4/7.5等镜像会标记为“Broadwell”
902
1540
  */
903
1541
  MinimalCPU?: string;
1542
+ /**
1543
+ * 系统EOL的时间,格式:YYYY/MM/DD
1544
+ */
1545
+ MaintainEol?: string;
1546
+ /**
1547
+ * 关联的云盘数据盘快照Id列表
1548
+ */
1549
+ DataSnapshotIds?: string[];
1550
+ /**
1551
+ * 支持的GPU机型
1552
+ */
1553
+ SupportedGPUTypes?: string[];
1554
+ /**
1555
+ * 场景分类,目前包含Featured(精选),PreInstalledDrivers(预装驱动),AIPainting(AI绘画),AIModels(AI模型),HPC(高性能计算)
1556
+ */
1557
+ SceneCategories?: string[];
1558
+ /**
1559
+ * 主要安装软件
1560
+ */
1561
+ PrimarySoftware?: string;
1562
+ /**
1563
+ * 镜像的价格信息
1564
+ */
1565
+ PriceSet?: {
1566
+ /**
1567
+ * 计费类型
1568
+ */
1569
+ ChargeType?: string;
1570
+ /**
1571
+ * 价格,单位: 元,保留小数点后两位有效数字
1572
+ */
1573
+ Price?: number;
1574
+ /**
1575
+ * 限时优惠的折前原价(即列表价乘以商务折扣后的单价)。
1576
+ */
1577
+ OriginalPrice?: number;
1578
+ }[];
904
1579
  }[];
905
1580
  }
906
1581
  /**
@@ -929,35 +1604,121 @@ export interface DescribeIsolationGroupResponse {
929
1604
  */
930
1605
  IsolationGroupSet?: {
931
1606
  /**
932
- * 硬件隔离组名称
1607
+ * 硬件隔离组名称
1608
+ */
1609
+ GroupName?: string;
1610
+ /**
1611
+ * 硬件隔离组id
1612
+ */
1613
+ GroupId?: string;
1614
+ /**
1615
+ * 每个可用区中的机器数量。参见数据结构SpreadInfo。
1616
+ */
1617
+ SpreadInfoSet?: {
1618
+ /**
1619
+ * 可用区信息
1620
+ */
1621
+ Zone?: string;
1622
+ /**
1623
+ * 当前地域所有可用区中硬件隔离组中云主机的数量,不超过7。
1624
+ */
1625
+ UHostCount?: number;
1626
+ }[];
1627
+ /**
1628
+ * 备注
1629
+ */
1630
+ Remark?: string;
1631
+ }[];
1632
+ /**
1633
+ * 硬件隔离组总数
1634
+ */
1635
+ TotalCount?: number;
1636
+ }
1637
+ /**
1638
+ * DescribeUHostAvailableDiskTypes - 获取主机可挂载的磁盘信息
1639
+ */
1640
+ export interface DescribeUHostAvailableDiskTypesRequest {
1641
+ /**
1642
+ * 可用区。参见 [可用区列表](https://docs.ucloud.cn/api/summary/regionlist)
1643
+ */
1644
+ Zone?: string;
1645
+ /**
1646
+ * 实例Id列表。最多100个
1647
+ */
1648
+ UHostIds: string[];
1649
+ }
1650
+ /**
1651
+ * DescribeUHostAvailableDiskTypes - 获取主机可挂载的磁盘信息
1652
+ */
1653
+ export interface DescribeUHostAvailableDiskTypesResponse {
1654
+ /**
1655
+ * 可挂载的磁盘信息列表
1656
+ */
1657
+ DiskTypeSet: {
1658
+ /**
1659
+ * 可用区
933
1660
  */
934
- GroupName?: string;
1661
+ Zone?: string;
935
1662
  /**
936
- * 硬件隔离组id
1663
+ * 实例Id
937
1664
  */
938
- GroupId?: string;
1665
+ UHostId?: string;
939
1666
  /**
940
- * 每个可用区中的机器数量。参见数据结构SpreadInfo。
1667
+ * 可用磁盘信息
941
1668
  */
942
- SpreadInfoSet?: {
1669
+ AvailableDisks?: {
943
1670
  /**
944
- * 可用区信息
1671
+ * 磁盘介质类别信息,磁盘主要分类如下:云盘|cloudDisk、普通本地盘|normalLocalDisk和SSD本地盘|ssdLocalDisk。
945
1672
  */
946
- Zone?: string;
1673
+ Name?: string;
947
1674
  /**
948
- * 当前地域所有可用区中硬件隔离组中云主机的数量,不超过7。
1675
+ * 系统盘信息
949
1676
  */
950
- UHostCount?: number;
1677
+ BootDisk?: {
1678
+ /**
1679
+ * 系统盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。
1680
+ */
1681
+ Name?: string;
1682
+ /**
1683
+ * 系统盘是否允许扩容,如果是本地盘,则不允许扩容,InstantResize为false。
1684
+ */
1685
+ InstantResize?: boolean;
1686
+ /**
1687
+ * MaximalSize为磁盘最大值
1688
+ */
1689
+ MaximalSize?: number;
1690
+ /**
1691
+ * 磁盘可支持的服务
1692
+ */
1693
+ Features?: string[];
1694
+ }[];
1695
+ /**
1696
+ * 数据盘信息
1697
+ */
1698
+ DataDisk?: {
1699
+ /**
1700
+ * 磁盘最小值,如果没有该字段,最小值取基础镜像Size值即可(linux为20G,windows为40G)。
1701
+ */
1702
+ MinimalSize?: number;
1703
+ /**
1704
+ * 数据盘类别,包含普通云盘|CLOUD_NORMAL、SSD云盘|CLOUD_SSD和RSSD云盘|CLOUD_RSSD。普通本地盘只包含普通本地盘|LOCAL_NORMAL一种。SSD本地盘只包含SSD本地盘|LOCAL_SSD一种。
1705
+ */
1706
+ Name?: string;
1707
+ /**
1708
+ * MaximalSize为磁盘最大值
1709
+ */
1710
+ MaximalSize?: number;
1711
+ /**
1712
+ * 数据盘可支持的服务
1713
+ */
1714
+ Features?: string[];
1715
+ /**
1716
+ * 支持的快照备份策略
1717
+ */
1718
+ BackupMode?: string[];
1719
+ }[];
951
1720
  }[];
952
- /**
953
- * 备注
954
- */
955
- Remark?: string;
956
1721
  }[];
957
- /**
958
- * 硬件隔离组总数
959
- */
960
- TotalCount?: number;
961
1722
  }
962
1723
  /**
963
1724
  * DescribeUHostInstance - 获取主机或主机列表信息,并可根据数据中心,主机ID等参数进行过滤。
@@ -1016,10 +1777,6 @@ export interface DescribeUHostInstanceResponse {
1016
1777
  * 可用区。参见 [可用区列表](../summary/regionlist.html)
1017
1778
  */
1018
1779
  Zone?: string;
1019
- /**
1020
- * true:有ipv6特性;false,没有ipv6特性
1021
- */
1022
- IPv6Feature?: boolean;
1023
1780
  /**
1024
1781
  * UHost实例ID
1025
1782
  */
@@ -1036,6 +1793,10 @@ export interface DescribeUHostInstanceResponse {
1036
1793
  * 云主机CPU平台。参考[[api:uhost-api:uhost_type#主机概念20版本|云主机机型说明]]。
1037
1794
  */
1038
1795
  CpuPlatform?: string;
1796
+ /**
1797
+ * 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。 当 MachineType 为 "O"(快杰型)时,支持以下取值: - o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台 - o1r:快杰型 O1 代,ARM 平台 - o2i:快杰型 O2 代,Intel 平台 默认值:o1i 或 o1a或o1r(系统将根据资源情况自动选择) 当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台
1798
+ */
1799
+ UHostFamily?: string;
1039
1800
  /**
1040
1801
  * 【建议不再使用】主机磁盘类型。 枚举值为:\\ > LocalDisk,本地磁盘; \\ > UDisk 云盘。\\只要有一块磁盘为本地盘,即返回LocalDisk。
1041
1802
  */
@@ -1194,10 +1955,6 @@ export interface DescribeUHostInstanceResponse {
1194
1955
  * 【建议不再使用】数据方舟模式。枚举值:\\ > Yes: 开启方舟; \\ > no,未开启方舟
1195
1956
  */
1196
1957
  TimemachineFeature?: string;
1197
- /**
1198
- * true: 开启热升级; false,未开启热升级
1199
- */
1200
- HotplugFeature?: boolean;
1201
1958
  /**
1202
1959
  * 【建议不再使用】仅北京A的云主机会返回此字段。基础网络模式:Default;子网模式:Private
1203
1960
  */
@@ -1222,6 +1979,14 @@ export interface DescribeUHostInstanceResponse {
1222
1979
  * GPU个数
1223
1980
  */
1224
1981
  GPU?: number;
1982
+ /**
1983
+ * GPU类型;枚举值["K80", "P40", "V100", "T4","T4A", "T4S","2080Ti","2080Ti-4C","1080Ti", "T4/4", "MI100", "V100S",2080","2080TiS","2080TiPro","3090","4090","4090Pro","A100","A800","H20"]
1984
+ */
1985
+ GpuType?: string;
1986
+ /**
1987
+ * 热升级支持的最大CPU个数
1988
+ */
1989
+ HotPlugMaxCpu?: number;
1225
1990
  /**
1226
1991
  * 系统盘状态 Normal表示初始化完成;Initializing表示在初始化。仍在初始化的系统盘无法制作镜像。
1227
1992
  */
@@ -1234,10 +1999,6 @@ export interface DescribeUHostInstanceResponse {
1234
1999
  * 隔离组id,不在隔离组则返回""
1235
2000
  */
1236
2001
  IsolationGroup?: string;
1237
- /**
1238
- * true,支持cloutinit方式初始化;false,不支持
1239
- */
1240
- CloudInitFeature?: boolean;
1241
2002
  /**
1242
2003
  * RDMA集群id,仅快杰云主机返回该值;其他类型云主机返回""。当云主机的此值与RSSD云盘的RdmaClusterId相同时,RSSD可以挂载到这台云主机。
1243
2004
  */
@@ -1246,10 +2007,38 @@ export interface DescribeUHostInstanceResponse {
1246
2007
  * 仅抢占式实例返回,LowSpeed为低速模式,PowerOff为关机模式
1247
2008
  */
1248
2009
  RestrictMode?: string;
2010
+ /**
2011
+ * true: 开启热升级; false,未开启热升级
2012
+ */
2013
+ HotplugFeature?: boolean;
2014
+ /**
2015
+ * true: 支持cloutinit方式初始化;false: 不支持
2016
+ */
2017
+ CloudInitFeature?: boolean;
2018
+ /**
2019
+ * true: 有ipv6特性;false,没有ipv6特性
2020
+ */
2021
+ IPv6Feature?: boolean;
1249
2022
  /**
1250
2023
  * true: 开启 hpc 系列功能;false: 未开启
1251
2024
  */
1252
2025
  HpcFeature?: boolean;
2026
+ /**
2027
+ * true: 高性能计算主机;false: 不是
2028
+ */
2029
+ EpcInstance?: boolean;
2030
+ /**
2031
+ * 【待废弃】true: 绑定了安全组的主机;false: 不是
2032
+ */
2033
+ SecGroupInstance?: boolean;
2034
+ /**
2035
+ * Firewall:防火墙,SecGroup:安全组,Acl:acl
2036
+ */
2037
+ NetFeatureTag?: string;
2038
+ /**
2039
+ * true: 开启 hidden kvm 功能;false: 不是
2040
+ */
2041
+ HiddenKvm?: boolean;
1253
2042
  /**
1254
2043
  * 密钥信息见 UHostKeyPair
1255
2044
  */
@@ -1263,6 +2052,32 @@ export interface DescribeUHostInstanceResponse {
1263
2052
  */
1264
2053
  KeyPairState?: string;
1265
2054
  };
2055
+ /**
2056
+ * 私有专区宿主机属性
2057
+ */
2058
+ UDHostAttribute?: {
2059
+ /**
2060
+ * 私有专区宿主机
2061
+ */
2062
+ UDHostId?: string;
2063
+ /**
2064
+ * 私有专区
2065
+ */
2066
+ UDSetId?: string;
2067
+ /**
2068
+ * 是否绑定私有专区宿主机
2069
+ */
2070
+ HostBinding?: boolean;
2071
+ };
2072
+ /**
2073
+ * 竞价实例信息
2074
+ */
2075
+ SpotAttribute?: {
2076
+ /**
2077
+ * 回收时间
2078
+ */
2079
+ RecycleTime?: number;
2080
+ };
1266
2081
  }[];
1267
2082
  }
1268
2083
  /**
@@ -1368,7 +2183,7 @@ export interface GetAttachedDiskUpgradePriceRequest {
1368
2183
  */
1369
2184
  Zone?: string;
1370
2185
  /**
1371
- * 磁盘大小,单位GB,步长为10。取值范围需大于当前磁盘大小,最大值请参考[[api:uhost-api:disk_type|磁盘类型]]。
2186
+ * 磁盘大小,单位GB。取值范围需大于当前磁盘大小,最大值请参考[[api:uhost-api:disk_type|磁盘类型]]。
1372
2187
  */
1373
2188
  DiskSpace: number;
1374
2189
  /**
@@ -1392,6 +2207,53 @@ export interface GetAttachedDiskUpgradePriceResponse {
1392
2207
  * 升级差价。精度为小数点后2位。
1393
2208
  */
1394
2209
  Price?: number;
2210
+ /**
2211
+ * 用户折后价。精度为小数点后2位。
2212
+ */
2213
+ OriginalPrice?: number;
2214
+ /**
2215
+ * 原价。精度为小数点后2位。
2216
+ */
2217
+ ListPrice?: number;
2218
+ /**
2219
+ * 升级价格详情,精度为小数点后2位。
2220
+ */
2221
+ PriceDetail?: {
2222
+ /**
2223
+ * 磁盘的价格
2224
+ */
2225
+ UDisk?: number;
2226
+ /**
2227
+ * 快照的价格
2228
+ */
2229
+ Snapshot?: number;
2230
+ };
2231
+ /**
2232
+ * 用户折后价详情,精度为小数点后2位。
2233
+ */
2234
+ OriginalPriceDetail?: {
2235
+ /**
2236
+ * 磁盘的价格
2237
+ */
2238
+ UDisk?: number;
2239
+ /**
2240
+ * 快照的价格
2241
+ */
2242
+ Snapshot?: number;
2243
+ };
2244
+ /**
2245
+ * 原价详情,精度为小数点后2位。
2246
+ */
2247
+ ListPriceDetail?: {
2248
+ /**
2249
+ * 磁盘的价格
2250
+ */
2251
+ UDisk?: number;
2252
+ /**
2253
+ * 快照的价格
2254
+ */
2255
+ Snapshot?: number;
2256
+ };
1395
2257
  }
1396
2258
  /**
1397
2259
  * GetUHostInstancePrice - 根据UHost实例配置,获取UHost实例的价格。
@@ -1443,7 +2305,7 @@ export interface GetUHostInstancePriceRequest {
1443
2305
  */
1444
2306
  GPU?: number;
1445
2307
  /**
1446
- * 计费模式。枚举值为: \\ > Year,按年付费; \\ > Month,按月付费;\\ > Dynamic,按小时付费 // >Preemptive 抢占式实例 \\ 如果不传某个枚举值,默认返回年付、月付、时付的价格组合集。
2308
+ * 计费模式。枚举值为: \\ > Year,按年付费; \\ > Month,按月付费;\\ > Dynamic,按小时付费 // >Spot 抢占式实例 \\ 如果不传某个枚举值,默认返回年付、月付、时付的价格组合集。
1447
2309
  */
1448
2310
  ChargeType?: string;
1449
2311
  /**
@@ -1455,11 +2317,11 @@ export interface GetUHostInstancePriceRequest {
1455
2317
  */
1456
2318
  UHostType?: string;
1457
2319
  /**
1458
- * 云主机机型(V2版本概念)。枚举值["N", "C", "G", "O", "OS", "OPRO", "OMAX", "O.BM"]。参考[[api:uhost-api:uhost_type|云主机机型说明]]。
2320
+ * 云主机机型(V2版本概念)。枚举值["N", "C", "G", "O", "OS", "OPRO", "OMAX", "O.BM", "O.EPC"]。参考[[api:uhost-api:uhost_type|云主机机型说明]]。
1459
2321
  */
1460
2322
  MachineType?: string;
1461
2323
  /**
1462
- * GPU类型,枚举值["K80", "P40", "V100", "T4","T4S","2080Ti","2080Ti-4C","1080Ti"]
2324
+ * GPU类型,枚举值["K80", "P40", "V100", "T4","T4A", "T4S","2080Ti","2080Ti-4C","1080Ti", "T4/4", "MI100", "V100S",2080","2080TiS","2080TiPro","3090","4090","4090Pro","A100","A800"]
1463
2325
  */
1464
2326
  GpuType?: string;
1465
2327
  /**
@@ -1475,9 +2337,17 @@ export interface GetUHostInstancePriceRequest {
1475
2337
  */
1476
2338
  Volumes?: object[];
1477
2339
  /**
1478
- *
2340
+ * 专区云主机。如果要在专区宿主机上创建云主机,该参数可以填写为true
2341
+ */
2342
+ UDSetUHostInstance?: boolean;
2343
+ /**
2344
+ * 返回价格详细信息
2345
+ */
2346
+ ShowPriceDetails?: boolean;
2347
+ /**
2348
+ * 规格族。 由机型代号和 CPU 平台组成,用于指定云主机的硬件类型与处理器平台。当 MachineType 为 "O"(快杰型)时,支持以下取值: - o1i:快杰型 O1 代,Intel 平台 - o1a:快杰型 O1 代,AMD 平台- o1r:快杰型 O1 代,ARM 平台 - o2i:快杰型 O2 代,Intel 平台 默认值:o1i 或 o1a或o1r当 MachineType 为 "OM"(快杰共享型)时,支持以下取值: - om1i:快杰内存增强型 OM1 代,Intel 平台 - om2i:快杰内存增强型 OM2 代,Intel 平台注意:规格族必须与 MachineType 匹配,否则请求将被拒绝。
1479
2349
  */
1480
- VirtualGpu?: object;
2350
+ UHostFamily?: string;
1481
2351
  }
1482
2352
  /**
1483
2353
  * GetUHostInstancePrice - 根据UHost实例配置,获取UHost实例的价格。
@@ -1496,13 +2366,51 @@ export interface GetUHostInstancePriceResponse {
1496
2366
  */
1497
2367
  Price: number;
1498
2368
  /**
1499
- * 限时优惠的折前原价(即列表价乘以商务折扣后的单价)。
2369
+ * 限时优惠的折前原价。
1500
2370
  */
1501
2371
  OriginalPrice: number;
1502
2372
  /**
1503
- * 产品列表价。
2373
+ * 价格详细信息(只有询价接口返回)。
2374
+ */
2375
+ PriceDetail?: {
2376
+ /**
2377
+ * 主机价格
2378
+ */
2379
+ UHost?: number;
2380
+ /**
2381
+ * 云盘价格
2382
+ */
2383
+ UDisk?: number;
2384
+ /**
2385
+ * 快照价格
2386
+ */
2387
+ Snapshot?: number;
2388
+ /**
2389
+ * 数据卷价格
2390
+ */
2391
+ Volume?: number;
2392
+ };
2393
+ /**
2394
+ * 原价详细信息(只有询价接口返回)。
1504
2395
  */
1505
- ListPrice?: number;
2396
+ OriginalPriceDetail?: {
2397
+ /**
2398
+ * 主机价格
2399
+ */
2400
+ UHost?: number;
2401
+ /**
2402
+ * 云盘价格
2403
+ */
2404
+ UDisk?: number;
2405
+ /**
2406
+ * 快照价格
2407
+ */
2408
+ Snapshot?: number;
2409
+ /**
2410
+ * 数据卷价格
2411
+ */
2412
+ Volume?: number;
2413
+ };
1506
2414
  }[];
1507
2415
  }
1508
2416
  /**
@@ -1539,6 +2447,72 @@ export interface GetUHostInstanceVncInfoResponse {
1539
2447
  */
1540
2448
  VncPassword?: string;
1541
2449
  }
2450
+ /**
2451
+ * GetUHostRefundPrice - 获取主机删除扣除费用。包括主机、磁盘、快照服务、EIP等资源的费用
2452
+ */
2453
+ export interface GetUHostRefundPriceRequest {
2454
+ /**
2455
+ * 【数组】UHost实例ID。参见 [DescribeUHostInstance](describe_uhost_instance.html)
2456
+ */
2457
+ UHostIds: string[];
2458
+ }
2459
+ /**
2460
+ * GetUHostRefundPrice - 获取主机删除扣除费用。包括主机、磁盘、快照服务、EIP等资源的费用
2461
+ */
2462
+ export interface GetUHostRefundPriceResponse {
2463
+ /**
2464
+ * 主机删除扣除费用详情
2465
+ */
2466
+ RefundPriceSet: {
2467
+ /**
2468
+ * UHost实例ID
2469
+ */
2470
+ UHostId: string;
2471
+ /**
2472
+ * 实例操作结果的错误码。0为成功
2473
+ */
2474
+ Code: number;
2475
+ /**
2476
+ * 实例的删除退费金额
2477
+ */
2478
+ RefundPrice?: number;
2479
+ }[];
2480
+ }
2481
+ /**
2482
+ * GetUHostRenewPrice - 获取主机续费价格
2483
+ */
2484
+ export interface GetUHostRenewPriceRequest {
2485
+ /**
2486
+ * UHost实例ID
2487
+ */
2488
+ UHostId: string;
2489
+ /**
2490
+ * 计费类型。Year,Month,Dynamic,默认返回全部计费方式对应的价格
2491
+ */
2492
+ ChargeType: string;
2493
+ }
2494
+ /**
2495
+ * GetUHostRenewPrice - 获取主机续费价格
2496
+ */
2497
+ export interface GetUHostRenewPriceResponse {
2498
+ /**
2499
+ * 价格列表
2500
+ */
2501
+ PriceSet?: {
2502
+ /**
2503
+ * 计费类型
2504
+ */
2505
+ ChargeType?: string;
2506
+ /**
2507
+ * 价格,单位: 元,保留小数点后两位有效数字
2508
+ */
2509
+ Price?: number;
2510
+ /**
2511
+ * 限时优惠的折前原价(即列表价乘以商务折扣后的单价)。
2512
+ */
2513
+ OriginalPrice?: number;
2514
+ }[];
2515
+ }
1542
2516
  /**
1543
2517
  * GetUHostUpgradePrice - 获取UHost实例升级配置的价格。可选配置范围请参考[[api:uhost-api:uhost_type|云主机机型说明]]。
1544
2518
  */
@@ -1560,7 +2534,11 @@ export interface GetUHostUpgradePriceRequest {
1560
2534
  */
1561
2535
  Memory?: number;
1562
2536
  /**
1563
- * 网卡升降级(1,表示升级,2表示降级,0表示不变)
2537
+ * GPU卡核心数。仅GPU机型支持此字段(可选范围与MachineType+GpuType相关)
2538
+ */
2539
+ GPU?: number;
2540
+ /**
2541
+ * 网卡升降级(1,表示升级,2表示降级,0表示不变)。仅支持网络增强1.0和网络增强2.0的开启和关闭,不支持网络增强特性互相转换,如网络增强1.0升级到网络增强2.0是不被支持的。
1564
2542
  */
1565
2543
  NetCapValue?: number;
1566
2544
  }
@@ -1605,6 +2583,10 @@ export interface ImportCustomImageRequest {
1605
2583
  * 是否授权。必须填true
1606
2584
  */
1607
2585
  Auth: boolean;
2586
+ /**
2587
+ * 业务组
2588
+ */
2589
+ Tag?: string;
1608
2590
  /**
1609
2591
  * 镜像描述
1610
2592
  */
@@ -1856,11 +2838,11 @@ export interface ReinstallUHostInstanceRequest {
1856
2838
  */
1857
2839
  ImageId?: string;
1858
2840
  /**
1859
- * 是否保留数据盘,保留:Yes,不报留:No, 默认:Yes;如果是从Windows重装为Linux或反之,则无法保留数据盘(该参数目前仅对本地数据盘起作用)
2841
+ * 是否保留数据盘,保留:Yes,不保留:No, 默认:Yes;如果是从Windows重装为Linux或反之,则无法保留数据盘(该参数目前仅对本地数据盘起作用)
1860
2842
  */
1861
2843
  ReserveDisk?: string;
1862
2844
  /**
1863
- * 系统盘大小。 单位:GB, 范围[20,100], 步长:10
2845
+ * 系统盘大小。 单位:GB, 范围[20,100]
1864
2846
  */
1865
2847
  BootDiskSpace?: number;
1866
2848
  /**
@@ -1872,13 +2854,17 @@ export interface ReinstallUHostInstanceRequest {
1872
2854
  */
1873
2855
  AutoDataDiskInit?: string;
1874
2856
  /**
1875
- * 主机登陆模式。密码(默认选项): Password,密钥 KeyPair。
2857
+ * 主机登陆模式。密码(默认选项): Password,密钥 KeyPair,自制镜像密码: ImagePasswd
1876
2858
  */
1877
2859
  LoginMode?: string;
1878
2860
  /**
1879
2861
  * KeypairId 密钥对ID,LoginMode为KeyPair时此项必须。
1880
2862
  */
1881
2863
  KeyPairId?: string;
2864
+ /**
2865
+ * 操作系统主机名
2866
+ */
2867
+ HostName?: string;
1882
2868
  }
1883
2869
  /**
1884
2870
  * ReinstallUHostInstance - 重新安装指定UHost实例的操作系统
@@ -1904,7 +2890,19 @@ export interface ResetUHostInstancePasswordRequest {
1904
2890
  /**
1905
2891
  * UHost新密码(密码格式使用BASE64编码)
1906
2892
  */
1907
- Password: string;
2893
+ Password?: string;
2894
+ /**
2895
+ * 主机登陆模式。密码(默认选项): Password,密钥 KeyPair。
2896
+ */
2897
+ LoginMode?: string;
2898
+ /**
2899
+ * KeypairId 密钥对ID,LoginMode为KeyPair时此项必须。
2900
+ */
2901
+ KeyPairId?: string;
2902
+ /**
2903
+ * 修改密码结束后是否立即开机,默认为false, 如果设置为true,则修改密码成功后立即开机; 抢占式和后付费云主机暂不支持当前功能;
2904
+ */
2905
+ AutoStart?: boolean;
1908
2906
  }
1909
2907
  /**
1910
2908
  * ResetUHostInstancePassword - 重置UHost实例的管理员密码。
@@ -1973,10 +2971,18 @@ export interface ResizeUHostInstanceRequest {
1973
2971
  * 内存大小。单位:MB。范围 :[1024, 1966080],取值为1024的倍数(可选范围与UHostType相关)。默认值为当前实例的内存大小。
1974
2972
  */
1975
2973
  Memory?: number;
2974
+ /**
2975
+ * GPU卡核心数。仅GPU机型支持此字段(可选范围与MachineType+GpuType相关)
2976
+ */
2977
+ GPU?: number;
1976
2978
  /**
1977
2979
  * 网卡升降级(1,表示升级,2表示降级,0表示不变)
1978
2980
  */
1979
2981
  NetCapValue?: number;
2982
+ /**
2983
+ * 扩容结束后是否立即开机,默认为false,如果设置为true,则扩容成功后立即开机;抢占式和后付费云主机暂不支持当前功能;
2984
+ */
2985
+ AutoStart?: boolean;
1980
2986
  }
1981
2987
  /**
1982
2988
  * ResizeUHostInstance - 修改指定UHost实例的资源配置,如CPU核心数,内存容量大小,网络增强等。可选配置范围请参考[[api:uhost-api:uhost_type|云主机机型说明]]。
@@ -2087,29 +3093,3 @@ export interface TerminateUHostInstanceResponse {
2087
3093
  */
2088
3094
  UHostId?: string;
2089
3095
  }
2090
- /**
2091
- * UpgradeToArkUHostInstance - 普通升级为方舟机型
2092
- */
2093
- export interface UpgradeToArkUHostInstanceRequest {
2094
- /**
2095
- * 可用区。参见 [可用区列表](https://docs.ucloud.cn/api/summary/regionlist)
2096
- */
2097
- Zone: string;
2098
- /**
2099
- * UHost主机的资源ID,例如UHostIds.0代表希望升级的主机1,UHostIds.1代表主机2。
2100
- */
2101
- UHostIds: string[];
2102
- /**
2103
- * 代金券ID 请参考DescribeCoupon接口
2104
- */
2105
- CouponId?: string;
2106
- }
2107
- /**
2108
- * UpgradeToArkUHostInstance - 普通升级为方舟机型
2109
- */
2110
- export interface UpgradeToArkUHostInstanceResponse {
2111
- /**
2112
- * UHost主机的资源ID数组
2113
- */
2114
- UHostSet?: string[];
2115
- }