UNPKG

tencentcloud-sdk-nodejs

Version:
2,298 lines (2,297 loc) 340 kB
/** * 实例任务详情 */ export interface TaskDetail { /** * 错误码。0代表成功,其他对应不同的报错场景。 */ Code?: number; /** * 错误信息。 */ Message?: string; /** * 实例任务 ID。 */ JobId?: number; /** * 实例任务进度。 */ Progress?: number; /** * 实例任务状态,可能的值包括: "UNDEFINED" - 未定义; "INITIAL" - 初始化; "RUNNING" - 运行中; "SUCCEED" - 执行成功; "FAILED" - 执行失败; "KILLED" - 已终止; "REMOVED" - 已删除; "PAUSED" - 已暂停。 "WAITING" - 等待中(可撤销) */ TaskStatus?: string; /** * 实例任务类型,可能的值包括: "ROLLBACK" - 数据库回档; "SQL OPERATION" - SQL操作; "IMPORT DATA" - 数据导入; "MODIFY PARAM" - 参数设置; "INITIAL" - 初始化云数据库实例; "REBOOT" - 重启云数据库实例; "OPEN GTID" - 开启云数据库实例GTID; "UPGRADE RO" - 只读实例升级; "BATCH ROLLBACK" - 数据库批量回档; "UPGRADE MASTER" - 主实例升级; "DROP TABLES" - 删除云数据库库表; "SWITCH DR TO MASTER" - 灾备实例提升为主。 */ TaskType?: string; /** * 实例任务开始时间。 */ StartTime?: string; /** * 实例任务结束时间。 */ EndTime?: string; /** * 任务关联的实例 ID。 */ InstanceIds?: Array<string>; /** * 异步任务的请求 ID。 */ AsyncRequestId?: string; /** * 任务的附加信息。 */ TaskAttachInfo?: Array<TaskAttachInfo>; } /** * DescribeTableColumns返回参数结构体 */ export interface DescribeTableColumnsResponse { /** * 符合查询条件的实例总数。 */ TotalCount?: number; /** * 返回的数据库列信息。 */ Items?: Array<string>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 可用区售卖配置 */ export interface CdbZoneSellConf { /** * 可用区状态。可能的返回值为:1-上线;3-停售;4-不展示 */ Status?: number; /** * 可用区中文名称 */ ZoneName?: string; /** * 实例类型是否为自定义类型 */ IsCustom?: boolean; /** * 是否支持灾备 */ IsSupportDr?: boolean; /** * 是否支持私有网络 */ IsSupportVpc?: boolean; /** * 小时计费实例最大售卖数量 */ HourInstanceSaleMaxNum?: number; /** * 是否为默认可用区 */ IsDefaultZone?: boolean; /** * 是否为黑石区 */ IsBm?: boolean; /** * 支持的付费类型。可能的返回值为:0-包年包月;1-小时计费;2-后付费 */ PayType?: Array<string>; /** * 数据复制类型。0-异步复制;1-半同步复制;2-强同步复制 */ ProtectMode?: Array<string>; /** * 可用区名称 */ Zone?: string; /** * 多可用区信息 */ ZoneConf?: ZoneConf; /** * 可支持的灾备可用区信息 */ DrZone?: Array<string>; /** * 是否支持跨可用区只读 */ IsSupportRemoteRo?: boolean; /** * 可支持的跨可用区只读区信息 */ RemoteRoZone?: Array<string>; /** * 独享型可用区状态。可能的返回值为:1-上线;3-停售;4-不展示 */ ExClusterStatus?: number; /** * 独享型可支持的跨可用区只读区信息 */ ExClusterRemoteRoZone?: Array<string>; /** * 独享型多可用区信息 */ ExClusterZoneConf?: ZoneConf; /** * 售卖实例类型数组,其中configIds的值与configs结构体中的id一一对应。 */ SellType?: Array<CdbSellType>; /** * 可用区id */ ZoneId?: number; /** * 是否支持ipv6 */ IsSupportIpv6?: boolean; /** * 可支持的售卖数据库引擎类型 */ EngineType?: Array<string>; /** * 云盘版实例在当前可用区的售卖状态。可能的返回值为:1-上线;3-停售;4-不展示 */ CloudNativeClusterStatus?: number; /** * 云盘版或者单节点基础型支持的磁盘类型。 */ DiskTypeConf?: Array<DiskTypeConfigItem>; } /** * CreateDBImportJob请求参数结构体 */ export interface CreateDBImportJobRequest { /** * 实例的 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; /** * 云数据库的用户名。 */ User: string; /** * 文件名称。该文件是指用户已上传到腾讯云的文件,仅支持.sql文件。 */ FileName?: string; /** * 云数据库实例 User 账号的密码。 */ Password?: string; /** * 导入的目标数据库名,不传表示不指定数据库。 */ DbName?: string; /** * 腾讯云COS文件链接。 用户需要指定 FileName 或者 CosUrl 其中一个。 COS文件需要是 .sql 文件。 */ CosUrl?: string; } /** * DescribeDatabases请求参数结构体 */ export interface DescribeDatabasesRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; /** * 偏移量,最小值为0。 */ Offset?: number; /** * 单次请求数量,默认值为20,最小值为1,最大值为5000。 */ Limit?: number; /** * 匹配数据库库名的正则表达式。 */ DatabaseRegexp?: string; } /** * ModifyDBInstanceReadOnlyStatus返回参数结构体 */ export interface ModifyDBInstanceReadOnlyStatusResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCdbProxy请求参数结构体 */ export interface CreateCdbProxyRequest { /** * 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId: string; /** * 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ UniqVpcId: string; /** * 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ UniqSubnetId: string; /** * 节点规格配置。 示例中参数说明: NodeCount:节点个数。 Region:节点地域。 Zone:节点可用区。 Cpu:单个代理节点核数(单位:核)。 Mem:单个代理节点内存数(单位:MB)。 备注: 1. 数据库代理支持的节点规格为:2C4000MB、4C8000MB、8C16000MB。 2. 上述参数项(如节点个数、可用区等)均为必填,在调用接口时如未填写完整,可能会创建失败。 */ ProxyNodeCustom: Array<ProxyNodeCustom>; /** * 安全组 */ SecurityGroup?: Array<string>; /** * 描述 */ Desc?: string; /** * 连接池阈值 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 */ ConnectionPoolLimit?: number; /** * 指定要购买的 proxy 内核版本。不填则默认发货最新版本的 proxy。 */ ProxyVersion?: string; } /** * CreateCdbProxy返回参数结构体 */ export interface CreateCdbProxyResponse { /** * 异步任务ID */ AsyncRequestId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 实例可回档时间范围 */ export interface InstanceRollbackRangeTime { /** * 查询数据库错误码。0 - 正常,1600001 - 内部错误,1600003 - 入参异常,1600009 - 实例不存在,1624001 - DB 访问异常。 */ Code?: number; /** * 查询数据库错误信息 */ Message?: string; /** * 实例ID列表,单个实例Id的格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同 */ InstanceId?: string; /** * 可回档时间范围 */ Times?: Array<RollbackTimeRange>; } /** * DescribeTables返回参数结构体 */ export interface DescribeTablesResponse { /** * 符合查询条件的数据库表总数。 */ TotalCount?: number; /** * 返回的数据库表信息。 */ Items?: Array<string>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyBackupDownloadRestriction返回参数结构体 */ export interface ModifyBackupDownloadRestrictionResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 实例审计详情信息 */ export interface InstanceDbAuditStatus { /** * <p>实例ID。</p> */ InstanceId?: string; /** * <p>审计状态。ON-表示审计已开启,OFF-表示审计关闭</p> */ AuditStatus?: string; /** * <p>任务状态。0-无任务;1-审计开启中,2-审计关闭中。</p> */ AuditTask?: number; /** * <p>日志保留时长。支持值包括:<br>7 - 一周;<br>30 - 一个月;<br>90 - 三个月;<br>180 - 六个月;<br>365 - 一年;<br>1095 - 三年;<br>1825 - 五年。</p> */ LogExpireDay?: number; /** * <p>高频存储时长。支持值包括:<br>3 - 3天;<br>7 - 一周;<br>30 - 一个月;<br>90 - 三个月;<br>180 - 六个月;<br>365 - 一年;<br>1095 - 三年;<br>1825 - 五年。</p> */ HighLogExpireDay?: number; /** * <p>低频存储时长。单位:天,等于日志保存时长减去高频存储时长。</p> */ LowLogExpireDay?: number; /** * <p>日志存储量(单位:GB)。</p> */ BillingAmount?: number; /** * <p>高频存储量(单位:GB)。</p> */ HighRealStorage?: number; /** * <p>低频存储量(单位:GB)。</p> */ LowRealStorage?: number; /** * <p>是否为全审计(true-表示全审计)</p> */ AuditAll?: boolean; /** * <p>审计开通时间。</p> */ CreateAt?: string; /** * <p>实例相关信息</p> */ InstanceInfo?: AuditInstanceInfo; /** * <p>总存储量(单位:GB)。</p> */ RealStorage?: number; /** * <p>是否包含审计策略</p> */ OldRule?: boolean; /** * <p>实例所应用的规则模板。</p> */ RuleTemplateIds?: Array<string>; /** * <p>限免状态</p> */ TrialStatus?: string; /** * <p>限免开启时间</p> */ TrialStartTime?: number; /** * <p>限免持续时间</p> */ TrialDuration?: number; /** * <p>限免关闭时间</p> */ TrialCloseTime?: number; /** * <p>限免期查询日志时长</p> */ TrialDescribeLogHours?: number; /** * <p>投递信息</p> */ DeliverSummary?: Array<DeliverSummary>; /** * <p>是否开启了投递,ON:开启,OFF:关闭</p> */ Deliver?: string; } /** * ModifyTimeWindow返回参数结构体 */ export interface ModifyTimeWindowResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 参数修改记录 */ export interface ParamRecord { /** * 实例ID */ InstanceId?: string; /** * 参数名称 */ ParamName?: string; /** * 参数修改前的值 */ OldValue?: string; /** * 参数修改后的值 */ NewValue?: string; /** * 参数是否修改成功 * @deprecated */ IsSucess?: boolean; /** * 修改时间 */ ModifyTime?: string; /** * 参数是否修改成功 */ IsSuccess?: boolean; } /** * DescribeParamTemplates请求参数结构体 */ export interface DescribeParamTemplatesRequest { /** * 引擎版本,缺省则查询所有。可取值为:5.5、5.6、5.7、8.0。 */ EngineVersions?: Array<string>; /** * 引擎类型,缺省则查询所有。可取值为:InnoDB、RocksDB,不区分大小写。 */ EngineTypes?: Array<string>; /** * 模板名称,缺省则查询所有。支持模糊匹配。 */ TemplateNames?: Array<string>; /** * 模板 ID,缺省则查询所有。 */ TemplateIds?: Array<number | bigint>; } /** * DescribeRollbackRangeTime请求参数结构体 */ export interface DescribeRollbackRangeTimeRequest { /** * 实例 ID 列表,单个实例 ID 的格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceIds: Array<string>; /** * 克隆实例与源实例是否在异地可用区,是:"true",否:"false" */ IsRemoteZone?: string; /** * 克隆实例与源实例不在同一地域时需填写克隆实例所在地域,例:"ap-guangzhou" */ BackupRegion?: string; } /** * DescribeBackupOverview请求参数结构体 */ export interface DescribeBackupOverviewRequest { /** * 需要查询备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点(云盘)实例,mysql-cluster 指云盘版实例。 */ Product: string; } /** * DescribeAuditInstanceList返回参数结构体 */ export interface DescribeAuditInstanceListResponse { /** * <p>符合查询条件的实例总数。</p> */ TotalCount?: number; /** * <p>审计实例详细信息列表。</p> 注意:此字段可能返回 null,表示取不到有效值。 */ Items?: Array<InstanceDbAuditStatus>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDBInstanceProject返回参数结构体 */ export interface ModifyDBInstanceProjectResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCpuExpandHistory返回参数结构体 */ export interface DescribeCpuExpandHistoryResponse { /** * 满足查询要求的扩容历史 */ Items?: Array<HistoryJob>; /** * 总数出参 */ TotalCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyDBInstanceModes返回参数结构体 */ export interface ModifyDBInstanceModesResponse { /** * <p>异步任务的请求ID,可使用此ID查询异步任务的执行结果。</p> */ AsyncRequestId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteAuditPolicy请求参数结构体 */ export interface DeleteAuditPolicyRequest { /** * 审计策略 ID。 */ PolicyId: string; /** * 实例 ID。 */ InstanceId?: string; } /** * 实例备份统计项 */ export interface BackupSummaryItem { /** * 实例ID。 */ InstanceId?: string; /** * 该实例自动数据备份的个数。 */ AutoBackupCount?: number; /** * 该实例自动数据备份的容量。 */ AutoBackupVolume?: number; /** * 该实例手动数据备份的个数。 */ ManualBackupCount?: number; /** * 该实例手动数据备份的容量。 */ ManualBackupVolume?: number; /** * 该实例总的数据备份(包含自动备份和手动备份)个数。 */ DataBackupCount?: number; /** * 该实例总的数据备份容量。 */ DataBackupVolume?: number; /** * 该实例日志备份的个数。 */ BinlogBackupCount?: number; /** * 该实例日志备份的容量。 */ BinlogBackupVolume?: number; /** * 该实例的总备份(包含数据备份和日志备份)占用容量。 */ BackupVolume?: number; } /** * CreateDatabase请求参数结构体 */ export interface CreateDatabaseRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; /** * 数据库名称,长度不超过64。 */ DBName: string; /** * 字符集,可选值:utf8,gbk,latin1,utf8mb4。 */ CharacterSetName: string; } /** * ModifyInstanceParam请求参数结构体 */ export interface ModifyInstanceParamRequest { /** * 实例 ID 列表。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceIds: Array<string>; /** * 要修改的参数列表。每一个元素是 Name 和 CurrentValue 的组合。Name 是参数名,CurrentValue 是要修改成的值。 */ ParamList?: Array<Parameter>; /** * 模板 ID,ParamList 和 TemplateId 必须至少传其中之一。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 */ TemplateId?: number; /** * 执行参数调整任务的方式,默认为 0。支持值包括:0 - 立刻执行,1 - 时间窗执行;当该值为 1 时,每次只能传一个实例(InstanceIds数量为1) */ WaitSwitch?: number; /** * 参数是否同步到主实例下的只读实例。true 为不同步,false 为同步。默认为 false。 */ NotSyncRo?: boolean; /** * 参数是否同步到主实例下的灾备实例。true 为不同步,false 为同步。默认为 false。 */ NotSyncDr?: boolean; } /** * ModifyProtectMode返回参数结构体 */ export interface ModifyProtectModeResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateParamTemplate请求参数结构体 */ export interface CreateParamTemplateRequest { /** * 参数模板名称。支持输入最大60个字符。 */ Name: string; /** * 参数模板描述。 */ Description?: string; /** * MySQL 版本号。可选值:5.6、5.7、8.0。 */ EngineVersion?: string; /** * 源参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 */ TemplateId?: number; /** * 参数列表。 */ ParamList?: Array<Parameter>; /** * 默认参数模板类型。支持值包括:"HIGH_STABILITY" - 高稳定模板,"HIGH_PERFORMANCE" - 高性能模板。 */ TemplateType?: string; /** * 实例引擎类型,默认为"InnoDB",支持值包括:"InnoDB","RocksDB"。 说明:数据库版本 MySQL 5.7、MySQL 8.0才支持 RocksDB。 */ EngineType?: string; } /** * 异地备份信息 */ export interface RemoteBackupInfo { /** * 异地备份子任务的ID */ SubBackupId?: number; /** * 异地备份所在地域 */ Region?: string; /** * 备份任务状态。可能的值有 "SUCCESS": 备份成功, "FAILED": 备份失败, "RUNNING": 备份进行中。 */ Status?: string; /** * 异地备份任务的开始时间 */ StartTime?: string; /** * 异地备份任务的结束时间 */ FinishTime?: string; /** * 下载地址 */ Url?: string; } /** * 按周期扩容策略中的所选择的周期 */ export interface PeriodStrategy { /** * 扩容周期 */ TimeCycle?: TImeCycle; /** * 时间间隔 */ TimeInterval?: TimeInterval; } /** * DescribeParamTemplateInfo请求参数结构体 */ export interface DescribeParamTemplateInfoRequest { /** * 参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 */ TemplateId: number; } /** * ModifyCdbProxyAddressVipAndVPort返回参数结构体 */ export interface ModifyCdbProxyAddressVipAndVPortResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeDBInstances请求参数结构体 */ export interface DescribeDBInstancesRequest { /** * <p>项目 ID。</p> */ ProjectId?: number; /** * <p>实例类型,可取值:1 - 主实例,2 - 灾备实例,3 - 只读实例。</p> */ InstanceTypes?: Array<number | bigint>; /** * <p>实例的内网 IP 地址。</p> */ Vips?: Array<string>; /** * <p>实例状态,可取值:<br>0 - 创建中<br>1 - 运行中<br>4 - 正在进行隔离操作<br>5 - 已隔离(可在回收站恢复开机)</p> */ Status?: Array<number | bigint>; /** * <p>偏移量,默认值为 0。</p> */ Offset?: number; /** * <p>单次请求返回的数量,默认值为 20,最大值为 2000。</p> */ Limit?: number; /** * <p>安全组 ID。当使用安全组 ID 为过滤条件时,需指定 WithSecurityGroup 参数为 1。</p> */ SecurityGroupId?: string; /** * <p>付费类型,可取值:0 - 包年包月,1 - 小时计费。</p> */ PayTypes?: Array<number | bigint>; /** * <p>实例名称。</p> */ InstanceNames?: Array<string>; /** * <p>实例任务状态,可能取值:<br>0 - 没有任务<br>1 - 升级中<br>2 - 数据导入中<br>3 - 开放Slave中<br>4 - 外网访问开通中<br>5 - 批量操作执行中<br>6 - 回档中<br>7 - 外网访问关闭中<br>8 - 密码修改中<br>9 - 实例名修改中<br>10 - 重启中<br>12 - 自建迁移中<br>13 - 删除库表中<br>14 - 灾备实例创建同步中<br>15 - 升级待切换<br>16 - 升级切换中<br>17 - 升级切换完成<br>19 - 参数设置待执行<br>34 - 原地升级待执行</p> */ TaskStatus?: Array<number | bigint>; /** * <p>实例数据库引擎版本,可能取值:5.1、5.5、5.6 和 5.7。</p> */ EngineVersions?: Array<string>; /** * <p>私有网络的 ID。</p> */ VpcIds?: Array<number | bigint>; /** * <p>可用区的 ID。</p> */ ZoneIds?: Array<number | bigint>; /** * <p>子网 ID。</p> */ SubnetIds?: Array<number | bigint>; /** * <p>是否锁定标记,可选值:0 - 不锁定,1 - 锁定,默认为0。</p> */ CdbErrors?: Array<number | bigint>; /** * <p>返回结果集排序的字段,目前支持:&quot;instanceId&quot;,&quot;instanceName&quot;,&quot;createTime&quot;,&quot;deadlineTime&quot;。</p> */ OrderBy?: string; /** * <p>返回结果集排序方式。目前支持值:&quot;ASC&quot; - 表示升序,&quot;DESC&quot; - 表示降序,默认为 &quot;DESC&quot;。</p> */ OrderDirection?: string; /** * <p>是否以安全组 ID 为过滤条件。<br>说明:0表示否,1表示是。</p> */ WithSecurityGroup?: number; /** * <p>是否包含独享集群详细信息,可取值:0 - 不包含,1 - 包含。</p> */ WithExCluster?: number; /** * <p>独享集群 ID。</p> */ ExClusterId?: string; /** * <p>实例 ID。</p> */ InstanceIds?: Array<string>; /** * <p>初始化标记,可取值:0 - 未初始化,1 - 初始化。</p> */ InitFlag?: number; /** * <p>是否包含灾备关系对应的实例,可取值:0 - 不包含,1 - 包含。默认取值为1。如果拉取主实例,则灾备关系的数据在DrInfo字段中, 如果拉取灾备实例, 则灾备关系的数据在MasterInfo字段中。灾备关系中只包含部分基本的数据,详细的数据需要自行调接口拉取。</p> */ WithDr?: number; /** * <p>是否包含只读实例,可取值:0 - 不包含,1 - 包含。默认取值为1。</p> */ WithRo?: number; /** * <p>是否包含主实例,可取值:0 - 不包含,1 - 包含。默认取值为1。</p> */ WithMaster?: number; /** * <p>置放群组ID列表。</p> */ DeployGroupIds?: Array<string>; /** * <p>是否以标签键为过滤条件。</p> */ TagKeysForSearch?: Array<string>; /** * <p>金融围拢 ID 。</p> */ CageIds?: Array<string>; /** * <p>标签值</p> */ TagValues?: Array<string>; /** * <p>私有网络字符型vpcId</p> */ UniqueVpcIds?: Array<string>; /** * <p>私有网络字符型subnetId</p> */ UniqSubnetIds?: Array<string>; /** * <p>标签键值<br>请注意,创建中的实例无法查询到标签。</p> */ Tags?: Array<Tag>; /** * <p>数据库代理 IP 。</p> */ ProxyVips?: Array<string>; /** * <p>数据库代理 ID 。</p> */ ProxyIds?: Array<string>; /** * <p>数据库引擎类型。可选值为:InnoDB、RocksDB。</p> */ EngineTypes?: Array<string>; /** * <p>是否获取云盘版实例节点信息,可填:true 或 false。默认为 false。</p> */ QueryClusterInfo?: boolean; } /** * CreateDeployGroup返回参数结构体 */ export interface CreateDeployGroupResponse { /** * 置放群组ID。 */ DeployGroupId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateRotationPassword返回参数结构体 */ export interface CreateRotationPasswordResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyCdbProxyAddressDesc请求参数结构体 */ export interface ModifyCdbProxyAddressDescRequest { /** * 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 */ ProxyGroupId: string; /** * 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 */ ProxyAddressId: string; /** * 描述 */ Desc?: string; } /** * 地域售卖配置 */ export interface CdbRegionSellConf { /** * 地域中文名称 */ RegionName: string; /** * 所属大区 */ Area: string; /** * 是否为默认地域 */ IsDefaultRegion: number; /** * 地域名称 */ Region: string; /** * 地域的可用区售卖配置 */ RegionConfig: Array<CdbZoneSellConf>; } /** * 云盘版 RW 节点的配置。 */ export interface ReadWriteNode { /** * RW 节点所在可用区。 */ Zone: string; /** * 升级云盘版实例时,如果要调整只读节点可用区,需要指定节点 ID。 */ NodeId?: string; } /** * DescribeRoGroups请求参数结构体 */ export interface DescribeRoGroupsRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; } /** * DescribeInstanceUpgradeType返回参数结构体 */ export interface DescribeInstanceUpgradeTypeResponse { /** * <p>实例 ID。</p> */ InstanceId?: string; /** * <p>实例升级类型。Trsf - 迁移升级,InPlace - 原地升级,Topology - 架构升级。</p> */ UpgradeType?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCdbProxyAddress返回参数结构体 */ export interface CreateCdbProxyAddressResponse { /** * <p>异步任务ID</p> */ AsyncRequestId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 用于回档的数据库表名 */ export interface RollbackTableName { /** * 回档前的原数据库表名 */ TableName: string; /** * 回档后的新数据库表名 */ NewTableName: string; } /** * CloseWanService请求参数结构体 */ export interface CloseWanServiceRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。可传入只读组 ID 关闭只读组外网访问。 */ InstanceId: string; /** * 变更云盘版实例只读组时,InstanceId 传实例 ID,需要额外指定该参数表示操作只读组。如果操作读写节点则不需指定该参数。 */ OpResourceId?: string; } /** * OpenAuditService返回参数结构体 */ export interface OpenAuditServiceResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateRoInstanceIp返回参数结构体 */ export interface CreateRoInstanceIpResponse { /** * 只读实例的私有网络的ID。 */ RoVpcId: number; /** * 只读实例的子网ID。 */ RoSubnetId: number; /** * 只读实例的内网IP地址。 */ RoVip: string; /** * 只读实例的内网端口号。 */ RoVport: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CloseSSL请求参数结构体 */ export interface CloseSSLRequest { /** * 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId?: string; /** * 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 */ RoGroupId?: string; } /** * CreateAuditPolicy返回参数结构体 */ export interface CreateAuditPolicyResponse { /** * 审计策略 ID。 */ PolicyId: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 审计日志命中规则模板的基本信息 */ export interface LogRuleTemplateInfo { /** * 模板ID。 */ RuleTemplateId?: string; /** * 规则模板名 */ RuleTemplateName?: string; /** * 告警等级。1-低风险,2-中风险,3-高风险。 */ AlarmLevel?: string; /** * 规则模板变更状态:0-未变更;1-已变更;2-已删除 */ RuleTemplateStatus?: number; } /** * DescribeInstanceParamRecords请求参数结构体 */ export interface DescribeInstanceParamRecordsRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 */ InstanceId: string; /** * 分页偏移量,默认值:0。 */ Offset?: number; /** * 分页大小,默认值:20,最大值为100。 */ Limit?: number; } /** * StopRollback返回参数结构体 */ export interface StopRollbackResponse { /** * 执行请求的异步任务 ID。 */ AsyncRequestId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * CreateCdbProxyAddress请求参数结构体 */ export interface CreateCdbProxyAddressRequest { /** * <p>代理组 ID。可通过 <a href="https://cloud.tencent.com/document/api/236/90585">DescribeCdbProxyInfo</a> 接口获取。</p> */ ProxyGroupId: string; /** * <p>权重分配模式,<br>系统自动分配:&quot;system&quot;, 自定义:&quot;custom&quot;</p> */ WeightMode: string; /** * <p>是否开启延迟剔除,取值:&quot;true&quot; | &quot;false&quot;</p> */ IsKickOut: boolean; /** * <p>最小保留数量,最小取值:0</p> */ MinCount: number; /** * <p>延迟剔除阈值,最小取值:1,范围:1 - 10000,整数。</p> */ MaxDelay: number; /** * <p>是否开启故障转移,取值:&quot;true&quot; | &quot;false&quot;</p> */ FailOver: boolean; /** * <p>是否自动添加RO,取值:&quot;true&quot; | &quot;false&quot;</p> */ AutoAddRo: boolean; /** * <p>是否是只读,取值:&quot;true&quot; | &quot;false&quot;</p> */ ReadOnly: boolean; /** * <p>是否开启事务分离,取值:&quot;true&quot; | &quot;false&quot;</p> */ TransSplit: boolean; /** * <p>读写权重分配</p> */ ProxyAllocation: Array<ProxyAllocation>; /** * <p>私有网络 ID。可通过 <a href="https://cloud.tencent.com/document/product/236/15872">DescribeDBInstances</a> 接口获取。</p> */ UniqVpcId: string; /** * <p>私有子网 ID。可通过 <a href="https://cloud.tencent.com/document/product/236/15872">DescribeDBInstances</a> 接口获取。</p> */ UniqSubnetId: string; /** * <p>是否开启连接池。默认关闭。<br>注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。</p> */ ConnectionPool?: boolean; /** * <p>描述</p> */ Desc?: string; /** * <p>IP 地址。不填则默认为所选 VPC 下支持的随机一个 IP。</p> */ Vip?: string; /** * <p>端口。默认值3306。</p> */ VPort?: number; /** * <p>安全组</p> */ SecurityGroup?: Array<string>; /** * <p>连接池类型。可选值 transaction(事务级别连接池),connection(会话级别连接池),ConnectionPool 为 true 时生效。默认值:connection。</p> */ ConnectionPoolType?: string; /** * <p>是否开启自适应负载均衡。默认关闭。</p> */ AutoLoadBalance?: boolean; /** * <p>接入模式。</p><p>枚举值:</p><ul><li>nearBy: 就近访问</li><li>balance: 均衡分配</li><li>direct_nearby: 纯网络转发就近访问</li><li>direct_balance: 纯网络转发均衡分配</li></ul><p>默认值:nearBy</p> */ AccessMode?: string; } /** * DeleteRotationPassword返回参数结构体 */ export interface DeleteRotationPasswordResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * AnalyzeAuditLogs请求参数结构体 */ export interface AnalyzeAuditLogsRequest { /** * 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId: string; /** * 要分析的日志开始时间,格式为:"2023-02-16 00:00:20"。 */ StartTime: string; /** * 要分析的日志结束时间,格式为:"2023-02-16 00:10:20"。 */ EndTime: string; /** * 聚合维度的排序条件。 */ AggregationConditions: Array<AggregationCondition>; /** * 已废弃。 * @deprecated */ AuditLogFilter?: AuditLogFilter; /** * 该过滤条件下的审计日志结果集作为分析日志。 */ LogFilter?: Array<InstanceAuditLogFilters>; } /** * ModifyBackupEncryptionStatus返回参数结构体 */ export interface ModifyBackupEncryptionStatusResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeInstanceParams请求参数结构体 */ export interface DescribeInstanceParamsRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 */ InstanceId: string; } /** * DescribeRoMinScale返回参数结构体 */ export interface DescribeRoMinScaleResponse { /** * 内存规格大小, 单位为:MB。 */ Memory: number; /** * 磁盘规格大小, 单位为:GB。 */ Volume: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * StopDBImportJob返回参数结构体 */ export interface StopDBImportJobResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 代理节点权重分布 */ export interface ProxyAllocation { /** * 代理节点所属地域 */ Region: string; /** * 代理节点所属可用区 */ Zone: string; /** * 代理实例分布 */ ProxyInstance: Array<ProxyInst>; } /** * StopCpuExpand请求参数结构体 */ export interface StopCpuExpandRequest { /** * 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId: string; } /** * DescribeInstancePasswordComplexity请求参数结构体 */ export interface DescribeInstancePasswordComplexityRequest { /** * 实例ID */ InstanceId: string; } /** * ModifyDBInstanceName请求参数结构体 */ export interface ModifyDBInstanceNameRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 */ InstanceId: string; /** * 修改后的实例名称,仅支持数字,英文大小写字母、中文以及特殊字符-_./()[]()+=::@ 且长度不能超过60。 */ InstanceName: string; } /** * tag信息单元 */ export interface TagInfoUnit { /** * 标签键 */ TagKey?: string; /** * 标签值 */ TagValue?: string; } /** * ModifyAuditRule返回参数结构体 */ export interface ModifyAuditRuleResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeAuditRules请求参数结构体 */ export interface DescribeAuditRulesRequest { /** * 审计规则 ID。 */ RuleId?: string; /** * 审计规则名称。支持按审计规则名称进行模糊匹配查询。 */ RuleName?: string; /** * 分页大小参数。默认值为 20,最小值为 1,最大值为 100。 */ Limit?: number; /** * 分页偏移量。默认值为0。 */ Offset?: number; } /** * UpgradeDBInstanceEngineVersion返回参数结构体 */ export interface UpgradeDBInstanceEngineVersionResponse { /** * <p>异步任务 ID,可使用 <a href="https://cloud.tencent.com/document/api/236/20410">查询异步任务的执行结果</a> 获取其执行情况。</p> */ AsyncRequestId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 结构化的错误日志详情 */ export interface ErrlogItem { /** * 错误发生时间。时间戳,秒级 */ Timestamp?: number; /** * 错误详情 */ Content?: string; } /** * 代理组详情 */ export interface ProxyGroupInfo { /** * 代理组ID */ ProxyGroupId?: string; /** * 代理版本 */ ProxyVersion?: string; /** * 代理支持升级版本 */ SupportUpgradeProxyVersion?: string; /** * 代理状态。0 - 初始化中,1 - 在线中,2 - 在线中-读写分离中,3 - 下线,4 - 销毁。 */ Status?: string; /** * 代理任务状态,Upgrading - 升级中,UpgradeTo - 升级待切换,UpgradeSwitching - 升级切换中,ProxyCreateAddress - 配置地址中,ProxyModifyAddress - 修改地址中,ProxyCloseAddress - 关闭地址中。 */ TaskStatus?: string; /** * 代理组节点信息 */ ProxyNode?: Array<ProxyNode>; /** * 代理组地址信息 */ ProxyAddress?: Array<ProxyAddress>; /** * 连接池阈值 */ ConnectionPoolLimit?: number; /** * 支持创建地址 */ SupportCreateProxyAddress?: boolean; /** * 支持升级代理版本所需的cdb版本 */ SupportUpgradeProxyMysqlVersion?: string; } /** * AssociateSecurityGroups返回参数结构体 */ export interface AssociateSecurityGroupsResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeCPUExpandStrategyInfo返回参数结构体 */ export interface DescribeCPUExpandStrategyInfoResponse { /** * 策略类型。输出值:auto、manual、timeInterval、period。 说明:1. auto 表示自动扩容。2. manual 表示自定义扩容,扩容时间为立即生效。3. timeInterval 表示自定义扩容,扩容时间为按时间段。4. period 表示自定义扩容,扩容时间为按周期。5. 如果返回为 NULL 说明尚未开通弹性扩容策略。 注意:此字段可能返回 null,表示取不到有效值。 */ Type?: string; /** * 自定义扩容,且扩容时间为立即生效时的 CPU。Type 为 manual 时有效。 注意:此字段可能返回 null,表示取不到有效值。 */ ExpandCpu?: number; /** * 自动扩容策略。Type 为 auto 时有效。 注意:此字段可能返回 null,表示取不到有效值。 */ AutoStrategy?: AutoStrategy; /** * 按周期扩容策略。当 Type 为 period 时有效。 */ PeriodStrategy?: PeriodStrategy; /** * 按时间段扩容策略。当 Type 为 timeInterval 时有效。 */ TimeIntervalStrategy?: TimeIntervalStrategy; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 权重分配规则 */ export interface Rule { /** * 划分上限 */ LessThan?: number; /** * 权重 */ Weight?: number; } /** * 审计策略 */ export interface AuditPolicy { /** * 审计策略 ID。 */ PolicyId?: string; /** * 审计策略的状态。可能返回的值为: "creating" - 创建中; "running" - 运行中; "paused" - 暂停中; "failed" - 创建失败。 */ Status?: string; /** * 数据库实例 ID。 */ InstanceId?: string; /** * 审计策略创建时间。格式为 : "2019-03-20 17:09:13"。 */ CreateTime?: string; /** * 审计策略最后修改时间。格式为 : "2019-03-20 17:09:13"。 */ ModifyTime?: string; /** * 审计策略名称。 */ PolicyName?: string; /** * 审计规则 ID。 */ RuleId?: string; /** * 审计规则名称。 */ RuleName?: string; /** * 数据库实例名称 */ InstanceName?: string; } /** * 代理节点 */ export interface ProxyNode { /** * 代理节点ID */ ProxyId?: string; /** * CPU核数 */ Cpu?: number; /** * 内存大小,单位为 MB。 */ Mem?: number; /** * 节点状态,0 - 初始化中,1 - 在线中,2 - 下线中,3 - 销毁中,4 - 故障恢复中,5 - 节点故障,6 - 切换中。 */ Status?: string; /** * 代理节点可用区 */ Zone?: string; /** * 代理节点地域 */ Region?: string; /** * 连接数 */ Connection?: number; } /** * DescribeCdbZoneConfig返回参数结构体 */ export interface DescribeCdbZoneConfigResponse { /** * 售卖规格和地域信息集合 */ DataResult?: CdbZoneDataResult; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * 云盘版的 RO 节点配置。 */ export interface ReadonlyNode { /** * 是否分布在随机可用区。传入YES表示随机可用区。否则使用Zone指定的可用区。 */ IsRandomZone?: string; /** * 指定该节点分布在哪个可用区。 */ Zone?: string; /** * 升级云盘版实例时,如果要调整只读节点可用区,需要指定节点 ID。 */ NodeId?: string; } /** * DescribeTables请求参数结构体 */ export interface DescribeTablesRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; /** * 数据库的名称。 */ Database: string; /** * 记录偏移量,默认值为0。 */ Offset?: number; /** * 单次请求返回的数量,默认值为20,最大值为5000。 */ Limit?: number; /** * 匹配数据库表名的正则表达式,规则同 MySQL 官网 */ TableRegexp?: string; } /** * UpgradeDBInstance请求参数结构体 */ export interface UpgradeDBInstanceRequest { /** * <p>实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同,可使用 <a href="https://cloud.tencent.com/document/api/236/15872">查询实例列表</a> 接口获取,其值为输出参数中字段 InstanceId 的值。</p> */ InstanceId: string; /** * <p>升级后的内存大小,单位:MB,为保证传入 Memory 值有效,请使用 <a href="https://cloud.tencent.com/document/product/236/17229">获取云数据库可售卖规格</a> 接口获取可升级的内存规格。<br>说明:如果进行迁移业务,请一定填写实例规格(CPU、内存),不然系统会默认以最小允许规格传参。</p> */ Memory: number; /** * <p>升级后的硬盘大小,单位:GB,为保证传入 Volume 值有效,请使用 <a href="https://cloud.tencent.com/document/product/236/17229">获取云数据库可售卖规格</a> 接口获取可升级的硬盘范围。</p> */ Volume: number; /** * <p>数据复制方式,支持值包括:0 - 异步复制,1 - 半同步复制,2 - 强同步复制,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。</p> */ ProtectMode?: number; /** * <p>部署模式,默认为 0,支持值包括:0 - 单可用区部署,1 - 多可用区部署,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。</p> */ DeployMode?: number; /** * <p>备库1的可用区信息,默认和实例的 Zone 参数一致,升级主实例为多可用区部署时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。可通过 <a href="https://cloud.tencent.com/document/product/236/17229">获取云数据库可售卖规格</a> 接口查询支持的可用区。</p> */ SlaveZone?: string; /** * <p>主实例数据库引擎版本,支持值包括:5.5、5.6、5.7、8.0。<br>说明:升级数据库版本请使用 <a href="https://cloud.tencent.com/document/api/236/15870">UpgradeDBInstanceEngineVersion</a> 接口。</p> */ EngineVersion?: string; /** * <p>切换访问新实例的方式,默认为 0。支持值包括:0 - 立刻切换,1 - 时间窗切换;当该值为 1 时,升级过程中,切换访问新实例的流程将会在时间窗内进行,或者用户主动调用接口 <a href="https://cloud.tencent.com/document/product/236/15864">切换访问新实例</a> 触发该流程。</p> */ WaitSwitch?: number; /** * <p>备库2的可用区信息,默认为空,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。可通过 <a href="https://cloud.tencent.com/document/product/236/17229">获取云数据库可售卖规格</a> 接口查询支持的可用区。<br>备注:如您要将三节点降级至双节点,将该参数设置为空值即可实现。</p> */ BackupZone?: string; /** * <p>实例类型,默认为 master,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。</p> */ InstanceRole?: string; /** * <p>实例隔离类型。支持值包括: &quot;UNIVERSAL&quot; - 通用型实例, &quot;EXCLUSIVE&quot; - 独享型实例, &quot;BASIC&quot; - 基础版实例。</p> */ DeviceType?: string; /** * <p>升级后的实例cpu核数,如果不传将根据 Memory 指定的内存值自动填充最小允许规格的cpu值。<br>说明:如果进行迁移业务,请一定填写实例规格(CPU、内存),不然系统会默认以最小允许规格传参。</p> */ Cpu?: number; /** * <p>是否极速变配。0-普通升级,1-极速变配,2 极速优先。选择极速变配会根据资源状况校验是否可以进行极速变配,满足条件则进行极速变配,不满足条件会返回报错信息。</p> */ FastUpgrade?: number; /** * <p>延迟阈值。取值范围1~10,默认值为10。</p> */ MaxDelayTime?: number; /** * <p>是否跨区迁移。0-普通迁移,1-跨区迁移,默认值为0。该值为1时支持变更实例主节点可用区。</p> */ CrossCluster?: number; /** * <p>主节点可用区,该值仅在跨区迁移时生效。仅支持同地域下的可用区进行迁移。</p> */ ZoneId?: string; /** * <p>针对跨集群搬迁场景,选择同可用区RO的处理逻辑。together-同可用区RO跟随主实例迁移至目标可用区(默认选项),severally-同可用区RO保持原部署模式、不迁移至目标可用区。</p> */ RoTransType?: string; /** * <p>云盘版节点拓扑配置。</p> */ ClusterTopology?: ClusterTopology; /** * <p>检查原地升级是否需要重启,1 检查, 0 不检查。如果值为1,检查为原地升级需要重启,则会停止升级并进行返回提示,如果为原地升级不重启,则正常执行升级流程。</p> */ CheckFastUpgradeReboot?: number; /** * <p>数据校验敏感度,非极速变配时使用此参数,敏感度根据当前实例规格计算迁移过程中的数据对比使用的cpu资源<br>对应的选项为: &quot;high&quot;、&quot;normal&quot;、&quot;low&quot;,默认为空<br>参数详解,:<br>&quot;high&quot;: 对应控制台中的高,数据库负载过高不建议使用<br>&quot;normal&quot;:对应控制台中的标准<br>&quot;low&quot;:对应控制台中的低</p> */ DataCheckSensitive?: string; /** * <p>备库 3 的可用区信息,默认为空,购买四节点主实例时可指定该参数。</p> */ FourthZone?: string; } /** * ModifyParamTemplate请求参数结构体 */ export interface ModifyParamTemplateRequest { /** * 模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 */ TemplateId: number; /** * 模板名称,仅支持数字、英文大小写字母、中文以及特殊字符_-./()()[]+=::@,且长度不能超过60。 */ Name?: string; /** * 模板描述,长度不超过255。 */ Description?: string; /** * 参数列表。 */ ParamList?: Array<Parameter>; } /** * DescribeAuditConfig请求参数结构体 */ export interface DescribeAuditConfigRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; } /** * DescribeBinlogBackupOverview返回参数结构体 */ export interface DescribeBinlogBackupOverviewResponse { /** * 总的日志备份容量,包含异地日志备份(单位为字节)。 */ BinlogBackupVolume?: number; /** * 总的日志备份个数,包含异地日志备份。 */ BinlogBackupCount?: number; /** * 异地日志备份容量(单位为字节)。 */ RemoteBinlogVolume?: number; /** * 异地日志备份个数。 */ RemoteBinlogCount?: number; /** * 归档日志备份容量(单位为字节)。 */ BinlogArchiveVolume?: number; /** * 归档日志备份个数。 */ BinlogArchiveCount?: number; /** * 标准存储日志备份容量(单位为字节)。 */ BinlogStandbyVolume?: number; /** * 标准存储日志备份个数。 */ BinlogStandbyCount?: number; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeDBInstanceLogToCLS返回参数结构体 */ export interface DescribeDBInstanceLogToCLSResponse { /** * 错误日志投递CLS配置 */ ErrorLog?: LogToCLSConfig; /** * 慢日志投递CLS配置 */ SlowLog?: LogToCLSConfig; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * SwitchDBInstanceMasterSlave请求参数结构体 */ export interface SwitchDBInstanceMasterSlaveRequest { /** * 实例 ID。 */ InstanceId: string; /** * 目标从实例。可选值:"first" - 第一备机;"second" - 第二备机。默认值为 "first",仅多可用区实例支持设置为 "second"。 */ DstSlave?: string; /** * 是否强制切换。默认为 False。注意,若设置强制切换为 True,实例存在丢失数据的风险,请谨慎使用。 * @deprecated */ ForceSwitch?: boolean; /** * 是否时间窗内切换。默认为 False,即不在时间窗内切换。注意,如果设置了 ForceSwitch 参数为 True,则该参数不生效。 */ WaitSwitch?: boolean; /** * 集群版实例指定节点 ID 发起主从切换。 */ DstNodeId?: string; } /** * ModifyCdbProxyAddressVipAndVPort请求参数结构体 */ export interface ModifyCdbProxyAddressVipAndVPortRequest { /** * 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 */ ProxyGroupId: string; /** * 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 */ ProxyAddressId: string; /** * 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ UniqVpcId: string; /** * 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ UniqSubnetId: string; /** * IP 地址。若不填写则自动分配子网下的可用 IP。 */ Vip?: string; /** * 端口。默认值3306,取值范围:1024 - 65535。 */ VPort?: number; /** * 旧 IP 地址回收时间。单位:小时,默认值:24,取值范围:0 - 168。 */ ReleaseDuration?: number; } /** * ModifyAutoRenewFlag请求参数结构体 */ export interface ModifyAutoRenewFlagRequest { /** * 实例的 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 说明:可输入多个实例 ID 进行修改,json 格式如下。 [ "cdb-30z11v8s", "cdb-93h11efg" ] */ InstanceIds: Array<string>; /** * 自动续费标记,可取值的有:0 - 不自动续费,1 - 自动续费。 */ AutoRenew: number; } /** * OpenSSL请求参数结构体 */ export interface OpenSSLRequest { /** * 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId?: string; /** * 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 */ RoGroupId?: string; } /** * DeleteDeployGroups请求参数结构体 */ export interface DeleteDeployGroupsRequest { /** * 要删除的置放群组 ID 列表。 */ DeployGroupIds: Array<string>; } /** * DescribeAuditConfig返回参数结构体 */ export interface DescribeAuditConfigResponse { /** * 审计日志保存时长。目前支持的值包括:[0,7,30,180,365,1095,1825]。 */ LogExpireDay?: number; /** * 审计日志存储类型。目前支持的值包括:"storage" - 存储型。 */ LogType?: string; /** * 是否正在关闭审计。目前支持的值包括:"false"-否,"true"-是 */ IsClosing?: string; /** * 是否正在开启审计。目前支持的值包括:"false"-否,"true"-是 */ IsOpening?: string; /** * 审计服务开通时间。 */ CreateTime?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyBackupConfig返回参数结构体 */ export interface ModifyBackupConfigResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * OpenWanService请求参数结构体 */ export interface OpenWanServiceRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。可以传入只读组 ID。 */ InstanceId: string; /** * 变更集群版实例只读组时,InstanceId传实例id,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 */ OpResourceId?: string; } /** * DeleteAuditPolicy返回参数结构体 */ export interface DeleteAuditPolicyResponse { /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeParamTemplateInfo返回参数结构体 */ export interface DescribeParamTemplateInfoResponse { /** * 参数模板 ID。 */ TemplateId?: number; /** * 参数模板名称。 */ Name?: string; /** * 参数模板对应实例版本,可取值:5.5、5.6、5.7、8.0。 */ EngineVersion?: string; /** * 参数模板中的参数数量 */ TotalCount?: number; /** * 参数详情 */ Items?: Array<ParameterDetail>; /** * 参数模板描述 */ Description?: string; /** * 参数模板类型。支持值包括:"HIGH_STABILITY" - 高稳定模板,"HIGH_PERFORMANCE" - 高性能模板。 */ TemplateType?: string; /** * 参数模板引擎。支持值包括:"InnoDB","RocksDB"。 */ EngineType?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeInstanceParams返回参数结构体 */ export interface DescribeInstanceParamsResponse { /** * 实例的参数总数。 */ TotalCount?: number; /** * 参数详情。 */ Items?: Array<ParameterDetail>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DeleteDatabase请求参数结构体 */ export interface DeleteDatabaseRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; /** * 数据库名称,长度不超过64。 */ DBName: string; } /** * 文件上传描述 */ export interface UploadInfo { /** * 文件所有分片数 */ AllSliceNum?: number; /** * 已完成分片数 */ CompleteNum?: number; } /** * DisassociateSecurityGroups请求参数结构体 */ export interface DisassociateSecurityGroupsRequest { /** * 安全组 ID。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/api/236/15854) 接口获取。 */ SecurityGroupId: string; /** * 实例 ID 列表,一个或者多个实例 ID 组成的数组。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceIds: Array<string>; /** * 当传入只读实例 ID 时,默认操作的是对应只读组的安全组。如果需要操作只读实例 ID 的安全组,需要将该入参置为 True,默认为 False。 */ ForReadonlyInstance?: boolean; } /** * 审计规则的过滤条件 */ export interface AuditRuleFilters { /** * 单条审计规则。 */ RuleFilters?: Array<RuleFilters>; } /** * SubmitInstanceUpgradeCheckJob请求参数结构体 */ export interface SubmitInstanceUpgradeCheckJobRequest { /** * 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId: string; /** * 目标数据库版本。 说明:可选值5.6、5.7、8.0,不支持跨版本升级,升级后不支持版本降级。 */ DstMysqlVersion: string; } /** * ModifyLocalBinlogConfig请求参数结构体 */ export interface ModifyLocalBinlogConfigRequest { /** * 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 */ InstanceId: string; /** * 本地 binlog 保留时长。不同实例的可取值如下: 1. 云盘版实例、双节点实例、三节点实例的本地 binlog 保留时长(小时)默认为120,范围:6 - 168。 2. 灾备实例的本地 binlog 保留时长(小时)默认为120,范围:120 - 168。 3. 单节点云盘实例的本地 binlog 保留时长(小时)默认为120,范围:0 - 168。 4. 若双节点实例、三节点实例下无灾备实例,则该主实例的本地 binlog 保留时长(小时)范围是:6 - 168;若双节点实例、三节点实例下有灾备实例,或者要为双节点实例、三节点实例添加灾备实例,为避免同步异常,该主实例的本地 binlog 保留时长(小时)不能设置低于120小时,范围是:120 - 168。 */ SaveHours: number; /** * 本地 binlog 空间使用率,可取值范围:[30,50]。 */ MaxUsage: number; } /** * StartBatchRollback返回参数结构体 */ export interface StartBatchRollbackResponse { /** * 异步任务的请求 ID,可使用此 ID 查询异步任务的执行结果。 */ AsyncRequestId: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyAccountHost返回参数结构体 */ export interface ModifyAccountHostResponse { /** * 异步任务的请求 ID,可使用此 ID 查询异步任务的执行结果。 */ AsyncRequestId?: string; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * DescribeRollbackRangeTime返回参数结构体 */ export interface DescribeRollbackRangeTimeResponse { /** * 符合查询条件的实例总数。 */ TotalCount?: number; /** * 返回的参数信息。 */ Items?: Array<InstanceRollbackRangeTime>; /** * 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 */ RequestId?: string; } /** * ModifyRoGroupInfo请求参数结构体 */ export interface ModifyRoGroupInfoRequest { /** * RO 组的 ID。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 */ RoGroupId: string; /** * RO 组的详细信息。 */ RoGroupInfo?: RoGroupAttr; /** * RO 组内实例的权重。若修改 RO 组的权重模式为用户自定义模式(custom),则必须设置该参数,且需要设置每个 RO 实例的权重值。RO 实例 ID 可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 */ RoWeightValues?: Array<RoWeightValue>; /** * 是否重新均衡 RO 组内的 RO 实例的负载。支持值包括:1 - 重新均衡负载;0 - 不重新均衡负载。默认值为 0。注意,设置为重新均衡负载时,RO 组内 RO 实例会有一次数据库连接瞬断,请确保应用程序能重连数据库。 */ IsBalanceRoLoad?: number; /** * 废弃参数,无意义。 * @deprecated */ ReplicationDelayTime?: number; } /** * 解隔离任务结果 */ export interface ReleaseResult { /** * 实例 ID。 */ InstanceId?: string; /** * 实例解隔离操作的结果值。返回值为0表示成功。 */ Code?: number; /** * 实例解隔离操作的错误信息。 */ Message?: string; } /** * CreateAuditLogFile请求参数结构体 */ export interface CreateAuditLogFileRequest { /** * 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 */ InstanceId: string; /**