tencentcloud-sdk-nodejs-cbs 4.0.1031 → 4.0.1035

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tencentcloud-sdk-nodejs-cbs",
3
- "version": "4.0.1031",
3
+ "version": "4.0.1035",
4
4
  "description": "Tencent Cloud API NODEJS SDK",
5
5
  "main": "tencentcloud/index.js",
6
6
  "scripts": {
@@ -20,11 +20,12 @@ import {
20
20
  ModifyDiskExtraPerformanceRequest,
21
21
  ModifyDiskAttributesResponse,
22
22
  DescribeDiskBackupsRequest,
23
+ CreateSnapshotGroupRequest,
23
24
  AutoSnapshotPolicy,
24
25
  DetailPrice,
25
26
  ModifySnapshotsSharePermissionRequest,
26
27
  CopySnapshotCrossRegionsResponse,
27
- ModifyAutoSnapshotPolicyAttributeResponse,
28
+ DescribeSnapshotGroupsRequest,
28
29
  ModifyDiskBackupQuotaRequest,
29
30
  InquiryPriceCreateDisksResponse,
30
31
  BindAutoSnapshotPolicyRequest,
@@ -53,6 +54,7 @@ import {
53
54
  TerminateDisksResponse,
54
55
  ApplySnapshotResponse,
55
56
  DetachDisksRequest,
57
+ DescribeSnapshotGroupsResponse,
56
58
  DescribeSnapshotOverviewResponse,
57
59
  ModifyDisksChargeTypeResponse,
58
60
  CreateSnapshotRequest,
@@ -74,6 +76,7 @@ import {
74
76
  ModifyDiskAttributesRequest,
75
77
  GetSnapOverviewRequest,
76
78
  Image,
79
+ ModifyAutoSnapshotPolicyAttributeResponse,
77
80
  TerminateDisksRequest,
78
81
  CdcSize,
79
82
  DescribeInstancesDiskNumResponse,
@@ -89,6 +92,8 @@ import {
89
92
  InquirePriceModifyDiskBackupQuotaResponse,
90
93
  DeleteAutoSnapshotPoliciesRequest,
91
94
  DiskChargePrepaid,
95
+ DeleteSnapshotGroupResponse,
96
+ ApplySnapshotGroupResponse,
92
97
  DescribeSnapshotOverviewRequest,
93
98
  Filter,
94
99
  InquiryPriceCreateDisksRequest,
@@ -97,6 +102,8 @@ import {
97
102
  CreateDisksResponse,
98
103
  AttachDisksResponse,
99
104
  CreateDiskBackupRequest,
105
+ DeleteSnapshotGroupRequest,
106
+ SnapshotGroup,
100
107
  BindAutoSnapshotPolicyResponse,
101
108
  DiskBackup,
102
109
  DescribeDisksRequest,
@@ -110,6 +117,7 @@ import {
110
117
  InquiryPriceResizeDiskRequest,
111
118
  DescribeDiskConfigQuotaRequest,
112
119
  DescribeDiskAssociatedAutoSnapshotPolicyResponse,
120
+ ApplySnapshotGroupRequest,
113
121
  GetSnapOverviewResponse,
114
122
  AutoMountConfiguration,
115
123
  CopySnapshotCrossRegionsRequest,
@@ -117,9 +125,11 @@ import {
117
125
  RenewDiskResponse,
118
126
  DescribeAutoSnapshotPoliciesResponse,
119
127
  Cdc,
128
+ ApplyDisk,
120
129
  UnbindAutoSnapshotPolicyResponse,
121
130
  AttachDetail,
122
131
  CreateAutoSnapshotPolicyRequest,
132
+ CreateSnapshotGroupResponse,
123
133
  Price,
124
134
  ApplySnapshotRequest,
125
135
  } from "./cbs_models"
@@ -254,13 +264,27 @@ export class Client extends TencentCloudCommon.AbstractClient {
254
264
  }
255
265
 
256
266
  /**
257
- * 本接口(InquirePricePriceModifyDiskBackupQuota)用于修改云硬盘备份点配额询价。
267
+ * 本接口(CreateSnapshotGroup)用于创建快照组。
268
+ * 创建快照组的云硬盘列表必须挂载在同一实例上;
269
+ * 可选择挂载在实例上的全部或部分盘创建快照组。
258
270
  */
259
- async InquirePriceModifyDiskBackupQuota(
260
- req: InquirePriceModifyDiskBackupQuotaRequest,
261
- cb?: (error: string, rep: InquirePriceModifyDiskBackupQuotaResponse) => void
262
- ): Promise<InquirePriceModifyDiskBackupQuotaResponse> {
263
- return this.request("InquirePriceModifyDiskBackupQuota", req, cb)
271
+ async CreateSnapshotGroup(
272
+ req: CreateSnapshotGroupRequest,
273
+ cb?: (error: string, rep: CreateSnapshotGroupResponse) => void
274
+ ): Promise<CreateSnapshotGroupResponse> {
275
+ return this.request("CreateSnapshotGroup", req, cb)
276
+ }
277
+
278
+ /**
279
+ * 本接口(DeleteSnapshotGroup)用于删除快照组,一次调用仅支持删除一个快照组。
280
+ * 默认会删除快照组内的所有快照;
281
+ * 如果快照组内的快照有关联镜像,则删除失败,所有快照均不会删除;如果需要同时删除快照绑定的镜像,可传入参数DeleteBindImages等于true。
282
+ */
283
+ async DeleteSnapshotGroup(
284
+ req: DeleteSnapshotGroupRequest,
285
+ cb?: (error: string, rep: DeleteSnapshotGroupResponse) => void
286
+ ): Promise<DeleteSnapshotGroupResponse> {
287
+ return this.request("DeleteSnapshotGroup", req, cb)
264
288
  }
265
289
 
266
290
  /**
@@ -311,6 +335,19 @@ export class Client extends TencentCloudCommon.AbstractClient {
311
335
  return this.request("DescribeDiskBackups", req, cb)
312
336
  }
313
337
 
338
+ /**
339
+ * 本接口(ApplySnapshotGroup)用于回滚快照组,将实例恢复到创建快照组时刻的状态。
340
+ * 1.可选择快照组全部或部分盘进行回滚;
341
+ * 2.如果回滚的盘中包含已挂载的盘,要求这些盘必须挂载在同一实例上,且要求该实例已关机才能回滚;
342
+ * 3.回滚为异步操作,接口返回成功不代表回滚成功,可通过调DescribeSnapshotGroups接口查询快照组的状态。
343
+ */
344
+ async ApplySnapshotGroup(
345
+ req: ApplySnapshotGroupRequest,
346
+ cb?: (error: string, rep: ApplySnapshotGroupResponse) => void
347
+ ): Promise<ApplySnapshotGroupResponse> {
348
+ return this.request("ApplySnapshotGroup", req, cb)
349
+ }
350
+
314
351
  /**
315
352
  * 本接口(DeleteAutoSnapshotPolicies)用于删除定期快照策略。
316
353
 
@@ -350,6 +387,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
350
387
  return this.request("DescribeDisks", req, cb)
351
388
  }
352
389
 
390
+ /**
391
+ * 本接口(DescribeSnapshotGroups)用于查询快照组列表。
392
+ * 可以根据快照组ID、快照组状态、快照组关联的快照ID等来查询快照组列表,不同条件之间为与(AND)的关系,过滤信息详细请见过滤器`Filter`。
393
+ * 如果参数为空,返回当前用户一定数量(`Limit`所指定的数量,默认为20)的快照组列表。
394
+ */
395
+ async DescribeSnapshotGroups(
396
+ req: DescribeSnapshotGroupsRequest,
397
+ cb?: (error: string, rep: DescribeSnapshotGroupsResponse) => void
398
+ ): Promise<DescribeSnapshotGroupsResponse> {
399
+ return this.request("DescribeSnapshotGroups", req, cb)
400
+ }
401
+
353
402
  /**
354
403
  * 此接口 (ModifyDiskBackupQuota) 用于修改云硬盘备份点配额。
355
404
  */
@@ -558,6 +607,16 @@ export class Client extends TencentCloudCommon.AbstractClient {
558
607
  return this.request("ApplySnapshot", req, cb)
559
608
  }
560
609
 
610
+ /**
611
+ * 本接口(InquirePricePriceModifyDiskBackupQuota)用于修改云硬盘备份点配额询价。
612
+ */
613
+ async InquirePriceModifyDiskBackupQuota(
614
+ req: InquirePriceModifyDiskBackupQuotaRequest,
615
+ cb?: (error: string, rep: InquirePriceModifyDiskBackupQuotaResponse) => void
616
+ ): Promise<InquirePriceModifyDiskBackupQuotaResponse> {
617
+ return this.request("InquirePriceModifyDiskBackupQuota", req, cb)
618
+ }
619
+
561
620
  /**
562
621
  * 本接口(ModifySnapshotsSharePermission)用于修改快照分享信息。
563
622
 
@@ -69,6 +69,24 @@ export interface DescribeDiskBackupsRequest {
69
69
  OrderField?: string
70
70
  }
71
71
 
72
+ /**
73
+ * CreateSnapshotGroup请求参数结构体
74
+ */
75
+ export interface CreateSnapshotGroupRequest {
76
+ /**
77
+ * 需要创建快照组的云硬盘ID列表,必须选择挂载在同一实例上的盘列表。
78
+ */
79
+ DiskIds: Array<string>
80
+ /**
81
+ * 快照组名称,快照组关联的快照也会继承快照组的名称。例如:快照组名称为testSnapshotGroup,快照组关联两个快照,则两个快照的名称分别为testSnapshotGroup_0,testSnapshotGroup_1。
82
+ */
83
+ SnapshotGroupName?: string
84
+ /**
85
+ * 快照组需要绑定的标签列表。
86
+ */
87
+ Tags?: Array<Tag>
88
+ }
89
+
72
90
  /**
73
91
  * 描述了定期快照策略的详细信息
74
92
  */
@@ -252,13 +270,21 @@ export interface CopySnapshotCrossRegionsResponse {
252
270
  }
253
271
 
254
272
  /**
255
- * ModifyAutoSnapshotPolicyAttribute返回参数结构体
273
+ * DescribeSnapshotGroups请求参数结构体
256
274
  */
257
- export interface ModifyAutoSnapshotPolicyAttributeResponse {
275
+ export interface DescribeSnapshotGroupsRequest {
258
276
  /**
259
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
277
+ * 过滤条件。<br><li>snapshot-group-id - Array of String - 是否必填:否 -(过滤条件)按快照组ID过滤 <br><li>snapshot-group-state - Array of String - 是否必填:否 -(过滤条件)按快照组状态过滤。(NORMAL: 正常 | CREATING:创建中 | ROLLBACKING:回滚中) <br><li>snapshot-group-name - Array of String - 是否必填:否 -(过滤条件)按快照组名称过滤 <br><li>snapshot-id - Array of String - 是否必填:否 -(过滤条件)按快照组内的快照ID过滤
260
278
  */
261
- RequestId?: string
279
+ Filters?: Array<Filter>
280
+ /**
281
+ * 偏移量,默认为0。
282
+ */
283
+ Offset?: number
284
+ /**
285
+ * 返回数量,默认为20,最大值为100。
286
+ */
287
+ Limit?: number
262
288
  }
263
289
 
264
290
  /**
@@ -961,6 +987,24 @@ export interface DetachDisksRequest {
961
987
  InstanceId?: string
962
988
  }
963
989
 
990
+ /**
991
+ * DescribeSnapshotGroups返回参数结构体
992
+ */
993
+ export interface DescribeSnapshotGroupsResponse {
994
+ /**
995
+ * 符合条件的总数量。
996
+ */
997
+ TotalCount?: number
998
+ /**
999
+ * 快照组列表详情。
1000
+ */
1001
+ SnapshotGroupSet?: Array<SnapshotGroup>
1002
+ /**
1003
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1004
+ */
1005
+ RequestId?: string
1006
+ }
1007
+
964
1008
  /**
965
1009
  * DescribeSnapshotOverview返回参数结构体
966
1010
  */
@@ -1294,6 +1338,16 @@ export interface Image {
1294
1338
  ImageId?: string
1295
1339
  }
1296
1340
 
1341
+ /**
1342
+ * ModifyAutoSnapshotPolicyAttribute返回参数结构体
1343
+ */
1344
+ export interface ModifyAutoSnapshotPolicyAttributeResponse {
1345
+ /**
1346
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1347
+ */
1348
+ RequestId?: string
1349
+ }
1350
+
1297
1351
  /**
1298
1352
  * TerminateDisks请求参数结构体
1299
1353
  */
@@ -1346,9 +1400,9 @@ export interface ResizeDiskRequest {
1346
1400
  */
1347
1401
  DiskSize: number
1348
1402
  /**
1349
- * 云硬盘ID, 通过[DescribeDisks](/document/product/362/16315)接口查询。
1403
+ * 云硬盘ID, 通过[DescribeDisks](/document/product/362/16315)接口查询。该字段仅供单块云硬盘扩容时传入。
1350
1404
  */
1351
- DiskId: string
1405
+ DiskId?: string
1352
1406
  }
1353
1407
 
1354
1408
  /**
@@ -1570,6 +1624,26 @@ export interface DiskChargePrepaid {
1570
1624
  CurInstanceDeadline?: string
1571
1625
  }
1572
1626
 
1627
+ /**
1628
+ * DeleteSnapshotGroup返回参数结构体
1629
+ */
1630
+ export interface DeleteSnapshotGroupResponse {
1631
+ /**
1632
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1633
+ */
1634
+ RequestId?: string
1635
+ }
1636
+
1637
+ /**
1638
+ * ApplySnapshotGroup返回参数结构体
1639
+ */
1640
+ export interface ApplySnapshotGroupResponse {
1641
+ /**
1642
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1643
+ */
1644
+ RequestId?: string
1645
+ }
1646
+
1573
1647
  /**
1574
1648
  * DescribeSnapshotOverview请求参数结构体
1575
1649
  */
@@ -1795,6 +1869,83 @@ export interface CreateDiskBackupRequest {
1795
1869
  DiskBackupName?: string
1796
1870
  }
1797
1871
 
1872
+ /**
1873
+ * DeleteSnapshotGroup请求参数结构体
1874
+ */
1875
+ export interface DeleteSnapshotGroupRequest {
1876
+ /**
1877
+ * 快照组ID。
1878
+ */
1879
+ SnapshotGroupId?: string
1880
+ /**
1881
+ * 快照组ID 列表。此参数与快照组 ID 至少传 1 个,同时传会与快照组 ID 合并。
1882
+ */
1883
+ SnapshotGroupIds?: Array<string>
1884
+ /**
1885
+ * 是否同时删除快照组关联的镜像;取值为false,表示不删除快照组绑定的镜像,此时,如果快照组有绑定的镜像,删除会失败;取值为true,表示同时删除快照组绑定的镜像;默认值为false。
1886
+ */
1887
+ DeleteBindImages?: boolean
1888
+ }
1889
+
1890
+ /**
1891
+ * 描述快照组详情
1892
+ */
1893
+ export interface SnapshotGroup {
1894
+ /**
1895
+ * 快照组ID。
1896
+ */
1897
+ SnapshotGroupId: string
1898
+ /**
1899
+ * 快照组类型。NORMAL: 普通快照组,非一致性快照。
1900
+ */
1901
+ SnapshotGroupType: string
1902
+ /**
1903
+ * 快照组是否包含系统盘快照。
1904
+ */
1905
+ ContainRootSnapshot: boolean
1906
+ /**
1907
+ * 快照组包含的快照ID列表。
1908
+ */
1909
+ SnapshotIdSet: Array<string>
1910
+ /**
1911
+ * 快照组状态。<br><li>NORMAL: 正常<br><li>CREATING:创建中<br><li>ROLLBACKING:回滚中
1912
+ */
1913
+ SnapshotGroupState: string
1914
+ /**
1915
+ * 快照组创建进度。
1916
+ */
1917
+ Percent: number
1918
+ /**
1919
+ * 快照组创建时间。
1920
+ */
1921
+ CreateTime: string
1922
+ /**
1923
+ * 快照组最新修改时间
1924
+ */
1925
+ ModifyTime: string
1926
+ /**
1927
+ * 快照组关联的镜像列表。
1928
+ */
1929
+ Images: Array<Image>
1930
+ /**
1931
+ * 快照组名称。
1932
+ */
1933
+ SnapshotGroupName: string
1934
+ /**
1935
+ * 快照组关联的镜像数量。
1936
+ */
1937
+ ImageCount: number
1938
+ /**
1939
+ * 快照组是否永久保留
1940
+ */
1941
+ IsPermanent: boolean
1942
+ /**
1943
+ * 快照组到期时间。
1944
+ 注意:此字段可能返回 null,表示取不到有效值。
1945
+ */
1946
+ DeadlineTime: string
1947
+ }
1948
+
1798
1949
  /**
1799
1950
  * BindAutoSnapshotPolicy返回参数结构体
1800
1951
  */
@@ -2065,6 +2216,28 @@ export interface DescribeDiskAssociatedAutoSnapshotPolicyResponse {
2065
2216
  RequestId?: string
2066
2217
  }
2067
2218
 
2219
+ /**
2220
+ * ApplySnapshotGroup请求参数结构体
2221
+ */
2222
+ export interface ApplySnapshotGroupRequest {
2223
+ /**
2224
+ * 回滚的快照组ID。
2225
+ */
2226
+ SnapshotGroupId: string
2227
+ /**
2228
+ * 回滚的快照组关联的快照ID,及快照对应的原云硬盘ID列表。
2229
+ */
2230
+ ApplyDisks: Array<ApplyDisk>
2231
+ /**
2232
+ * 回滚前是否执行自动关机。
2233
+ */
2234
+ AutoStopInstance?: boolean
2235
+ /**
2236
+ * 回滚完成后是否自动开机。
2237
+ */
2238
+ AutoStartInstance?: boolean
2239
+ }
2240
+
2068
2241
  /**
2069
2242
  * GetSnapOverview返回参数结构体
2070
2243
  */
@@ -2260,6 +2433,20 @@ export interface Cdc {
2260
2433
  DiskNumber?: number
2261
2434
  }
2262
2435
 
2436
+ /**
2437
+ * 本参数用于快照组回滚接口的入参,表示回滚的云盘、快照列表。
2438
+ */
2439
+ export interface ApplyDisk {
2440
+ /**
2441
+ * 快照组关联的快照ID。
2442
+ */
2443
+ SnapshotId: string
2444
+ /**
2445
+ * 快照组关联快照对应的原云硬盘ID。
2446
+ */
2447
+ DiskId: string
2448
+ }
2449
+
2263
2450
  /**
2264
2451
  * UnbindAutoSnapshotPolicy返回参数结构体
2265
2452
  */
@@ -2318,6 +2505,20 @@ export interface CreateAutoSnapshotPolicyRequest {
2318
2505
  RetentionDays?: number
2319
2506
  }
2320
2507
 
2508
+ /**
2509
+ * CreateSnapshotGroup返回参数结构体
2510
+ */
2511
+ export interface CreateSnapshotGroupResponse {
2512
+ /**
2513
+ * 创建成功的快照组ID。
2514
+ */
2515
+ SnapshotGroupId?: string
2516
+ /**
2517
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2518
+ */
2519
+ RequestId?: string
2520
+ }
2521
+
2321
2522
  /**
2322
2523
  * 描述预付费或后付费云盘的价格。
2323
2524
  */
@@ -1,5 +1,5 @@
1
1
  import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
2
- import { ModifyDiskExtraPerformanceRequest, ModifyDiskAttributesResponse, DescribeDiskBackupsRequest, ModifySnapshotsSharePermissionRequest, CopySnapshotCrossRegionsResponse, ModifyAutoSnapshotPolicyAttributeResponse, ModifyDiskBackupQuotaRequest, InquiryPriceCreateDisksResponse, BindAutoSnapshotPolicyRequest, CreateSnapshotResponse, DescribeAutoSnapshotPoliciesRequest, ModifySnapshotsSharePermissionResponse, DeleteDiskBackupsRequest, InitializeDisksResponse, DescribeDiskStoragePoolRequest, DescribeDiskBackupsResponse, RenewDiskRequest, InquirePriceModifyDiskExtraPerformanceResponse, CreateDisksRequest, AttachDisksRequest, DescribeDiskAssociatedAutoSnapshotPolicyRequest, DescribeSnapshotsRequest, ModifyAutoSnapshotPolicyAttributeRequest, DescribeDiskConfigQuotaResponse, ApplyDiskBackupResponse, InquiryPriceResizeDiskResponse, ResizeDiskResponse, TerminateDisksResponse, ApplySnapshotResponse, DetachDisksRequest, DescribeSnapshotOverviewResponse, ModifyDisksChargeTypeResponse, CreateSnapshotRequest, DescribeInstancesDiskNumRequest, DescribeSnapshotSharePermissionResponse, ModifyDiskBackupQuotaResponse, InquiryPriceRenewDisksRequest, DescribeSnapshotSharePermissionRequest, InquirePriceModifyDiskBackupQuotaRequest, DeleteDiskBackupsResponse, DeleteSnapshotsRequest, ModifyDisksRenewFlagResponse, DeleteAutoSnapshotPoliciesResponse, DescribeDisksResponse, DeleteSnapshotsResponse, ModifyDisksRenewFlagRequest, ModifySnapshotAttributeResponse, ModifyDiskAttributesRequest, GetSnapOverviewRequest, TerminateDisksRequest, DescribeInstancesDiskNumResponse, ResizeDiskRequest, ApplyDiskBackupRequest, ModifyDisksChargeTypeRequest, InitializeDisksRequest, CreateAutoSnapshotPolicyResponse, ModifySnapshotAttributeRequest, UnbindAutoSnapshotPolicyRequest, CreateDiskBackupResponse, InquirePriceModifyDiskBackupQuotaResponse, DeleteAutoSnapshotPoliciesRequest, DescribeSnapshotOverviewRequest, InquiryPriceCreateDisksRequest, DescribeSnapshotsResponse, CreateDisksResponse, AttachDisksResponse, CreateDiskBackupRequest, BindAutoSnapshotPolicyResponse, DescribeDisksRequest, DetachDisksResponse, InquiryPriceRenewDisksResponse, DescribeDiskStoragePoolResponse, ModifyDiskExtraPerformanceResponse, InquirePriceModifyDiskExtraPerformanceRequest, InquiryPriceResizeDiskRequest, DescribeDiskConfigQuotaRequest, DescribeDiskAssociatedAutoSnapshotPolicyResponse, GetSnapOverviewResponse, CopySnapshotCrossRegionsRequest, RenewDiskResponse, DescribeAutoSnapshotPoliciesResponse, UnbindAutoSnapshotPolicyResponse, CreateAutoSnapshotPolicyRequest, ApplySnapshotRequest } from "./cbs_models";
2
+ import { ModifyDiskExtraPerformanceRequest, ModifyDiskAttributesResponse, DescribeDiskBackupsRequest, CreateSnapshotGroupRequest, ModifySnapshotsSharePermissionRequest, CopySnapshotCrossRegionsResponse, DescribeSnapshotGroupsRequest, ModifyDiskBackupQuotaRequest, InquiryPriceCreateDisksResponse, BindAutoSnapshotPolicyRequest, CreateSnapshotResponse, DescribeAutoSnapshotPoliciesRequest, ModifySnapshotsSharePermissionResponse, DeleteDiskBackupsRequest, InitializeDisksResponse, DescribeDiskStoragePoolRequest, DescribeDiskBackupsResponse, RenewDiskRequest, InquirePriceModifyDiskExtraPerformanceResponse, CreateDisksRequest, AttachDisksRequest, DescribeDiskAssociatedAutoSnapshotPolicyRequest, DescribeSnapshotsRequest, ModifyAutoSnapshotPolicyAttributeRequest, DescribeDiskConfigQuotaResponse, ApplyDiskBackupResponse, InquiryPriceResizeDiskResponse, ResizeDiskResponse, TerminateDisksResponse, ApplySnapshotResponse, DetachDisksRequest, DescribeSnapshotGroupsResponse, DescribeSnapshotOverviewResponse, ModifyDisksChargeTypeResponse, CreateSnapshotRequest, DescribeInstancesDiskNumRequest, DescribeSnapshotSharePermissionResponse, ModifyDiskBackupQuotaResponse, InquiryPriceRenewDisksRequest, DescribeSnapshotSharePermissionRequest, InquirePriceModifyDiskBackupQuotaRequest, DeleteDiskBackupsResponse, DeleteSnapshotsRequest, ModifyDisksRenewFlagResponse, DeleteAutoSnapshotPoliciesResponse, DescribeDisksResponse, DeleteSnapshotsResponse, ModifyDisksRenewFlagRequest, ModifySnapshotAttributeResponse, ModifyDiskAttributesRequest, GetSnapOverviewRequest, ModifyAutoSnapshotPolicyAttributeResponse, TerminateDisksRequest, DescribeInstancesDiskNumResponse, ResizeDiskRequest, ApplyDiskBackupRequest, ModifyDisksChargeTypeRequest, InitializeDisksRequest, CreateAutoSnapshotPolicyResponse, ModifySnapshotAttributeRequest, UnbindAutoSnapshotPolicyRequest, CreateDiskBackupResponse, InquirePriceModifyDiskBackupQuotaResponse, DeleteAutoSnapshotPoliciesRequest, DeleteSnapshotGroupResponse, ApplySnapshotGroupResponse, DescribeSnapshotOverviewRequest, InquiryPriceCreateDisksRequest, DescribeSnapshotsResponse, CreateDisksResponse, AttachDisksResponse, CreateDiskBackupRequest, DeleteSnapshotGroupRequest, BindAutoSnapshotPolicyResponse, DescribeDisksRequest, DetachDisksResponse, InquiryPriceRenewDisksResponse, DescribeDiskStoragePoolResponse, ModifyDiskExtraPerformanceResponse, InquirePriceModifyDiskExtraPerformanceRequest, InquiryPriceResizeDiskRequest, DescribeDiskConfigQuotaRequest, DescribeDiskAssociatedAutoSnapshotPolicyResponse, ApplySnapshotGroupRequest, GetSnapOverviewResponse, CopySnapshotCrossRegionsRequest, RenewDiskResponse, DescribeAutoSnapshotPoliciesResponse, UnbindAutoSnapshotPolicyResponse, CreateAutoSnapshotPolicyRequest, CreateSnapshotGroupResponse, ApplySnapshotRequest } from "./cbs_models";
3
3
  /**
4
4
  * cbs client
5
5
  * @class
@@ -67,9 +67,17 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
67
67
  */
68
68
  ModifyDisksRenewFlag(req: ModifyDisksRenewFlagRequest, cb?: (error: string, rep: ModifyDisksRenewFlagResponse) => void): Promise<ModifyDisksRenewFlagResponse>;
69
69
  /**
70
- * 本接口(InquirePricePriceModifyDiskBackupQuota)用于修改云硬盘备份点配额询价。
70
+ * 本接口(CreateSnapshotGroup)用于创建快照组。
71
+ * 创建快照组的云硬盘列表必须挂载在同一实例上;
72
+ * 可选择挂载在实例上的全部或部分盘创建快照组。
71
73
  */
72
- InquirePriceModifyDiskBackupQuota(req: InquirePriceModifyDiskBackupQuotaRequest, cb?: (error: string, rep: InquirePriceModifyDiskBackupQuotaResponse) => void): Promise<InquirePriceModifyDiskBackupQuotaResponse>;
74
+ CreateSnapshotGroup(req: CreateSnapshotGroupRequest, cb?: (error: string, rep: CreateSnapshotGroupResponse) => void): Promise<CreateSnapshotGroupResponse>;
75
+ /**
76
+ * 本接口(DeleteSnapshotGroup)用于删除快照组,一次调用仅支持删除一个快照组。
77
+ * 默认会删除快照组内的所有快照;
78
+ * 如果快照组内的快照有关联镜像,则删除失败,所有快照均不会删除;如果需要同时删除快照绑定的镜像,可传入参数DeleteBindImages等于true。
79
+ */
80
+ DeleteSnapshotGroup(req: DeleteSnapshotGroupRequest, cb?: (error: string, rep: DeleteSnapshotGroupResponse) => void): Promise<DeleteSnapshotGroupResponse>;
73
81
  /**
74
82
  * 批量删除指定的云硬盘备份点。
75
83
  */
@@ -94,6 +102,13 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
94
102
  如果参数为空,返回当前用户一定数量(Limit所指定的数量,默认为20)的备份点列表。
95
103
  */
96
104
  DescribeDiskBackups(req: DescribeDiskBackupsRequest, cb?: (error: string, rep: DescribeDiskBackupsResponse) => void): Promise<DescribeDiskBackupsResponse>;
105
+ /**
106
+ * 本接口(ApplySnapshotGroup)用于回滚快照组,将实例恢复到创建快照组时刻的状态。
107
+ * 1.可选择快照组全部或部分盘进行回滚;
108
+ * 2.如果回滚的盘中包含已挂载的盘,要求这些盘必须挂载在同一实例上,且要求该实例已关机才能回滚;
109
+ * 3.回滚为异步操作,接口返回成功不代表回滚成功,可通过调DescribeSnapshotGroups接口查询快照组的状态。
110
+ */
111
+ ApplySnapshotGroup(req: ApplySnapshotGroupRequest, cb?: (error: string, rep: ApplySnapshotGroupResponse) => void): Promise<ApplySnapshotGroupResponse>;
97
112
  /**
98
113
  * 本接口(DeleteAutoSnapshotPolicies)用于删除定期快照策略。
99
114
 
@@ -115,6 +130,12 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
115
130
  * 如果参数为空,返回当前用户一定数量(`Limit`所指定的数量,默认为20)的云硬盘列表。
116
131
  */
117
132
  DescribeDisks(req: DescribeDisksRequest, cb?: (error: string, rep: DescribeDisksResponse) => void): Promise<DescribeDisksResponse>;
133
+ /**
134
+ * 本接口(DescribeSnapshotGroups)用于查询快照组列表。
135
+ * 可以根据快照组ID、快照组状态、快照组关联的快照ID等来查询快照组列表,不同条件之间为与(AND)的关系,过滤信息详细请见过滤器`Filter`。
136
+ * 如果参数为空,返回当前用户一定数量(`Limit`所指定的数量,默认为20)的快照组列表。
137
+ */
138
+ DescribeSnapshotGroups(req: DescribeSnapshotGroupsRequest, cb?: (error: string, rep: DescribeSnapshotGroupsResponse) => void): Promise<DescribeSnapshotGroupsResponse>;
118
139
  /**
119
140
  * 此接口 (ModifyDiskBackupQuota) 用于修改云硬盘备份点配额。
120
141
  */
@@ -221,6 +242,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
221
242
  * 如果是弹性云盘,则云盘必须处于未挂载状态,云硬盘挂载状态可以通过[DescribeDisks](/document/product/362/16315)接口查询,见Attached字段解释;如果是随实例一起购买的非弹性云盘,则实例必须处于关机状态,实例状态可以通过[DescribeInstancesStatus](/document/product/213/15738)接口查询。
222
243
  */
223
244
  ApplySnapshot(req: ApplySnapshotRequest, cb?: (error: string, rep: ApplySnapshotResponse) => void): Promise<ApplySnapshotResponse>;
245
+ /**
246
+ * 本接口(InquirePricePriceModifyDiskBackupQuota)用于修改云硬盘备份点配额询价。
247
+ */
248
+ InquirePriceModifyDiskBackupQuota(req: InquirePriceModifyDiskBackupQuotaRequest, cb?: (error: string, rep: InquirePriceModifyDiskBackupQuotaResponse) => void): Promise<InquirePriceModifyDiskBackupQuotaResponse>;
224
249
  /**
225
250
  * 本接口(ModifySnapshotsSharePermission)用于修改快照分享信息。
226
251
 
@@ -108,10 +108,20 @@ class Client extends TencentCloudCommon.AbstractClient {
108
108
  return this.request("ModifyDisksRenewFlag", req, cb);
109
109
  }
110
110
  /**
111
- * 本接口(InquirePricePriceModifyDiskBackupQuota)用于修改云硬盘备份点配额询价。
111
+ * 本接口(CreateSnapshotGroup)用于创建快照组。
112
+ * 创建快照组的云硬盘列表必须挂载在同一实例上;
113
+ * 可选择挂载在实例上的全部或部分盘创建快照组。
112
114
  */
113
- async InquirePriceModifyDiskBackupQuota(req, cb) {
114
- return this.request("InquirePriceModifyDiskBackupQuota", req, cb);
115
+ async CreateSnapshotGroup(req, cb) {
116
+ return this.request("CreateSnapshotGroup", req, cb);
117
+ }
118
+ /**
119
+ * 本接口(DeleteSnapshotGroup)用于删除快照组,一次调用仅支持删除一个快照组。
120
+ * 默认会删除快照组内的所有快照;
121
+ * 如果快照组内的快照有关联镜像,则删除失败,所有快照均不会删除;如果需要同时删除快照绑定的镜像,可传入参数DeleteBindImages等于true。
122
+ */
123
+ async DeleteSnapshotGroup(req, cb) {
124
+ return this.request("DeleteSnapshotGroup", req, cb);
115
125
  }
116
126
  /**
117
127
  * 批量删除指定的云硬盘备份点。
@@ -145,6 +155,15 @@ class Client extends TencentCloudCommon.AbstractClient {
145
155
  async DescribeDiskBackups(req, cb) {
146
156
  return this.request("DescribeDiskBackups", req, cb);
147
157
  }
158
+ /**
159
+ * 本接口(ApplySnapshotGroup)用于回滚快照组,将实例恢复到创建快照组时刻的状态。
160
+ * 1.可选择快照组全部或部分盘进行回滚;
161
+ * 2.如果回滚的盘中包含已挂载的盘,要求这些盘必须挂载在同一实例上,且要求该实例已关机才能回滚;
162
+ * 3.回滚为异步操作,接口返回成功不代表回滚成功,可通过调DescribeSnapshotGroups接口查询快照组的状态。
163
+ */
164
+ async ApplySnapshotGroup(req, cb) {
165
+ return this.request("ApplySnapshotGroup", req, cb);
166
+ }
148
167
  /**
149
168
  * 本接口(DeleteAutoSnapshotPolicies)用于删除定期快照策略。
150
169
 
@@ -172,6 +191,14 @@ class Client extends TencentCloudCommon.AbstractClient {
172
191
  async DescribeDisks(req, cb) {
173
192
  return this.request("DescribeDisks", req, cb);
174
193
  }
194
+ /**
195
+ * 本接口(DescribeSnapshotGroups)用于查询快照组列表。
196
+ * 可以根据快照组ID、快照组状态、快照组关联的快照ID等来查询快照组列表,不同条件之间为与(AND)的关系,过滤信息详细请见过滤器`Filter`。
197
+ * 如果参数为空,返回当前用户一定数量(`Limit`所指定的数量,默认为20)的快照组列表。
198
+ */
199
+ async DescribeSnapshotGroups(req, cb) {
200
+ return this.request("DescribeSnapshotGroups", req, cb);
201
+ }
175
202
  /**
176
203
  * 此接口 (ModifyDiskBackupQuota) 用于修改云硬盘备份点配额。
177
204
  */
@@ -312,6 +339,12 @@ class Client extends TencentCloudCommon.AbstractClient {
312
339
  async ApplySnapshot(req, cb) {
313
340
  return this.request("ApplySnapshot", req, cb);
314
341
  }
342
+ /**
343
+ * 本接口(InquirePricePriceModifyDiskBackupQuota)用于修改云硬盘备份点配额询价。
344
+ */
345
+ async InquirePriceModifyDiskBackupQuota(req, cb) {
346
+ return this.request("InquirePriceModifyDiskBackupQuota", req, cb);
347
+ }
315
348
  /**
316
349
  * 本接口(ModifySnapshotsSharePermission)用于修改快照分享信息。
317
350
 
@@ -49,6 +49,23 @@ export interface DescribeDiskBackupsRequest {
49
49
  */
50
50
  OrderField?: string;
51
51
  }
52
+ /**
53
+ * CreateSnapshotGroup请求参数结构体
54
+ */
55
+ export interface CreateSnapshotGroupRequest {
56
+ /**
57
+ * 需要创建快照组的云硬盘ID列表,必须选择挂载在同一实例上的盘列表。
58
+ */
59
+ DiskIds: Array<string>;
60
+ /**
61
+ * 快照组名称,快照组关联的快照也会继承快照组的名称。例如:快照组名称为testSnapshotGroup,快照组关联两个快照,则两个快照的名称分别为testSnapshotGroup_0,testSnapshotGroup_1。
62
+ */
63
+ SnapshotGroupName?: string;
64
+ /**
65
+ * 快照组需要绑定的标签列表。
66
+ */
67
+ Tags?: Array<Tag>;
68
+ }
52
69
  /**
53
70
  * 描述了定期快照策略的详细信息
54
71
  */
@@ -228,13 +245,21 @@ export interface CopySnapshotCrossRegionsResponse {
228
245
  RequestId?: string;
229
246
  }
230
247
  /**
231
- * ModifyAutoSnapshotPolicyAttribute返回参数结构体
248
+ * DescribeSnapshotGroups请求参数结构体
232
249
  */
233
- export interface ModifyAutoSnapshotPolicyAttributeResponse {
250
+ export interface DescribeSnapshotGroupsRequest {
234
251
  /**
235
- * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
252
+ * 过滤条件。<br><li>snapshot-group-id - Array of String - 是否必填:否 -(过滤条件)按快照组ID过滤 <br><li>snapshot-group-state - Array of String - 是否必填:否 -(过滤条件)按快照组状态过滤。(NORMAL: 正常 | CREATING:创建中 | ROLLBACKING:回滚中) <br><li>snapshot-group-name - Array of String - 是否必填:否 -(过滤条件)按快照组名称过滤 <br><li>snapshot-id - Array of String - 是否必填:否 -(过滤条件)按快照组内的快照ID过滤
236
253
  */
237
- RequestId?: string;
254
+ Filters?: Array<Filter>;
255
+ /**
256
+ * 偏移量,默认为0。
257
+ */
258
+ Offset?: number;
259
+ /**
260
+ * 返回数量,默认为20,最大值为100。
261
+ */
262
+ Limit?: number;
238
263
  }
239
264
  /**
240
265
  * ModifyDiskBackupQuota请求参数结构体
@@ -908,6 +933,23 @@ export interface DetachDisksRequest {
908
933
  */
909
934
  InstanceId?: string;
910
935
  }
936
+ /**
937
+ * DescribeSnapshotGroups返回参数结构体
938
+ */
939
+ export interface DescribeSnapshotGroupsResponse {
940
+ /**
941
+ * 符合条件的总数量。
942
+ */
943
+ TotalCount?: number;
944
+ /**
945
+ * 快照组列表详情。
946
+ */
947
+ SnapshotGroupSet?: Array<SnapshotGroup>;
948
+ /**
949
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
950
+ */
951
+ RequestId?: string;
952
+ }
911
953
  /**
912
954
  * DescribeSnapshotOverview返回参数结构体
913
955
  */
@@ -1220,6 +1262,15 @@ export interface Image {
1220
1262
  */
1221
1263
  ImageId?: string;
1222
1264
  }
1265
+ /**
1266
+ * ModifyAutoSnapshotPolicyAttribute返回参数结构体
1267
+ */
1268
+ export interface ModifyAutoSnapshotPolicyAttributeResponse {
1269
+ /**
1270
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1271
+ */
1272
+ RequestId?: string;
1273
+ }
1223
1274
  /**
1224
1275
  * TerminateDisks请求参数结构体
1225
1276
  */
@@ -1269,9 +1320,9 @@ export interface ResizeDiskRequest {
1269
1320
  */
1270
1321
  DiskSize: number;
1271
1322
  /**
1272
- * 云硬盘ID, 通过[DescribeDisks](/document/product/362/16315)接口查询。
1323
+ * 云硬盘ID, 通过[DescribeDisks](/document/product/362/16315)接口查询。该字段仅供单块云硬盘扩容时传入。
1273
1324
  */
1274
- DiskId: string;
1325
+ DiskId?: string;
1275
1326
  }
1276
1327
  /**
1277
1328
  * ApplyDiskBackup请求参数结构体
@@ -1481,6 +1532,24 @@ export interface DiskChargePrepaid {
1481
1532
  */
1482
1533
  CurInstanceDeadline?: string;
1483
1534
  }
1535
+ /**
1536
+ * DeleteSnapshotGroup返回参数结构体
1537
+ */
1538
+ export interface DeleteSnapshotGroupResponse {
1539
+ /**
1540
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1541
+ */
1542
+ RequestId?: string;
1543
+ }
1544
+ /**
1545
+ * ApplySnapshotGroup返回参数结构体
1546
+ */
1547
+ export interface ApplySnapshotGroupResponse {
1548
+ /**
1549
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
1550
+ */
1551
+ RequestId?: string;
1552
+ }
1484
1553
  /**
1485
1554
  * DescribeSnapshotOverview请求参数结构体
1486
1555
  */
@@ -1698,6 +1767,81 @@ export interface CreateDiskBackupRequest {
1698
1767
  */
1699
1768
  DiskBackupName?: string;
1700
1769
  }
1770
+ /**
1771
+ * DeleteSnapshotGroup请求参数结构体
1772
+ */
1773
+ export interface DeleteSnapshotGroupRequest {
1774
+ /**
1775
+ * 快照组ID。
1776
+ */
1777
+ SnapshotGroupId?: string;
1778
+ /**
1779
+ * 快照组ID 列表。此参数与快照组 ID 至少传 1 个,同时传会与快照组 ID 合并。
1780
+ */
1781
+ SnapshotGroupIds?: Array<string>;
1782
+ /**
1783
+ * 是否同时删除快照组关联的镜像;取值为false,表示不删除快照组绑定的镜像,此时,如果快照组有绑定的镜像,删除会失败;取值为true,表示同时删除快照组绑定的镜像;默认值为false。
1784
+ */
1785
+ DeleteBindImages?: boolean;
1786
+ }
1787
+ /**
1788
+ * 描述快照组详情
1789
+ */
1790
+ export interface SnapshotGroup {
1791
+ /**
1792
+ * 快照组ID。
1793
+ */
1794
+ SnapshotGroupId: string;
1795
+ /**
1796
+ * 快照组类型。NORMAL: 普通快照组,非一致性快照。
1797
+ */
1798
+ SnapshotGroupType: string;
1799
+ /**
1800
+ * 快照组是否包含系统盘快照。
1801
+ */
1802
+ ContainRootSnapshot: boolean;
1803
+ /**
1804
+ * 快照组包含的快照ID列表。
1805
+ */
1806
+ SnapshotIdSet: Array<string>;
1807
+ /**
1808
+ * 快照组状态。<br><li>NORMAL: 正常<br><li>CREATING:创建中<br><li>ROLLBACKING:回滚中
1809
+ */
1810
+ SnapshotGroupState: string;
1811
+ /**
1812
+ * 快照组创建进度。
1813
+ */
1814
+ Percent: number;
1815
+ /**
1816
+ * 快照组创建时间。
1817
+ */
1818
+ CreateTime: string;
1819
+ /**
1820
+ * 快照组最新修改时间
1821
+ */
1822
+ ModifyTime: string;
1823
+ /**
1824
+ * 快照组关联的镜像列表。
1825
+ */
1826
+ Images: Array<Image>;
1827
+ /**
1828
+ * 快照组名称。
1829
+ */
1830
+ SnapshotGroupName: string;
1831
+ /**
1832
+ * 快照组关联的镜像数量。
1833
+ */
1834
+ ImageCount: number;
1835
+ /**
1836
+ * 快照组是否永久保留
1837
+ */
1838
+ IsPermanent: boolean;
1839
+ /**
1840
+ * 快照组到期时间。
1841
+ 注意:此字段可能返回 null,表示取不到有效值。
1842
+ */
1843
+ DeadlineTime: string;
1844
+ }
1701
1845
  /**
1702
1846
  * BindAutoSnapshotPolicy返回参数结构体
1703
1847
  */
@@ -1955,6 +2099,27 @@ export interface DescribeDiskAssociatedAutoSnapshotPolicyResponse {
1955
2099
  */
1956
2100
  RequestId?: string;
1957
2101
  }
2102
+ /**
2103
+ * ApplySnapshotGroup请求参数结构体
2104
+ */
2105
+ export interface ApplySnapshotGroupRequest {
2106
+ /**
2107
+ * 回滚的快照组ID。
2108
+ */
2109
+ SnapshotGroupId: string;
2110
+ /**
2111
+ * 回滚的快照组关联的快照ID,及快照对应的原云硬盘ID列表。
2112
+ */
2113
+ ApplyDisks: Array<ApplyDisk>;
2114
+ /**
2115
+ * 回滚前是否执行自动关机。
2116
+ */
2117
+ AutoStopInstance?: boolean;
2118
+ /**
2119
+ * 回滚完成后是否自动开机。
2120
+ */
2121
+ AutoStartInstance?: boolean;
2122
+ }
1958
2123
  /**
1959
2124
  * GetSnapOverview返回参数结构体
1960
2125
  */
@@ -2143,6 +2308,19 @@ export interface Cdc {
2143
2308
  */
2144
2309
  DiskNumber?: number;
2145
2310
  }
2311
+ /**
2312
+ * 本参数用于快照组回滚接口的入参,表示回滚的云盘、快照列表。
2313
+ */
2314
+ export interface ApplyDisk {
2315
+ /**
2316
+ * 快照组关联的快照ID。
2317
+ */
2318
+ SnapshotId: string;
2319
+ /**
2320
+ * 快照组关联快照对应的原云硬盘ID。
2321
+ */
2322
+ DiskId: string;
2323
+ }
2146
2324
  /**
2147
2325
  * UnbindAutoSnapshotPolicy返回参数结构体
2148
2326
  */
@@ -2198,6 +2376,19 @@ export interface CreateAutoSnapshotPolicyRequest {
2198
2376
  */
2199
2377
  RetentionDays?: number;
2200
2378
  }
2379
+ /**
2380
+ * CreateSnapshotGroup返回参数结构体
2381
+ */
2382
+ export interface CreateSnapshotGroupResponse {
2383
+ /**
2384
+ * 创建成功的快照组ID。
2385
+ */
2386
+ SnapshotGroupId?: string;
2387
+ /**
2388
+ * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
2389
+ */
2390
+ RequestId?: string;
2391
+ }
2201
2392
  /**
2202
2393
  * 描述预付费或后付费云盘的价格。
2203
2394
  */