UNPKG

tencentcloud-sdk-nodejs

Version:
1,949 lines (1,946 loc) 109 kB
/** * AttachRemoteDisks返回参数结构体 */ export interface AttachRemoteDisksResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyRemoteDiskAttributes请求参数结构体 */ export interface ModifyRemoteDiskAttributesRequest { /** * <p>一个或多个待操作的单副本SSD硬盘ID。如果传入多个单副本SSD硬盘ID,只支持所有硬盘修改为同一属性。</p> */ RemoteDiskIds: Array<string>; /** * <p>新的单副本SSD硬盘名称</p> */ DiskName?: string; /** * <p>新的单副本SSD硬盘项目ID。</p> */ ProjectId?: number; /** * <p>云硬盘的自动续费标识</p><p>枚举值:</p><ul><li>NOTIFY_AND_AUTO_RENEW: 通知过期且自动续费</li><li>NOTIFY_AND_MANUAL_RENEW: 通知过期不自动续费</li><li>DISABLE_NOTIFY_AND_MANUAL_RENEW: 不通知过期不自动续费</li></ul> */ AutoRenewFlag?: string; } /** * ModifyDiskExtraPerformance请求参数结构体 */ export interface ModifyDiskExtraPerformanceRequest { /** * 额外购买的云硬盘性能值,单位MiB/s。 */ ThroughputPerformance: number; /** * 需要购买额外性能值的云硬盘ID,可通过[DescribeDisks](/document/product/362/16315)接口查询。仅大小超过460GiB的增强型SSD(CLOUD_HSSD)和极速型SSD(CLOUD_TSSD)云硬盘才支持购买额外性能。 */ DiskId: string; } /** * SwitchParameterCreateRemoteDisks返回参数结构体 */ export interface SwitchParameterCreateRemoteDisksResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDiskAttributes返回参数结构体 */ export interface ModifyDiskAttributesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeDiskBackups请求参数结构体 */ export interface DescribeDiskBackupsRequest { /** * 要查询备份点的ID列表。参数不支持同时指定 DiskBackupIds 和 Filters。 */ DiskBackupIds?: Array<string>; /** * 过滤条件,参数不支持同时指定 DiskBackupIds 和 Filters。过滤条件:<br><li>disk-backup-id - Array of String - 是否必填:否 -(过滤条件)按照备份点的ID过滤。备份点ID形如:dbp-11112222。</li><br><li>disk-id - Array of String - 是否必填:否 -(过滤条件)按照创建备份点的云硬盘ID过滤。云硬盘ID形如:disk-srftydert。</li><br><li>disk-usage - Array of String - 是否必填:否 -(过滤条件)按创建备份点的云硬盘类型过滤。 (SYSTEM_DISK:代表系统盘 | DATA_DISK:代表数据盘。)</li> */ Filters?: Array<Filter>; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考API[简介](/document/product/362/15633)中的相关小节。 */ Offset?: number; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](/document/product/362/15633)中的相关小节。 */ Limit?: number; /** * 输出云硬盘备份点列表的排列顺序,默认排序:ASC。取值范围:<br><li>ASC:升序排列</li><br><li>DESC:降序排列。</li> */ Order?: string; /** * 云硬盘备份点列表排序的依据字段。取值范围:<br><li>CREATE_TIME:依据云硬盘备份点的创建时间排序</li><br>默认按创建时间排序。 */ OrderField?: string; } /** * InquirePriceModifyDiskBackupQuota请求参数结构体 */ export interface InquirePriceModifyDiskBackupQuotaRequest { /** * 云硬盘ID, 通过[DescribeDisks](/document/product/362/16315)接口查询。 */ DiskId: string; /** * 修改后的云硬盘备份点配额,即云盘可以拥有的备份点数量,单位为个。 */ DiskBackupQuota: number; } /** * 描述了定期快照策略的详细信息 */ export interface AutoSnapshotPolicy { /** * 已绑定当前定期快照策略的云盘ID列表。 DescribeDiskAssociatedAutoSnapshotPolicy场景下该字段返回为空。 */ DiskIdSet?: Array<string>; /** * 定期快照策略是否激活。 */ IsActivated?: boolean; /** * 定期快照策略的状态。取值范围: <ul> <li>NORMAL:正常</li> <li>ISOLATED:已隔离</li> </ul> */ AutoSnapshotPolicyState?: string; /** * 是否是跨账号复制快照, 1:是, 0: 不是 */ IsCopyToRemote?: number; /** * 使用该定期快照策略创建出来的快照是否永久保留。 */ IsPermanent?: boolean; /** * 定期快照下次触发的时间。 */ NextTriggerTime?: string; /** * 定期快照策略名称。 */ AutoSnapshotPolicyName?: string; /** * 定期快照策略ID。 */ AutoSnapshotPolicyId?: string; /** * 定期快照的执行策略。 */ Policy?: Array<Policy>; /** * 定期快照策略的创建时间。 */ CreateTime?: string; /** * 使用该定期快照策略创建出来的快照保留天数。 */ RetentionDays?: number; /** * 复制的目标账户ID 注意:此字段可能返回 null,表示取不到有效值。 */ CopyToAccountUin?: string; /** * 已绑定当前定期快照策略的实例ID列表。 */ InstanceIdSet?: Array<string>; /** * 该定期快照创建的快照可以保留的月数。 */ RetentionMonths?: number; /** * 该定期快照创建的快照最大保留数量。 */ RetentionAmount?: number; /** * 定期快照高级保留策略。 注意:此字段可能返回 null,表示取不到有效值。 */ AdvancedRetentionPolicy?: AdvancedRetentionPolicy; /** * 该复制快照策略的源端账户ID 注意:此字段可能返回 null,表示取不到有效值。 */ CopyFromAccountUin?: string; /** * 标签。 */ Tags?: Array<Tag>; } /** * 描述购买云硬盘时的费用明细。 */ export interface DetailPrice { /** * 后付费云硬盘的计价单元,取值范围:HOUR:表示后付费云硬盘的计价单元是按小时计算。 注意:此字段可能返回 null,表示取不到有效值。 */ ChargeUnit?: string; /** * 预付费云硬盘预支费用的折扣价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ DiscountPrice?: number; /** * 高精度预付费云硬盘预支费用的折扣价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ DiscountPriceHigh?: string; /** * 预付费云硬盘预支费用的原价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ OriginalPrice?: number; /** * 高精度预付费云硬盘预支费用的原价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ OriginalPriceHigh?: string; /** * 描述计费项目名称 */ PriceName?: string; /** * 描述计费项目显示名称,用户控制台展示 */ PriceTitle?: string; /** * 后付费云硬盘原单价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ UnitPrice?: number; /** * 后付费云硬盘折扣单价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ UnitPriceDiscount?: number; /** * 高精度后付费云硬盘折扣单价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ UnitPriceDiscountHigh?: string; /** * 高精度后付费云硬盘原单价,单位:元。 注意:此字段可能返回 null,表示取不到有效值。 */ UnitPriceHigh?: string; } /** * ModifySnapshotsSharePermission请求参数结构体 */ export interface ModifySnapshotsSharePermissionRequest { /** * 快照ID, 可通过[DescribeSnapshots](https://cloud.tencent.com/document/api/362/15647)查询获取。 */ SnapshotIds: Array<string>; /** * 接收分享快照的账号Id列表,array型参数的格式可以参考[API简介](https://cloud.tencent.com/document/api/213/568)。账号ID不同于QQ号,查询用户账号ID请查看[账号信息](https://console.cloud.tencent.com/developer)中的账号ID栏。 */ AccountIds: Array<string>; /** * 操作,包括 SHARE,CANCEL。其中SHARE代表分享操作,CANCEL代表取消分享操作。 */ Permission: string; } /** * AttachRemoteDisks请求参数结构体 */ export interface AttachRemoteDisksRequest { /** * <p>指定待挂载单副本SSD硬盘的CVM实例。</p> */ InstanceId: string; /** * <p>一个或多个待挂载的单副本SSD硬盘ID。</p> */ RemoteDiskIds: Array<string>; } /** * CopySnapshotCrossRegions返回参数结构体 */ export interface CopySnapshotCrossRegionsResponse { /** * 快照跨地域复制的结果,如果请求下发成功,则返回相应地地域的新快照ID,否则返回Error。 */ SnapshotCopyResultSet?: Array<SnapshotCopyResult>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeSnapshotGroups请求参数结构体 */ export interface DescribeSnapshotGroupsRequest { /** * 过滤条件。<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过滤 */ Filters?: Array<Filter>; /** * 偏移量,默认为0。 */ Offset?: number; /** * 返回数量,默认为20,最大值为100。 */ Limit?: number; } /** * ModifyDiskBackupQuota请求参数结构体 */ export interface ModifyDiskBackupQuotaRequest { /** * 云硬盘ID。可通过[DescribeDisks](/document/product/362/16315)接口查询。 */ DiskId: string; /** * 调整之后的云硬盘备份点配额。取值范围为1 ~ 1024。 */ DiskBackupQuota: number; } /** * InquiryPriceCreateDisks返回参数结构体 */ export interface InquiryPriceCreateDisksResponse { /** * 描述了新购云盘的价格。 */ DiskPrice?: Price; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * BindAutoSnapshotPolicy请求参数结构体 */ export interface BindAutoSnapshotPolicyRequest { /** * 要绑定的定期快照策略ID,通过[ DescribeAutoSnapshotPolicies](https://cloud.tencent.com/document/api/362/33556)接口查询。 */ AutoSnapshotPolicyId: string; /** * 要绑定的云硬盘ID列表,一次请求最多绑定80块云盘。 */ DiskIds?: Array<string>; } /** * CreateSnapshot返回参数结构体 */ export interface CreateSnapshotResponse { /** * 新创建的快照ID。 注意:此字段可能返回 null,表示取不到有效值。 */ SnapshotId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeAutoSnapshotPolicies请求参数结构体 */ export interface DescribeAutoSnapshotPoliciesRequest { /** * 要查询的定期快照策略ID列表。参数不支持同时指定`AutoSnapshotPolicyIds`和`Filters`。 */ AutoSnapshotPolicyIds?: Array<string>; /** * 过滤条件。参数不支持同时指定`AutoSnapshotPolicyIds`和`Filters`。<br> <li>auto-snapshot-policy-id - Array of String - 是否必填:否 -(过滤条件)按定期快照策略ID进行过滤。定期快照策略ID形如:`asp-3stvwfxx`。</li> <li>auto-snapshot-policy-state - Array of String - 是否必填:否 -(过滤条件)按定期快照策略的状态进行过滤。定期快照策略ID形如:`asp-3stvwfxx`。(NORMAL:正常 | ISOLATED:已隔离。)</li> <li>auto-snapshot-policy-name - Array of String - 是否必填:否 -(过滤条件)按定期快照策略名称进行过滤。</li> */ Filters?: Array<Filter>; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](/document/product/362/15633)中的相关小节。 */ Limit?: number; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考API[简介](/document/product/362/15633)中的相关小节。 */ Offset?: number; /** * 输出定期快照列表的排列顺序。取值范围:<br><li>ASC:升序排列<br></li><li>DESC:降序排列。</li> */ Order?: string; /** * 定期快照列表排序的依据字段。取值范围:<br><li>CREATE_TIME:依据定期快照的创建时间排序,默认按创建时间排序。</li> */ OrderField?: string; } /** * InquirePriceRenewRemoteDisks请求参数结构体 */ export interface InquirePriceRenewRemoteDisksRequest { /** * <p>预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月云盘的购买时长。如果在该参数中指定CurInstanceDeadline,则会按对齐到子机到期时间来续费。如果是批量续费询价,该参数与Disks参数一一对应,元素数量需保持一致。</p> */ DiskChargePrepaidSet: Array<RemoteDiskChargePrepaid>; /** * <p>一个或多个单副本SSD硬盘ID。</p> */ RemoteDiskIds: Array<string>; } /** * TerminateRemoteDisks请求参数结构体 */ export interface TerminateRemoteDisksRequest { /** * <p>一个或多个单副本SSD硬盘ID。</p> */ RemoteDiskIds: Array<string>; } /** * DescribeRemoteDisks请求参数结构体 */ export interface DescribeRemoteDisksRequest { /** * <p>过滤条件。此参数不支持与 RemoteDiskIds 同时指定。</p> */ Filters?: Array<Filter>; } /** * ModifySnapshotsSharePermission返回参数结构体 */ export interface ModifySnapshotsSharePermissionResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeRemoteDisks返回参数结构体 */ export interface DescribeRemoteDisksResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteDiskBackups请求参数结构体 */ export interface DeleteDiskBackupsRequest { /** * 待删除的云硬盘备份点ID,可以通过[DescribeDiskBackups](/document/product/362/80278)接口查询。 */ DiskBackupIds: Array<string>; } /** * DescribeRemoteDiskConfigQuota返回参数结构体 */ export interface DescribeRemoteDiskConfigQuotaResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InitializeDisks返回参数结构体 */ export interface InitializeDisksResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeDiskStoragePool请求参数结构体 */ export interface DescribeDiskStoragePoolRequest { /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](/document/product/362/15633)中的相关小节。 */ Limit?: number; /** * 指定需要查询的独享集群ID列表,该入参不能与Filters一起使用。 */ CdcIds?: Array<string>; /** * 过滤条件。参数不支持同时指定`CdcIds`和`Filters`。<br><li>cdc-id - Array of String - 是否必填:否 -(过滤条件)按独享集群ID过滤。<br><li>zone - Array of String - 是否必填:否 -(过滤条件)按独享集群所在[可用区](/document/product/213/15753#ZoneInfo)过滤。<br><li>cage-id - Array of String - 是否必填:否 -(过滤条件)按独享集群所在围笼的ID过滤。<br><li>disk-type - Array of String - 是否必填:否 -(过滤条件)按照云盘介质类型过滤。(CLOUD_BASIC:表示普通云硬盘 | CLOUD_PREMIUM:表示高性能云硬盘。| CLOUD_SSD:SSD表示SSD云硬盘。) */ Filters?: Array<Filter>; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考API[简介](/document/product/362/15633)中的相关小节。 */ Offset?: number; } /** * DescribeDiskBackups返回参数结构体 */ export interface DescribeDiskBackupsResponse { /** * 符合条件的云硬盘备份点数量。 */ TotalCount?: number; /** * 云硬盘备份点的详细信息列表。 */ DiskBackupSet?: Array<DiskBackup>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述快照跨地域复制的结果。 */ export interface SnapshotCopyResult { /** * 复制到目标地域的新快照ID。 */ SnapshotId?: string; /** * 指示具体错误信息,成功时为空字符串。 */ Message?: string; /** * 错误码,成功时取值为“Success”。 */ Code?: string; /** * 跨地复制的目标地域。 */ DestinationRegion?: string; } /** * RenewDisk请求参数结构体 */ export interface RenewDiskRequest { /** * <p>预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月云硬盘的续费时长。<br>在云硬盘与挂载的实例一起续费的场景下,可以指定参数CurInstanceDeadline,此时云硬盘会按对齐到实例续费后的到期时间来续费。</p> */ DiskChargePrepaid: DiskChargePrepaid; /** * <p>云硬盘ID, 通过<a href="/document/product/362/16315">DescribeDisks</a>接口查询。</p> */ DiskId: string; } /** * DescribeRemoteDisksDeniedActions请求参数结构体 */ export interface DescribeRemoteDisksDeniedActionsRequest { /** * <p>单副本SSD硬盘ID列表。每次批量请求单副本SSD硬盘的上限为 100。</p> */ RemoteDiskIds: Array<string>; } /** * InquirePriceModifyDiskExtraPerformance返回参数结构体 */ export interface InquirePriceModifyDiskExtraPerformanceResponse { /** * 描述了调整云盘额外性能时对应的价格。 */ DiskPrice?: Price; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 定期快照高级保留策略,四个参数都为必选参数 */ export interface AdvancedRetentionPolicy { /** * 保留最新快照Days天内的每天最新的一个快照,取值范围:[0, 100] */ Days: number; /** * 保留最新快照Weeks周内的每周最新的一个快照,取值范围:[0, 100] */ Weeks: number; /** * 保留最新快照Months月内的每月最新的一个快照, 取值范围:[0, 100] */ Months: number; /** * 保留最新快照Years年内的每年最新的一个快照,取值范围:[0, 100] */ Years: number; } /** * CreateDisks请求参数结构体 */ export interface CreateDisksRequest { /** * 实例所在的位置。通过该参数可以指定实例所属可用区,所属项目。若不指定项目,将在默认项目下进行创建。 */ Placement: Placement; /** * 云硬盘计费类型。<br><li>PREPAID:预付费,即包年包月</li><br><li>POSTPAID_BY_HOUR:按小时后付费</li><br><li>CDCPAID:独享集群付费<br>各类型价格请参考云硬盘[价格总览](/document/product/362/2413)。</li> */ DiskChargeType: string; /** * 硬盘介质类型。取值范围:<br><li>CLOUD_PREMIUM:表示高性能云硬盘</li><br><li>CLOUD_BSSD:表示通用型SSD云硬盘</li><br><li>CLOUD_SSD:表示SSD云硬盘</li><br><li>CLOUD_HSSD:表示增强型SSD云硬盘</li><br><li>CLOUD_TSSD:表示极速型SSD云硬盘。</li>极速型SSD云硬盘(CLOUD_TSSD)仅支持随部分实例类型一同购买,暂不支持单独创建。 */ DiskType: string; /** * 云盘显示名称。不传则默认为“未命名”。最大长度不能超60个字节。 */ DiskName?: string; /** * 云盘绑定的标签。 */ Tags?: Array<Tag>; /** * 快照ID,如果传入则根据此快照创建云硬盘,快照类型必须为数据盘快照,可通过[DescribeSnapshots](/document/product/362/15647)接口查询快照,见输出参数DiskUsage解释。 */ SnapshotId?: string; /** * 创建云硬盘数量,不传则默认为1。单次请求最多可创建的云盘数有限制,具体参见[云硬盘使用限制](https://cloud.tencent.com/doc/product/362/5145)。 */ DiskCount?: number; /** * 使用此参数可给云硬盘购买额外的性能,单位MB/s。<br>当前仅支持极速型云盘(CLOUD_TSSD)和增强型SSD云硬盘(CLOUD_HSSD)。 */ ThroughputPerformance?: number; /** * 购买加密盘时自定义密钥,当传入该参数时,Encrypt参数不得为空。 */ KmsKeyId?: string; /** * 云硬盘大小,单位为GiB。<br><li>如果传入`SnapshotId`则可不传`DiskSize`,此时新建云盘的大小为快照大小</li><br><li>如果传入`SnapshotId`同时传入`DiskSize`,则云盘大小必须大于或等于快照大小</li><br><li>云盘大小取值范围参见云硬盘[产品分类](/document/product/362/2353)的说明。</li> */ DiskSize?: number; /** * 传入True时,云盘将创建为共享型云盘,默认为False。因共享型云盘不支持加密,此参数与Encrypt参数不可同时传入。 */ Shareable?: boolean; /** * 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 */ ClientToken?: string; /** * 传入该参数用于创建加密云盘,取值固定为ENCRYPT。因共享型云盘不支持加密,此参数与Shareable参数不可同时传入。 */ Encrypt?: string; /** * 预付费模式,即包年包月相关参数设置。通过该参数指定包年包月云盘的购买时长、是否设置自动续费等属性。<br>创建预付费云盘该参数必传,创建按小时后付费云盘无需传该参数。 */ DiskChargePrepaid?: DiskChargePrepaid; /** * 销毁云盘时删除关联的非永久保留快照。0 表示非永久快照不随云盘销毁而销毁,1表示非永久快照随云盘销毁而销毁,默认取0。快照是否永久保留可以通过[DescribeSnapshots](/document/api/362/15647)接口返回的快照详情的IsPermanent字段来判断,True表示永久快照,False表示非永久快照。 */ DeleteSnapshot?: number; /** * 创建云盘时指定自动挂载并初始化该数据盘。因加密盘不支持自动挂载及初始化,此参数与Encrypt参数不可同时传入。 */ AutoMountConfiguration?: AutoMountConfiguration; /** * 指定云硬盘备份点配额。 */ DiskBackupQuota?: number; /** * 创建云盘时是否开启性能突发。当前仅支持极速型云盘(CLOUD_TSSD)和增强型SSD云硬盘(CLOUD_HSSD)且云盘大小不小于460GiB。 */ BurstPerformance?: boolean; /** * 指定云硬盘加密类型,取值为ENCRYPT_V1和ENCRYPT_V2,分别表示第一代和第二代加密技术,两种加密技术互不兼容。推荐优先使用第二代加密技术ENCRYPT_V2,第一代加密技术仅支持在部分老旧机型使用。该参数仅当创建加密云硬盘时有效。 */ EncryptType?: string; } /** * AttachDisks请求参数结构体 */ export interface AttachDisksRequest { /** * 云服务器实例ID。云盘将被挂载到此云服务器上,通过[DescribeInstances](/document/product/213/15728)接口查询。 */ InstanceId: string; /** * 将要被挂载的弹性云盘ID。通过[DescribeDisks](/document/product/362/16315)接口查询。单次最多可挂载10块弹性云盘。 */ DiskIds: Array<string>; /** * 可选参数,不传该参数则仅执行挂载操作。传入`True`时,会在挂载成功后将云硬盘设置为随云主机销毁模式,仅对按量计费云硬盘有效。 */ DeleteWithInstance?: boolean; /** * 可选参数,用于控制云盘挂载时使用的挂载模式,目前仅对黑石裸金属机型有效。取值范围:<br><li>PF</li><br><li>VF</li> */ AttachMode?: string; } /** * DescribeDiskAssociatedAutoSnapshotPolicy请求参数结构体 */ export interface DescribeDiskAssociatedAutoSnapshotPolicyRequest { /** * 要查询的云硬盘ID,通过[DescribeDisks](https://cloud.tencent.com/document/api/362/16315)接口查询。 */ DiskId: string; } /** * DescribeSnapshots请求参数结构体 */ export interface DescribeSnapshotsRequest { /** * 要查询快照的ID列表。参数不支持同时指定`SnapshotIds`和`Filters`。 */ SnapshotIds?: Array<string>; /** * 过滤条件。参数不支持同时指定SnapshotIds和Filters。<br><ul><li>snapshot-id<ul><li>按照云硬盘快照ID进行过滤</li><li>类型:String</li><li>必选:否</li></ul></li><li>snapshot-name<ul><li>按照云硬盘快照名称进行过滤</li><li>类型:String</li><li>必选:否</li></ul></li><li>snapshot-state<ul><li>按照云硬盘快照状态进行过滤</li><li>类型:String</li><li>必选:否</li><li>取值范围:<ul><li><code>NORMAL</code>:正常 </li><li><code>CREATING</code>:创建中 </li><li><code>ROLLBACKING</code>:回滚中 </li><li><code>COPYING_FROM_REMOTE</code>:跨地域复制中 </li><li><code>CHECKING_COPIED</code>:复制校验中</li><li><code>TORECYCLE</code>:待回收</li></ul></li></ul></li><li>disk-usage<ul><li>按照云硬盘使用用途进行过滤</li><li>类型:String</li><li>必选:否</li><li>取值范围:<ul><li><code>SYSTEM_DISK</code>:代表系统盘</li><li><code>DATA_DISK</code>:代表数据盘</li></ul></li></ul></li><li>project-id<ul><li>按云硬盘所属项目ID过滤</li><li>类型:String</li><li>必选:否</li></ul></li><li>disk-id<ul><li>按照云硬盘ID进行过滤,一次最多只能传入10个值</li><li>类型:String</li><li>必选:否</li></ul></li><li>encrypt<ul><li>按是否加密进行过滤</li><li>类型:String</li><li>必选:否</li></ul></li><li>snapshot-type<ul><li>按快照归属类型查询</li><li>类型:String</li><li>必选:否</li><li>取值范围:<ul><li><code>SHARED_SNAPSHOT</code>:表示共享过来的快照</li><li><code>PRIVATE_SNAPSHOT</code>:表示自己的私有快照</li></ul></li></ul></li></ul> */ Filters?: Array<Filter>; /** * 返回数量,默认为20,最大值为100。关于`Limit`的更进一步介绍请参考 API [简介](/document/product/362/15633)中的相关小节。 */ Limit?: number; /** * 快照列表排序的依据字段。取值范围: <ul> <li>CREATE_TIME:依据快照的创建时间排序</li> <li>默认按创建时间排序</li> </ul> */ OrderField?: string; /** * 偏移量,默认为0。关于`Offset`的更进一步介绍请参考API[简介](/document/product/362/15633)中的相关小节。 */ Offset?: number; /** * 输出云盘列表的排列顺序。取值范围: <ul> <li>ASC:升序排列</li> <li>DESC:降序排列。</li> </ul> */ Order?: string; } /** * ModifyAutoSnapshotPolicyAttribute请求参数结构体 */ export interface ModifyAutoSnapshotPolicyAttributeRequest { /** * 定期快照策略ID。可以通过[查询定期快照策略](https://cloud.tencent.com/document/product/362/33556)API查询。 */ AutoSnapshotPolicyId: string; /** * 是否激活定期快照策略,`false`表示未激活,`true`表示激活;默认为`true`。 */ IsActivated?: boolean; /** * 通过该定期快照策略创建的快照是否永久保留。`false`表示非永久保留,`true`表示永久保留,默认为`false`。 */ IsPermanent?: boolean; /** * 要创建的定期快照策略名。不传则默认为“未命名”。最大长度不能超60个字节。 */ AutoSnapshotPolicyName?: string; /** * 定期快照的执行策略。 */ Policy?: Array<Policy>; /** * 通过该定期快照策略创建的快照保留天数。如果指定本参数,则IsPermanent入参不可指定为TRUE,否则会产生冲突。 */ RetentionDays?: number; } /** * DescribeDiskConfigQuota返回参数结构体 */ export interface DescribeDiskConfigQuotaResponse { /** * 云盘配置列表。 */ DiskConfigSet?: Array<DiskConfig>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * SwitchParameterCreateRemoteDisks请求参数结构体 */ export interface SwitchParameterCreateRemoteDisksRequest { /** * <p>实例所在的位置。通过该参数可以指定实例所属可用区、所属项目等属性。</p> */ Placement: Placement; } /** * ApplyDiskBackup返回参数结构体 */ export interface ApplyDiskBackupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InquiryPriceResizeDisk返回参数结构体 */ export interface InquiryPriceResizeDiskResponse { /** * 描述了扩容云盘的价格。 */ DiskPrice?: PrepayPrice; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 标签。 */ export interface Tag { /** * 标签健。 */ Key: string; /** * 标签值。 */ Value: string; } /** * ResizeDisk返回参数结构体 */ export interface ResizeDiskResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了云硬盘的详细信息 */ export interface Disk { /** * 云盘是否与挂载的实例一起销毁。<br><li>true:销毁实例时会同时销毁云盘,只支持按小时后付费云盘。</li><li>false:销毁实例时不销毁云盘。</li> */ DeleteWithInstance?: boolean; /** * 自动续费标识。取值范围:<br><li>NOTIFY_AND_AUTO_RENEW:通知过期且自动续费</li><li>NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费</li><li>DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费。</li> */ RenewFlag?: string; /** * 硬盘介质类型。取值范围:<br><li>CLOUD_BASIC:表示普通云硬盘</li><li>CLOUD_PREMIUM:表示高性能云硬盘</li><li>CLOUD_BSSD:表示通用型SSD云硬盘</li><li>CLOUD_SSD:表示SSD云硬盘</li><li>CLOUD_HSSD:表示增强型SSD云硬盘</li><li>CLOUD_TSSD:表示极速型SSD云硬盘。</li> */ DiskType?: string; /** * 云盘状态。取值范围:<br><li>UNATTACHED:未挂载</li><li>ATTACHING:挂载中</li><li>ATTACHED:已挂载</li><li>DETACHING:解挂中</li><li>EXPANDING:扩容中</li><li>ROLLBACKING:回滚中</li><li>TORECYCLE:待回收</li><li>DUMPING:拷贝硬盘中。</li> */ DiskState?: string; /** * 云盘拥有的快照总数。 */ SnapshotCount?: number; /** * 云盘已挂载到子机,且子机与云盘都是包年包月。<br><li>true:子机设置了自动续费标识,但云盘未设置</li><li>false:云盘自动续费标识正常。</li> */ AutoRenewFlagError?: boolean; /** * 云盘是否处于快照回滚状态。取值范围:<br><li>false:表示不处于快照回滚状态</li><li>true:表示处于快照回滚状态。</li> */ Rollbacking?: boolean; /** * 对于非共享型云盘,该参数为空数组。对于共享型云盘,则表示该云盘当前被挂载到的CVM实例InstanceId */ InstanceIdList?: Array<string>; /** * 云盘是否为加密盘。取值范围:<br><li>false:表示非加密盘</li><li>true:表示加密盘。</li> */ Encrypt?: boolean; /** * 云硬盘名称。 */ DiskName?: string; /** * 云硬盘因欠费销毁或者到期销毁时, 是否使用快照备份数据的标识。true表示销毁时创建快照进行数据备份。false表示直接销毁,不进行数据备份。 */ BackupDisk?: boolean; /** * 与云盘绑定的标签,云盘未绑定标签则取值为空。 */ Tags?: Array<Tag>; /** * 云硬盘挂载的云主机ID。 */ InstanceId?: string; /** * 云盘的挂载类型。取值范围:<br><li>PF: PF挂载</li><li>VF: VF挂载</li> */ AttachMode?: string; /** * 云盘关联的定期快照ID。只有在调用[DescribeDisks](/document/product/362/16315)接口时,入参ReturnBindAutoSnapshotPolicy取值为TRUE才会返回该参数。 注意:此字段可能返回 null,表示取不到有效值。 */ AutoSnapshotPolicyIds?: Array<string>; /** * 云硬盘额外性能值,单位MiB/s。 */ ThroughputPerformance?: number; /** * 云盘是否处于类型变更中。取值范围:<br><li>false:表示云盘不处于类型变更中</li><li>true:表示云盘已发起类型变更,正处于迁移中。</li> */ Migrating?: boolean; /** * 云硬盘ID。 */ DiskId?: string; /** * 云盘拥有的快照总容量,单位为MiB。 */ SnapshotSize?: number; /** * 云硬盘所在的位置。 */ Placement?: Placement; /** * 判断预付费的云盘是否支持主动退还。<br><li>true:支持主动退还</li><li>false:不支持主动退还。</li> 注意:此字段可能返回 null,表示取不到有效值。 */ IsReturnable?: boolean; /** * 云硬盘的到期时间。 */ DeadlineTime?: string; /** * 云盘是否挂载到云主机上。取值范围:<br><li>false:表示未挂载</li><li>true:表示已挂载。</li> */ Attached?: boolean; /** * 云硬盘大小,单位GiB。 */ DiskSize?: number; /** * 云盘类型变更的迁移进度,取值0到100。 */ MigratePercent?: number; /** * 云硬盘类型。取值范围:<br><li>SYSTEM_DISK:系统盘</li><li>DATA_DISK:数据盘。</li> */ DiskUsage?: string; /** * 付费模式。取值范围:<br><li>PREPAID:预付费,即包年包月</li><li>POSTPAID_BY_HOUR:后付费,即按量计费。</li> */ DiskChargeType?: string; /** * 是否为弹性云盘,false表示非弹性云盘,true表示弹性云盘。 */ Portable?: boolean; /** * 云盘是否具备创建快照的能力。取值范围:<br><li>false表示不具备</li><li>true表示具备。</li> */ SnapshotAbility?: boolean; /** * 在云盘已挂载到实例,且实例与云盘都是包年包月的条件下,此字段才有意义。<br><li>true:云盘到期时间早于实例。</li><li>false:云盘到期时间晚于实例。</li> */ DeadlineError?: boolean; /** * 云盘快照回滚的进度。 */ RollbackPercent?: number; /** * 当前时间距离云硬盘到期的天数(仅对预付费云硬盘有意义) 注意:此字段可能返回 null,表示取不到有效值。 */ DifferDaysOfDeadline?: number; /** * 预付费云盘在不支持主动退还的情况下,该参数表明不支持主动退还的具体原因。取值范围:<br><li>1:云硬盘已经退还</li><li>2:云硬盘已过期</li><li>3:云盘不支持退还</li><li>8:超过可退还数量的限制。</li><li>10:非弹性云硬盘、系统盘、后付费云硬盘等不支持退还</li> */ ReturnFailCode?: number; /** * 云盘是否为共享型云盘。 */ Shareable?: boolean; /** * 云硬盘的创建时间。 */ CreateTime?: string; /** * 销毁云盘时删除关联的非永久保留快照。0 表示非永久快照不随云盘销毁而销毁,1表示非永久快照随云盘销毁而销毁,默认取0。快照是否永久保留可以通过[DescribeSnapshots](https://cloud.tencent.com/document/product/362/15647)接口返回的快照详情的IsPermanent字段来判断,true表示永久快照,false表示非永久快照。 */ DeleteSnapshot?: number; /** * 云硬盘备份点配额。表示最大可以保留的备份点数量。 */ DiskBackupQuota?: number; /** * 云硬盘备份点已使用的数量。 */ DiskBackupCount?: number; /** * 云硬盘挂载实例的类型。取值范围:<br><li>CVM</li><li>EKS</li> */ InstanceType?: string; /** * 云硬盘最后一次挂载的实例ID 注意:此字段可能返回 null,表示取不到有效值。 */ LastAttachInsId?: string; /** * 云硬盘最后一次操作错误提示 */ ErrorPrompt?: string; /** * 云盘是否开启性能突发 */ BurstPerformance?: boolean; /** * 云硬盘加密类型,值为ENCRYPT_V1和ENCRYPT_V2,分别表示第一代和第二代加密技术,两种加密技术互不兼容 */ EncryptType?: string; /** * 加密盘密钥ID */ KmsKeyId?: string; } /** * TerminateDisks返回参数结构体 */ export interface TerminateDisksResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ApplySnapshot返回参数结构体 */ export interface ApplySnapshotResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DetachDisks请求参数结构体 */ export interface DetachDisksRequest { /** * 将要卸载的云硬盘ID, 通过[DescribeDisks](/document/product/362/16315)接口查询,单次请求最多可卸载10块弹性云盘。 */ DiskIds: Array<string>; /** * 对于非共享型云盘,会根据该参数校验是否与实际挂载的实例一致;对于共享型云盘,该参数表示要从哪个CVM实例上卸载云盘。 */ InstanceId?: string; } /** * DescribeSnapshotGroups返回参数结构体 */ export interface DescribeSnapshotGroupsResponse { /** * 符合条件的总数量。 */ TotalCount?: number; /** * 快照组列表详情。 */ SnapshotGroupSet?: Array<SnapshotGroup>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeSnapshotOverview返回参数结构体 */ export interface DescribeSnapshotOverviewResponse { /** * 当前总有效快照数量 */ TotalNums?: number; /** * 已使用快照总容量大小,容量单位为GiB */ TotalSize?: number; /** * 快照免费额度大小,额度单位为GiB */ FreeQuota?: number; /** * 快照真实产生计费的总容量大小,单位为GiB */ RealTradeSize?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDisksChargeType返回参数结构体 */ export interface ModifyDisksChargeTypeResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateSnapshot请求参数结构体 */ export interface CreateSnapshotRequest { /** * 需要创建快照的云硬盘ID,可通过[DescribeDisks](/document/product/362/16315)接口查询。 */ DiskId?: string; /** * 快照名称,不传则新快照名称默认为“未命名”。 */ SnapshotName?: string; /** * 快照的到期时间,到期后该快照将会自动删除,需要传入UTC时间下的ISO-8601标准时间格式,例如:2022-01-08T09:47:55+00:00,。到期时间最小可设置为一天后的当前时间。 */ Deadline?: string; /** * 云硬盘备份点ID。传入此参数时,将通过备份点创建快照。备份点 ID 可以通过[DescribeDiskBackups](/document/product/362/80278)接口查询。 */ DiskBackupId?: string; /** * 快照绑定的标签。 */ Tags?: Array<Tag>; /** * 快照关联云硬盘类型, SYSTEM_DISK: 系统盘, DATA_DISK: 数据盘,非必填参数,不填时快照类型与云盘类型保持一致, 该参数基于某些场景用户需要将系统盘创建出数据盘快照共享使用。 */ DiskUsage?: string; } /** * DescribeInstancesDiskNum请求参数结构体 */ export interface DescribeInstancesDiskNumRequest { /** * <p>云服务器实例ID,通过<a href="/document/product/213/15728">DescribeInstances</a>接口查询。</p> */ InstanceIds: Array<string>; } /** * DescribeSnapshotSharePermission返回参数结构体 */ export interface DescribeSnapshotSharePermissionResponse { /** * 快照的分享信息的集合 */ SharePermissionSet?: Array<SharePermission>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDiskBackupQuota返回参数结构体 */ export interface ModifyDiskBackupQuotaResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InquiryPriceRenewDisks请求参数结构体 */ export interface InquiryPriceRenewDisksRequest { /** * <p>云硬盘ID, 通过<a href="/document/product/362/16315">DescribeDisks</a>接口查询。</p> */ DiskIds: Array<string>; /** * <p>预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月云盘的购买时长。如果在该参数中指定CurInstanceDeadline,则会按对齐到子机到期时间来续费。如果是批量续费询价,该参数与Disks参数一一对应,元素数量需保持一致。</p> */ DiskChargePrepaids?: Array<DiskChargePrepaid>; /** * <p>指定云硬盘新的到期时间,形式如:2017-12-17 00:00:00。参数<code>NewDeadline</code>和<code>DiskChargePrepaids</code>是两种指定询价时长的方式,两者必传一个。</p> */ NewDeadline?: string; /** * <p>云硬盘所属项目ID。该参数可以通过调用<a href="https://cloud.tencent.com/document/api/651/78725">DescribeProject</a> 的返回值中的 projectId 字段来获取。 如传入则仅用于鉴权。</p> */ ProjectId?: number; } /** * DescribeSnapshotSharePermission请求参数结构体 */ export interface DescribeSnapshotSharePermissionRequest { /** * 要查询快照的ID。可通过[DescribeSnapshots](https://cloud.tencent.com/document/api/362/15647)查询获取。 */ SnapshotId: string; } /** * CreateSnapshotGroup请求参数结构体 */ export interface CreateSnapshotGroupRequest { /** * 需要创建快照组的云硬盘ID列表,必须选择挂载在同一实例上的盘列表。 */ DiskIds: Array<string>; /** * 快照组名称,快照组关联的快照也会继承快照组的名称。例如:快照组名称为testSnapshotGroup,快照组关联两个快照,则两个快照的名称分别为testSnapshotGroup_0,testSnapshotGroup_1。 */ SnapshotGroupName?: string; /** * 快照组需要绑定的标签列表。 */ Tags?: Array<Tag>; } /** * DeleteDiskBackups返回参数结构体 */ export interface DeleteDiskBackupsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteSnapshots请求参数结构体 */ export interface DeleteSnapshotsRequest { /** * 要删除的快照ID列表,可通过[DescribeSnapshots](/document/product/362/15647)查询。 */ SnapshotIds: Array<string>; /** * 是否强制删除快照关联的镜像 */ DeleteBindImages?: boolean; } /** * ModifyDisksRenewFlag返回参数结构体 */ export interface ModifyDisksRenewFlagResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * SwitchParameterRenewRemoteDisks请求参数结构体 */ export type SwitchParameterRenewRemoteDisksRequest = null; /** * CopyAutoSnapshotPolicyCrossAccount返回参数结构体 */ export interface CopyAutoSnapshotPolicyCrossAccountResponse { /** * 已备份的定期快照策略ID列表 注意:此字段可能返回 null,表示取不到有效值。 */ AutoSnapshotPolicyIds?: Array<string>; /** * 目标账户uin */ TargetAccountUin?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteAutoSnapshotPolicies返回参数结构体 */ export interface DeleteAutoSnapshotPoliciesResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeDisks返回参数结构体 */ export interface DescribeDisksResponse { /** * 符合条件的云硬盘数量。 */ TotalCount?: number; /** * 云硬盘的详细信息列表。 */ DiskSet?: Array<Disk>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了实例的抽象位置,包括其所在的可用区,所属的项目,以及所属的独享集群的ID和名字。 */ export interface Placement { /** * 云硬盘所属的[可用区](/document/product/213/15753#ZoneInfo)。该参数也可以通过调用 [DescribeZones](/document/product/213/15707) 的返回值中的Zone字段来获取。 */ Zone: string; /** * 围笼Id,可通过 [DescribeDiskStoragePool](https://cloud.tencent.com/document/api/362/62143) 获取。作为入参时,表示对指定的CageId的资源进行操作,可为空。 作为出参时,表示资源所属围笼ID,可为空。 注意:此字段可能返回 null,表示取不到有效值。 */ CageId?: string; /** * 实例所属的独享集群ID。可通过 [DescribeDiskStoragePool](https://cloud.tencent.com/document/api/362/62143) 获取。作为入参时,表示对指定的CdcId独享集群的资源进行操作,可为空。 作为出参时,表示资源所属的独享集群的ID,可为空。 注意:此字段可能返回 null,表示取不到有效值。 */ CdcId?: string; /** * 独享集群名字。作为入参时,忽略。作为出参时,表示云硬盘所属的独享集群名,可为空。 注意:此字段可能返回 null,表示取不到有效值。 */ CdcName?: string; /** * 独享集群id。 */ DedicatedClusterId?: string; /** * 实例所属项目ID,可通过DescribeProject获取。不填默认为0,表示默认项目。 */ ProjectId?: number; /** * 实例所属项目名称,可通过[DescribeProject](/document/api/651/78725)获取。 注意:此字段可能返回 null,表示取不到有效值。 */ ProjectName?: string; } /** * DeleteSnapshots返回参数结构体 */ export interface DeleteSnapshotsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDisksRenewFlag请求参数结构体 */ export interface ModifyDisksRenewFlagRequest { /** * 一个或多个待操作的云硬盘ID,该参数可以通过[DescribeDisks](/document/product/362/16315)接口查询。 */ DiskIds: Array<string>; /** * 云硬盘的自动续费标识。取值范围:<ul><li>NOTIFY_AND_AUTO_RENEW:通知过期且自动续费</li><li>NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费</li><li>DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费</li></ul> */ RenewFlag: string; /** * 该参数支持设置云硬盘的自动续费周期,单位为月。取值范围:[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36] */ AutoRenewPeriod?: number; } /** * ModifySnapshotAttribute返回参数结构体 */ export interface ModifySnapshotAttributeResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CopyAutoSnapshotPolicyCrossAccount请求参数结构体 */ export interface CopyAutoSnapshotPolicyCrossAccountRequest { /** * 要备份的定期快照策略ID列表 */ AutoSnapshotPolicyIds: Array<string>; /** * 目标账户uin */ TargetAccountUin: string; } /** * ModifyDiskAttributes请求参数结构体 */ export interface ModifyDiskAttributesRequest { /** * 一个或多个待操作的云硬盘ID,可以通过[DescribeDisks](/document/product/362/16315)接口查询。如果传入多个云盘ID,仅支持将所有云盘修改为同一属性。 */ DiskIds: Array<string>; /** * 新的云硬盘名称。 */ DiskName?: string; /** * 是否为弹性云盘,FALSE表示非弹性云盘,TRUE表示弹性云盘。仅支持非弹性云盘修改为弹性云盘。 */ Portable?: boolean; /** * 新的云硬盘项目ID,只支持修改弹性云盘的项目ID。通过[DescribeProject](/document/api/378/4400)接口查询可用项目及其ID。 */ ProjectId?: number; /** * 成功挂载到云主机后该云硬盘是否随云主机销毁,TRUE表示随云主机销毁,FALSE表示不随云主机销毁。仅支持按量计费云硬盘数据盘。 */ DeleteWithInstance?: boolean; /** * 变更云盘类型时,可传入该参数,表示变更的目标类型,取值范围:<br><li>CLOUD_PREMIUM:表示高性能云硬盘</li><li>CLOUD_SSD:表示SSD云硬盘。</li>当前不支持批量变更类型,即传入DiskType时,DiskIds仅支持传入一块云盘;<br>变更云盘类型时不支持同时变更其他属性。 具体说明请参考[调整云硬盘类型](https://cloud.tencent.com/document/product/362/32540) */ DiskType?: string; /** * 开启/关闭云盘性能突发功能,取值范围: CREATE:开启 CANCEL:关闭 */ BurstPerformanceOperation?: string; } /** * DescribeRemoteDisksDeniedActions返回参数结构体 */ export interface DescribeRemoteDisksDeniedActionsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * GetSnapOverview请求参数结构体 */ export type GetSnapOverviewRequest = null; /** * DetachRemoteDisks返回参数结构体 */ export interface DetachRemoteDisksResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 镜像。 */ export interface Image { /** * 镜像名称。 */ ImageName?: string; /** * 镜像实例ID。 */ ImageId?: string; } /** * ModifyAutoSnapshotPolicyAttribute返回参数结构体 */ export interface ModifyAutoSnapshotPolicyAttributeResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * TerminateDisks请求参数结构体 */ export interface TerminateDisksRequest { /** * 需退还的云盘ID列表,通过[DescribeDisks](/document/product/362/16315)接口查询。 */ DiskIds: Array<string>; /** * 销毁云盘时删除关联的非永久保留快照。0 表示非永久快照不随云盘销毁而销毁,1表示非永久快照随云盘销毁而销毁,默认取0。快照是否永久保留可以通过DescribeSnapshots接口返回的快照详情的IsPermanent字段来判断,true表示永久快照,false表示非永久快照。 */ DeleteSnapshot?: number; } /** * 显示独享集群的大小 */ export interface CdcSize { /** * 独享集群的总容量大小,单位GiB */ DiskTotal?: number; /** * 独享集群的可用容量大小,单位GiB */ DiskAvailable?: number; } /** * DescribeInstancesDiskNum返回参数结构体 */ export interface DescribeInstancesDiskNumResponse { /** * <p>各个云服务器已挂载和可挂载弹性云盘的数量。</p> */ AttachDetail?: Array<AttachDetail>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InquirePriceCreateRemoteDisks请求参数结构体 */ export interface InquirePriceCreateRemoteDisksRequest { /** * <p>单副本SSD硬盘计费类型。</p><p>枚举值:</p><ul><li>PREPAID: 预付费,即包年包月</li><li>POSTPAID_BY_HOUR: 按小时后付费</li></ul> */ DiskChargeType: string; /** * <p>单副本SSD硬盘大小,单位为GiB。</p><p>取值范围:[2000, 7000]</p> */ DiskSize: number; /** * <p>预付费模式,即包年包月相关参数设置。通过该参数指定包年包月云盘的购买时长、是否设置自动续费等属性。 创建预付费云盘该参数必传,创建按小时后付费云盘无需传该参数。</p> */ DiskChargePrepaid?: RemoteDiskChargePrepaid; /** * <p>购买单副本SSD硬盘的数量。不填则默认为1。</p> */ DiskCount?: number; } /** * ResizeDisk请求参数结构体 */ export interface ResizeDiskRequest { /** * <p>云硬盘扩容后的大小,单位为GB,必须大于当前云硬盘大小。云盘大小取值范围参见云硬盘<a href="/document/product/362/2353">产品分类</a>的说明。</p> */ DiskSize: number; /** * <p>云硬盘ID, 通过<a href="/document/product/362/16315">DescribeDisks</a>接口查询。该字段仅供单块云硬盘扩容时传入。</p> */ DiskId?: string; } /** * ApplyDiskBackup请求参数结构体 */ export interface ApplyDiskBackupRequest { /** * 云硬盘备份点ID,可以通过[DescribeDiskBackups](/document/product/362/80278)接口查询。 */ DiskBackupId: string; /** * 云硬盘备份点原云硬盘ID,可以通过[DescribeDisks](/document/product/362/16315)接口查。 */ DiskId: string; /** * 回滚云硬盘备份点前是否自动关机,默认为FALSE,表示不自动关机 */ AutoStopInstance?: boolean; /** * 回滚云硬盘备份点完成后是否自动开机,默认为FALSE,表示不自动开机; AutoStartInstance参数需要在AutoStopInstance为true时才能为true。 */ AutoStartInstance?: boolean; } /** * ModifyDisksChargeType请求参数结构体 */ export interface ModifyDisksChargeTypeRequest { /** * 一个或多个待操作的云硬盘ID,可以通过[DescribeDisks](/document/product/362/16315)接口查询。每次请求批量云硬盘上限为100。 */ DiskIds: Array<string>; /** * 设置为预付费模式,即包年包月相关参数设置。通过该参数可以指定包年包月实例的购买时长、是否设置自动续费等属性。 */ DiskChargePrepaid?: DiskChargePrepaid; /** * 设置为后付费模式 */ DiskChargePostpaid?: boolean; } /** * InitializeDisks请求参数结构体 */ export interface InitializeDisksRequest { /** * 待重新初始化的云硬盘ID列表,可以通过[DescribeDisks](/document/product/362/16315)接口查询, 单次初始化限制20块以内 */ DiskIds: Array<string>; } /** * CreateRemoteDisks请求参数结构体 */ export interface CreateRemoteDisksRequest { /** * <p>单副本SSD硬盘计费类型。 </p><p>枚举值:</p><ul><li>PREPAID: 预付费,即包年包月</li><li>POSTPAID_BY_HOUR: 按小时后付费</li></ul> */ DiskChargeType: string; /** * <p>单副本SSD硬盘大小,单位为GiB。</p><p>取值范围:[2000, 7000]</p> */ DiskSize: number; /** * <p>待挂载单副本SSD硬盘的CVM实例ID。</p> */ InstanceId: string; /** * <p>实例所在的位置。通过该参数可以指定实例所属可用区,所属项目。若不指定项目,将在默认项目下进行创建。</p> */ Placement: Placement; /** * <p>预付费模式,即包年包月相关参数设置。通过该参数指定包年包月单副本SSD硬盘的购买时长、是否设置自动续费等属性。 创建预付费单副本SSD硬盘该参数必传,创建按小时后付费单副本SSD硬盘无需传该参数。</p> */ DiskChargePrepaid?: RemoteDiskChargePrepaid; /** * <p>创建单副本SSD硬盘数量,不传则默认为1。</p> */ DiskCount?: number; /** * <p>单副本SSD的显示名称。</p> */ DiskName?: string; } /** * 云盘配置。 */ export interface DiskConfig { /** * 配置是否可用。 */ Available?: boolean; /** * 付费模式。取值范围:<br><li>PREPAID:表示预付费,即包年包月</li><br><li>POSTPAID_BY_HOUR:表示后付费,即按量计费。</li> */ DiskChargeType?: string; /** * 云硬盘所属的[可用区](/document/product/213/15753#ZoneInfo)。 */ Zone?: string; /** * 实例机型系列。详见[实例类型](https://cloud.tencent.com/document/product/213/11518) 注意:此字段可能返回 null,表示取不到有效值。 */ InstanceFamily?: string; /** * 云盘介质类型。取值范围:<br> CLOUD_BASIC:表示普通云硬盘<br> CLOUD_PREMIUM:表示高性能云硬盘<br> CLOUD_BSSD:表示通用型SSD云硬盘<br> CLOUD_SSD:表示SSD云硬盘<br> CLOUD_HSSD:表示增强型SSD云硬盘<br> CLOUD_TSSD:表示极速型SSD云硬盘。 */ DiskType?: string; /** * 云盘大小变化的最小步长,单位GiB。 */ StepSize?: number; /** * 额外的性能区间。 注意:此字段可能返回 null,表示取不到有效值。 */ ExtraPerformanceRange?: Array<number | bigint>; /** * 实例机型。 注意:此字段可能返回 null,表示取不到有效值。 */ DeviceClass?: string; /** * 云盘类型。取值范围:<br><li>SYSTEM_DISK:表示系统盘</li><br><li>DATA_DISK:表示数据盘。</li> */ DiskUsage?: string; /** * 最小可配置云盘大小,单位GiB。 */ MinDiskSize?: number; /** * 最大可配置云盘大小,单位GiB。 */ MaxDiskSize?: number; /** * 描述预付费或后付费云盘的价格。 */ Price?: Price; } /** * CreateAutoSnapshotPolicy返回参数结构体 */ export interface CreateAutoSnapshotPolicyResponse { /** * 新创建的定期快照策略ID。 */ AutoSnapshotPolicyId?: string; /** * 首次开始备份的时间。 */ NextTriggerTime?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifySnapshotAttribute请求参数结构体 */ export interface ModifySnapshotAttributeRequest { /** * 快照ID, 可通过[DescribeSnapshots](https://cloud.tencent.com/document/api/362/15647)查询。 */ SnapshotId: string; /** * 快照的保留方式,FALSE表示非永久保留,TRUE表示永久保留。 */ IsPermanent?: boolean; /** * 新的快照名称。最长为60个字符。 */ SnapshotName?: string; /** * 快照的到期时间;设置好快照将会被同时设置为非永久保留方式;超过到期时间后快照将会被自动删除。注:该参数仅在参数IsPermanent为False时生效。 */ Deadline?: string; } /** * UnbindAutoSnapshotPolicy请求参数结构体 */ export interface UnbindAutoSnapshotPolicyRequest { /** * 要解绑的定期快照策略ID。 */ AutoSnapshotPolicyId: string; /** * 要解绑定期快照策略的云盘ID列表。此参数与 InstanceIds 参数至少需要传入一个。 */ DiskIds?: Array<string>; /** * 要解绑定期快照策略的实例ID列表。此参数与 DiskIds 参数至少需要传入一个。 */ InstanceIds?: Array<string>; } /** * DescribeRemoteDiskConfigQuota请求参数结构体 */ export interface DescribeRemoteDiskConfigQuotaRequest { /** * <p>过滤条件。支持的过滤条件如下:</p><ul><li>instance-family:按照机型族过滤。</li><li>instance-type:按照机型规格过滤。</li><li>zone:按照可用区过滤。</li><li>instance-charge-type:按照付费方式过滤。取值范围:PREPAID、POSTPAID_BY_HOUR、SPOTPAID、UNDERWRITE。</li></ul> */ Filters?: Array<Filter>; } /** * CreateDiskBackup返回参数结构体 */ export interface CreateDiskBackupResponse { /** * 云硬盘备份点的ID。 */ DiskBackupId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * InquirePriceModifyDiskBackupQuota返回参数结构体 */ export interface InquirePriceModifyDiskBackupQuotaResponse { /** * 描述了修改云硬盘备份点之后的云盘价格。 */ DiskPrice?: Price; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteAutoSnapshotPolicies请求参数结构体 */ export interface DeleteAutoSnapshotPoliciesRequest { /** * 要删除的定期快照策略ID列表,通过[ DescribeAutoSnapshotPolicies](https://cloud.tencent.com/document/api/362/33556)接口查询。 */ AutoSnapshotPolicyIds: Array<string>; } /** * 描述了实例的计费模式 */ export interface DiskChargePrepaid { /** * 购买云硬盘的时长,默认单位为月,取值范围:1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36。 */ Period: number; /** * 自动续费标识。取值范围: <ul> <li>NOTIFY_AND_AUTO_RENEW:通知过期且自动续费</li> <li>NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费</li> <li>DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费</li> </ul> 默认取值:NOTIFY_AND_MANUAL_RENEW。 */ RenewFlag?: string; /** * 需要将云硬盘的到期时间与挂载的子机对齐时,可传入该参数。该参数表示子机当前的到期时间,此时Period如果传入,则表示子机需要续费的时长,云盘会自动按对齐到子机续费后的到期时间续费. */ CurInstanceDeadline?: string; } /** * DeleteSnapshotGroup返回参数结构体 */ export interface DeleteSnapshotGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了单副本SSD硬盘的预付费计费模式。 */ export interface RemoteDiskChargePrepaid { /** * 购买单副本SSD硬盘的时长,默认单位为月,取值范围:1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, 36。 */ Period: number; /** * 需要将单副本SSD硬盘的到期时间与挂载的子机对齐时,可传入该参数。该参数表示子机当前的到期时间,此时Period如果传入,则表示子机需要续费的时长,单副本SSD硬盘会自动按对齐到子机续费后的到期时间续费。 */ CurInstanceDeadline?: string; /** * 自动续费标识。取值范围: <ul> <li>NOTIFY_AND_AUTO_RENEW:通知过期且自动续费</li> <li>NOTIFY_AND_MANUAL_RENEW:通知过期不自动续费</li> <li>DISABLE_NOTIFY_AND_MANUAL_RENEW:不通知过期不自动续费</li> </ul> 默认取值:NOTIFY_AND_MANUAL_RENEW。 */ RenewFlag?: string; } /** * ApplySnapshotGroup返回参数结构体 */ export interface ApplySnapshotGroupResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeSnapshotOverview请求参数结构体 */ export type DescribeSnapshotOverviewRequest = null; /** * 过滤条件 */ export interface Filter { /** * 过滤键的名称 */ Name: string; /** * 一个或者多个过滤值 */ Values: Array<string>; } /** * InquiryPriceCreateDisks请求参数结构体 */ export interface InquiryPriceCreateDisksRequest { /** * 云硬盘计费类型: <ul> <li>PREPAID:预付费,即包年包月</li> <li>POSTPAID_BY_HOUR:按小时后付费</li> </ul> */ DiskChargeType: string; /** * 硬盘介质类型。取值范围: <ul> <li>CLOUD_PREMIUM:表示高性能云硬盘</li> <li>CLOUD_SSD:表示SSD云硬盘</li> <li>CLOUD_HSSD:表示增强型SSD云硬盘</li> <li>CLOUD_TSSD:表示极速型SSD云硬盘</li> </ul> */ DiskType: string; /** * 云硬盘大小,单位为GiB。云盘大小取值范围参见云硬盘[产品分类](/document/product/362/2353)的说明。 */ DiskSize: number; /** * 云硬盘所属项目ID。该参数可以通过调用[DescribeProject](https://cloud.tencent.com/document/api/651/78725) 的返回值中的 projectId 字段来获取。不填为默认项目。 */ ProjectId?: number; /** * 购买云硬盘的数量。不填则默认为1。 */ DiskCount?: number; /** * 额外购买的云硬盘性能值,单位MiB/s。仅大小超过460GiB的增强型SSD(CLOUD_HSSD)和极速型SSD(CLOUD_TSSD)云硬盘才支持购买额外性能。 */ ThroughputPerformance?: number; /** * 预付费模式,即包年包月相关参数设置。通过该参数指定包年包月云盘的购买时长、是否设置自动续费等属性。<br>创建预付费云盘该参数必传,创建按小时后付费云盘无需传该参数。 */ DiskChargePrepaid?: DiskChargePrepaid; /** * 指定云硬盘备份点配额。 */ DiskBackupQuota?: number; } /** * DescribeSnapshots返回参数结构体 */ export interface DescribeSnapshotsResponse { /** * 快照的数量。 */ TotalCount?: number; /** * 快照的详情列表。 */ SnapshotSet?: Array<Snapshot>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 描述了快照的详细信息 */ export interface Snapshot { /** * <p>快照所在的位置。</p> */ Placement?: Placement; /** * <p>是否为跨地域复制的快照。取值范围:</p><ul> <li>true:表示为跨地域复制的快照。</li> <li>false:本地域的快照。</li></ul> */ CopyFromRemote?: boolean; /** * <p>快照的状态。取值范围:</p><ul> <li>NORMAL:正常</li> <li>CREATING:创建中</li> <li>ROLLBACKING:回滚中</li> <li>COPYING_FROM_REMOTE:跨地域复制中</li> <li>CHECKING_COPIED:复制校验中</li> <li>TORECYCLE:待回收</li></ul> */ SnapshotState?: string; /** * <p>是否为永久快照。取值范围:</p><ul> <li>true:永久快照</li> <li>false:非永久快照</li></ul> */ IsPermanent?: boolean; /** * <p>快照名称,用户自定义的快照别名。调用<a href="/document/product/362/15650">ModifySnapshotAttribute</a>可修改此字段。</p> */ SnapshotName?: string; /** * <p>快照到期时间。如果快照为永久保留,此字段为空。</p> */ DeadlineTime?: string; /** * <p>快照创建进度百分比,快照创建成功后此字段恒为100。</p> */ Percent?: number; /** * <p>快照关联的镜像列表。</p> */ Images?: Array<Image>; /** * <p>快照当前被共享数。</p> */ ShareReference?: number; /** * <p>快照类型,目前该项取值可以为<code>PRIVATE_SNAPSHOT</code>(私有快照)或者<code>SHARED_SNAPSHOT</code>(共享快照)</p> */ SnapshotType?: string; /** * <p>创建此快照的云硬盘大小,单位GiB。</p> */ DiskSize?: number; /** * <p>创建此快照的云硬盘ID。</p> */ DiskId?: string; /** * <p>快照正在跨地域复制的目的地域,若没有则返回<code>[]</code>。</p>