数据结构

最近更新时间: 2026-11-06 00:16:12

ParamDesc

DB参数描述

被如下接口引用:DescribeDBParameters

名称 必选 允许NULL 类型 描述
Constraint 是 否 ParamConstraint 参数限制
示例值:查看
Default 是 否 String 系统默认值
示例值: 1
HaveSetValue 是 否 Bool 是否有设置过值,false:没有设置过值,true:有设置过值。
示例值: true
Param 是 否 String 参数名字
示例值: long_query_time
SetValue 是 是 String 设置过的值,参数生效后,该值和value一样。
示例值: 2
Value 是 否 String 当前参数值
示例值: 1
NeedRestart 是 否 Bool 是否需要重启生效
示例值: true
IsTenantShow 是 否 Bool 租户端是否可见
示例值: true
IsTenantEditable 是 否 Bool 租户端是否可修改
示例值: true

ResourceTags

标签键值对数组

被如下接口引用:DescribeDBInstances

名称 必选 允许NULL 类型 描述
TagKey 否 否 String 标签键key
示例值: label20
TagValue 否 否 String 标签值value
示例值: 20

DBCharsetItem

DB字符集信息

被如下接口引用:DescribeDBCharsets

名称 必选 允许NULL 类型 描述
Version 否 否 String DB版本号
示例值: 5.7.17
DefaultCharset 否 否 String DB默认字符集
示例值: utf8
OptionalCharsets 否 否 String DB可选字符集
示例值: utf8,latin1,gbk,utf8mb4

Flow

任务

被如下接口引用:DescribeUserTasks

名称 必选 允许NULL 类型 描述
AppId 是 否 Int64 应用ID
示例值: 1255000355
CreateTime 是 否 String 创建时间
示例值: 2024-11-13 18:10:22
EndTime 是 否 String 结束时间
示例值: 2024-11-13 18:10:22
ErrMsg 是 否 String 错误信息
示例值: ""
Id 是 否 Int64 任务ID
示例值: 1
InputData 是 否 String 输入数据
示例值: ""
InstanceId 是 否 String 实例 ID,形如:tdsql-ow728lmc
示例值: tdsql-cq3ndzu7
InstanceName 是 否 String 实例名称
示例值: tdsql-cq3ndzu7
RegionId 是 否 Int64 地域ID
示例值: ap-region1
Status 是 否 Int64 状态
示例值: 2
UserTaskType 是 否 Int64 用户任务类型
示例值: 1

TemplateParam

参数模板参数

被如下接口引用:DescribeConfigTemplate、DescribeDefaultConfigTemplate

名称 必选 允许NULL 类型 描述
Constraint 是 否 TemplateParamConstraint 参数约束条件
示例值:查看
Default 是 否 String 参数默认值
示例值: OFF
Param 是 否 String 参数名
示例值: audit_txsql_audit_mode
Value 是 否 String 参数值
示例值: OFF
IsTenantShow 是 否 Bool 租户端是否可见
示例值: true
IsTenantEditable 是 否 Bool 租户端是否可修改
示例值: true

ViewPrivilege

视图权限

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
Database 是 否 String 数据库
示例值: userDB
View 是 否 String 视图名
示例值: view_select
Privileges 是 否 Array of String 权限集合
示例值: [SELECT,UPDATE]

ZonesInfo

可用区信息

被如下接口引用:DescribeSaleInfo

名称 必选 允许NULL 类型 描述
Zone 是 否 String 可用区英文ID
示例值: ap-region1-1
ZoneId 是 否 Int64 可用区数字ID
示例值: 100001
ZoneName 是 否 String 可用区中文名
示例值: region1一区
OnSale 是 否 Bool 是否开启售卖
示例值: true

InstanceInfo

实例信息

被如下接口引用:DescribeInstances

名称 必选 允许NULL 类型 描述
AppId 是 否 Int64 实例对应的AppId
示例值: 1255000112
ClusterName 是 否 String 实例集群名称
示例值: feiteng-5000c
DbVersion 是 否 String 数据库版本
示例值: 5.7
Id 是 否 Int64 实例数字ID
示例值: 148
InstanceId 是 否 String 实例短ID,形如tdsql-hdbirf67
示例值: tdsql-kjh9rw3s
InstanceName 是 否 String 实例名称
示例值: tdsql-kjh9rw3s
NodeCount 是 否 Int64 实例是一主一从还是一主两从。2-一主一从;3-一主两从
示例值: 2
OriginSerialId 是 否 String 实例最初的SerialId,实例扩容后SerialId会变,OriginSerialId表示实例最初的SerialId,不会改变
示例值: set_1727257567_1060380
Region 是 否 String 实例地域
示例值: ap-region1-region-jcctest-ops
SerialId 是 否 String 实例SerialId
示例值: set_1727592726_31460599
Status 是 否 Int64 实例状态信息
示例值: 2
SubnetId 是 否 Int64 实例是VPC网络的话,表示实例所属子网ID,数字ID
示例值: 187
UniqueSubnetId 是 否 String 实例是VPC网络的话,表示实例子网ID,英文短ID
示例值: subnet-ouwji0s0
UniqueVpcId 是 否 String 实例是VPC网络的话,表示实例VPC网络ID,英文短ID
示例值: vpc-grph5bup
Vip 是 否 String 实例Vip
示例值: 10.0.0.1
VpcId 是 否 Int64 实例是VPC网络的话,表示实例VPC网络ID,数字ID
示例值: 13
Vport 是 否 Int64 实例端口
示例值: 3306
ZkName 是 否 String 实例对应的ZK名称
示例值: zk-online
Zone 是 否 String 实例可用区
示例值: ap-region1-region-jcctest-ops-1
MonitorType 是 否 Int64 表示这个实例监控页面如何展示
示例值: 0

DatabaseTable

数据库表信息

被如下接口引用:DescribeDatabaseObjects

名称 必选 允许NULL 类型 描述
Table 是 否 String 表名
示例值: person

LogFileInfo

拉取的日志信息

被如下接口引用:DescribeDBLogFiles

名称 必选 允许NULL 类型 描述
FileName 是 否 String 文件名
示例值: cos_xtrabackup+1731600444+20241115+000724+2334360469+xbstream.lz4
Length 是 否 Uint64 文件长度
示例值: 14000724
Mtime 是 否 Uint64 Log最后修改时间
示例值: 1731600455
Uri 是 否 String 下载Log时用到的统一资源标识符
示例值: /cos_backup%2ftdsql%2fset_1731557469_96057366%2fxtrabackup%2f2024-11-15%2fcos_xtrabackup%2b1731600444%2b20241115%2b000724%2b2334360469%2bxbstream.lz4?sign=

Permission

描述对资源权限,仅内部使用。

被如下接口引用:AuthenticateCAM

名称 必选 允许NULL 类型 描述
IsPermitted 是 否 Int64 是否有权限,1 - 有权限, 0 - 无权限
示例值: 1
Resource 是 否 String 资源对象
示例值: *

ParamConstraint

参数约束

被如下接口引用:DescribeDBParameters

名称 必选 允许NULL 类型 描述
Enum 否 否 String 约束类型为enum时的可选值列表
示例值: ALL,OFF,FILTER
Range 否 是 ConstraintRange 约束类型为section时的范围
示例值:查看
String 是 否 String 约束类型为string时的可选值列表
示例值: REAL_AS_FLOAT,PIPES_AS_CONCAT
Type 是 否 String 约束类型,如枚举enum,区间section
示例值: enum

ProxyConfigParam

网关配置参数

被如下接口引用:DescribeInstanceProxyConfig

名称 必选 允许NULL 类型 描述
Param 是 否 String 配置参数名称
示例值: server.meta_cluster.timeout
Value 是 否 String 配置参数值
示例值: 1
Default 是 否 String 参数默认值
示例值: 1
Description 是 否 String 参数描述
示例值: The Meta Cluster Timeout
NeedRestart 是 否 Bool 是否需要重启生效
示例值: true
Constraint 是 否 ProxyConstraint 参数限制
示例值:查看

NewRefineBackupConfig

新精细化备份参数

被如下接口引用:DescribeBackupConfigs、ModifyBackupConfigs

名称 必选 允许NULL 类型 描述
EnableBackupPolicy 是 否 Bool 是否开启备份策略
示例值: true
BeginDate 是 否 String 备份开始时间。yy-MM-dd格式
示例值: 2024-11-15
MaxRetentionDays 是 否 Int64 最大保存天数
示例值: 90
Frequency 是 否 String 备份模式,支持:annually,monthly,weekly
示例值: weekly
WeekDays 否 是 Array of String 星期数组,支持:Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday
示例值: [   "Monday",   "Tuesday" ]
BackupCount 否 是 Int64 备份数量,仅在Frequency为annually与monthly时生效。与WeekDays仅填一种。 当mode为annually时,取值范围[1,336] 当mode为monthly时,取值范围[1,28]
示例值: 1

SecurityGroup

安全组详情

被如下接口引用:DescribeDBSecurityGroups、DescribeProjectSecurityGroups

名称 必选 允许NULL 类型 描述
CreateTime 是 否 String 创建时间,时间格式:yyyy-mm-dd hh:mm:ss
示例值: 2024-09-18 16:57:03
Inbound 是 否 Array of Inbound 入站规则。
示例值:查看
Outbound 是 否 Array of Outbound 出站规则。
示例值:查看
ProjectId 是 否 Int64 项目ID
示例值: 0
SecurityGroupId 是 否 String 安全组ID
示例值: sg-4fpjvk6n
SecurityGroupName 是 否 String 安全组名称
示例值: tdsql_safe_22
SecurityGroupRemark 是 否 String 安全组备注
示例值: tdsql安全组2

DCNReplicaConfig

只读实例的复制配置信息

被如下接口引用:DescribeDBInstanceDetail、DescribeDcnDetail

名称 必选 允许NULL 类型 描述
RoReplicationMode 是 否 String 只读实例的复制模式,枚举值为:START、STOP
示例值: START
DelayReplicationType 是 否 String 延迟复制类型。当RoReplicationMode为 START 时有意义,枚举值为 DEFAULT(按照延迟复制时间进行复制,即界面上显示的正常启动)、DUE_TIME(回放到指定时间点)。
示例值: DEFAULT
DueTime 是 否 Datetime 延迟复制类型为 DUE_TIME 有意义,回放的时间点
示例值: 2006-01-02 15:04:05
ReplicationDelay 是 否 Int64 复制延迟,单位为秒
示例值: 1

Inbound

安全组入站规则

被如下接口引用:DescribeDBSecurityGroups、DescribeProjectSecurityGroups

名称 必选 允许NULL 类型 描述
Action 是 否 String 策略,ACCEPT或者DROP。
示例值: ACCEPT
AddressModule 是 否 String 地址组id代表的地址集合。
示例值: “”
CidrIp 是 否 String 来源Ip或Ip段,例如192.168.0.0/16。
示例值: 0.0.0.0/0
Desc 是 否 String 描述。
示例值: 测试规则
Id 是 否 String 安全组id代表的地址集合。
示例值: “”
IpProtocol 是 否 String 网络协议,支持udp、tcp等。
示例值: ALL
PortRange 是 否 String 端口。
示例值: ALL
ServiceModule 是 否 String 服务组id代表的协议和端口集合。
示例值: “”

Rsip

拉取实例后端RS信息,返回IP和PORT结构体数组

被如下接口引用:DescribeDBInstanceRsip

名称 必选 允许NULL 类型 描述
Ip 是 否 String Ip地址
示例值: 10.0.0.1
Port 是 否 Int64 端口
示例值: 3306

DatabasePrivilege

数据库权限

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
Database 是 否 String 数据库
示例值: userDB
Privileges 是 否 Array of String 权限集合
示例值: [SELECT,UPDATE]

ProcedurePrivilege

存储过程权限

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
Database 是 否 String 数据库
示例值: userDB
Procedure 是 否 String 存储过程名
示例值: proc1
Privileges 是 否 Array of String 权限集合
示例值: [SELECT,UPDATE]

FenceInfoItem

独享资源池信息

被如下接口引用:DescribeAvailableExclusiveGroups

名称 必选 允许NULL 类型 描述
FenceId 是 否 String 独享资源池ID
示例值: feiteng-5000c
FenceName 否 否 String 资源池名称
示例值: feiteng-5000c
Visibility 否 否 Int64 资源池是否所有人可见。0-所有人不可见;1-所有人可见
示例值: 0

RegionInfo

售卖可用区信息

被如下接口引用:DescribeSaleInfo

名称 必选 允许NULL 类型 描述
AvailableChoice 是 否 Array of ZoneChooseInfo 可选择的主可用区和从可用区
示例值:查看
Region 是 否 String 地域英文ID
示例值: ap-region1-region-jcctest-ops
RegionId 是 否 Int64 地域数字ID
示例值: 80000052
RegionName 是 否 String 地域中文名
示例值: region1
ZoneList 是 否 Array of ZonesInfo 可用区列表
示例值:查看

ColumnPrivilege

字段局权限

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
Database 是 否 String 数据库
示例值: userDB
Table 是 否 String 表名
示例值: person
Column 是 否 String 列名
示例值: name
Privileges 是 否 Array of String 权限集合
示例值: [   "ALTER",   "CREATE" ]

DatabaseView

数据库视图信息

被如下接口引用:DescribeDatabaseObjects

名称 必选 允许NULL 类型 描述
View 是 否 String 视图名称
示例值: view_select

ResourceTag

标签对象,包含tagKey & tagValue

被如下接口引用:CreateHourDBInstance、DescribeDBInstanceDetail、DescribeDBRollbackInstances

名称 必选 允许NULL 类型 描述
TagKey 否 否 String 标签键key
示例值: project
TagValue 否 否 String 标签值value
示例值: newproject

DBBackupTimeConfig

云数据库实例备份时间配置信息

被如下接口引用:DescribeBackupTime

名称 必选 允许NULL 类型 描述
EndBackupTime 是 否 String 每天备份执行的区间的结束时间,格式 mm:ss,形如 23:00
示例值: 2024-11-13 18:10:22
InstanceId 是 否 String 实例 ID
示例值: tdsql-cq3ndzu7
StartBackupTime 是 否 String 每天备份执行的区间的开始时间,格式 mm:ss,形如 22:00
示例值: 2024-11-13 00:10:22

TablePrivilege

表权限

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
Database 是 否 String 数据库
示例值: userDB
Table 是 否 String 表名
示例值: user
Privileges 是 否 Array of String 权限集合
示例值: ['SELECT']

ConstraintRange

约束类型值的范围

被如下接口引用:DescribeDBParameters、DescribeInstanceProxyConfig

名称 必选 允许NULL 类型 描述
Max 是 否 String 约束类型为section时的最大值
示例值: 1000
Min 是 否 String 约束类型为section时的最小值
示例值: 10

Outbound

安全组出站规则

被如下接口引用:DescribeDBSecurityGroups、DescribeProjectSecurityGroups

名称 必选 允许NULL 类型 描述
Action 是 否 String 策略,ACCEPT或者DROP。
示例值: ACCEPT
AddressModule 是 否 String 地址组id代表的地址集合。
示例值: ""
CidrIp 是 否 String 来源Ip或Ip段,例如192.168.0.0/16。
示例值: 0.0.0.0/0
Desc 是 否 String 描述。
示例值: 测试规则
Id 是 否 String 安全组id代表的地址集合。
示例值: “”
IpProtocol 是 否 String 网络协议,支持udp、tcp等。
示例值: ALL
PortRange 是 否 String 端口。
示例值: ALL
ServiceModule 是 否 String 服务组id代表的协议和端口集合。
示例值: “”

TemplateParamConstraint

参数模板参数约束条件

被如下接口引用:DescribeConfigTemplate、DescribeDefaultConfigTemplate

名称 必选 允许NULL 类型 描述
Enum 是 否 String 约束枚举
示例值: ALL,OFF,FILTER
Range 是 是 TemplateConstraintRange 约束范围
示例值:查看
Str 是 否 String 约束字符串
示例值: ANSI_QUOTES,IGNORE_SPACE,ONLY_FULL_GROUP_BY
Type 是 否 String 约束类型
示例值: enum

ZoneChooseInfo

分片节点可用区选择

被如下接口引用:DescribeSaleInfo

名称 必选 允许NULL 类型 描述
MasterZone 是 否 ZonesInfo 主可用区
示例值:查看
SlaveZones 是 否 Array of ZonesInfo 可选的从可用区
示例值:查看

GlobalConfigs

后端全局参数

被如下接口引用:DescribeGlobalConfigs

名称 必选 允许NULL 类型 描述

InstanceSpec

按机型归类的实例可售卖规格信息

被如下接口引用:DescribeDBInstanceSpecs

名称 必选 允许NULL 类型 描述
Machine 是 否 String 设备型号
示例值: ST-80
SpecInfos 是 否 Array of SpecConfigInfo 该机型对应的可售卖规格列表
示例值:查看

DatabaseProcedure

数据库存储过程信息

被如下接口引用:DescribeDatabaseObjects

名称 必选 允许NULL 类型 描述
Proc 是 否 String 存储过程名称
示例值: Proc

DBRollbackInstance

回档实例列表参数。

被如下接口引用:DescribeDBRollbackInstances

名称 必选 允许NULL 类型 描述
InstanceId 否 否 String 实例ID。
示例值: tdsql-kjh9rw3s
InstanceName 否 否 String 实例名称。
示例值: tdsql-kjh9rw3s
Status 否 否 Int64 实例状态:0 创建中,1 流程处理中, 2 运行中,3 实例未初始化,-1 实例已隔离,4 实例初始化中,5 实例删除中,6 实例重启中,7 数据迁移中
示例值: 2
StatusDesc 否 否 String 状态中文描述。
示例值: 运行中
Region 否 否 String 地域描述。
示例值: ap-region1-region-jcctest-ops
Zone 否 否 String 实例所在可用区。
示例值: ap-region1-region-jcctest-ops-1
ProjectId 否 否 Int64 项目ID。
示例值: 0
NodeCount 否 否 Int64 节点数,2 为一主一从, 3 为一主二从。
示例值: 2
Cpu 否 否 Int64 Cpu核数。
示例值: 1
Memory 否 否 Int64 内存大小,单位 GB。
示例值: 2
Storage 否 否 Int64 存储大小,单位 GB。
示例值: 10
VpcId 否 否 String 字符串型的私有网络ID。
示例值: vpc-grph5bup
SubnetId 否 否 String 字符串型的私有网络子网ID。
示例值: subnet-ouwji0s0
Vip 否 否 String 内网IP。
示例值: 10.0.0.10
Vport 否 否 Int64 内网端口。
示例值: 3306
Ipv6Flag 否 否 Int64 Ipv6标志。
示例值: 0
Vip6 否 否 String 内网IPv6。
示例值: FC00:0000:130F:0000:0000:09C0:876A:130B
PayMode 否 否 String 付费模式。
示例值: postpaid
PeriodEndTime 否 否 String 到期时间。
示例值: 2024-11-13 18:10:22
RollbackTime 否 否 String 实例回档时间。
示例值: 2024-11-13 18:10:22
CreateTime 否 否 String 实例创建时间。
示例值: 2024-11-11 18:10:22
IsTmp 否 否 Int64 1:临时实例,0:非临时实例。
示例值: 0
ResourceTags 否 否 Array of ResourceTag 实例标签信息。
示例值:查看
AccountName 否 否 String 实例创建人账号名称
示例值: johnnylli@test.com
AccountId 否 否 Uint64 实例创建人账号ID(uin)
示例值: 110000004633
Vipv6 是 是 String 实例虚IPv6
示例值: FC00:0000:130F:0000:0000:09C0:876A:130B
ExtraNetInfos 否 否 Array of ExtraNetInfo 备用网络信息
示例值:查看

ZoneVpcClusterMapper

vpcgw集群绑定关系

被如下接口引用:DescribeClusterBindings

名称 必选 允许NULL 类型 描述
Id 是 否 Int64 vpcgw集群绑定关系id
示例值: 1
Zone 是 否 String 可用区id
示例值: region1
VpcGwId 是 否 String vpc集群id
示例值: vpcgw-123456

DatabaseFunction

数据库函数信息

被如下接口引用:DescribeDatabaseObjects

名称 必选 允许NULL 类型 描述
Func 是 否 String 函数名称
示例值: CONCAT

Account

用户信息

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
User 是 否 String 用户名
示例值: tdsqlsys_normal
Host 是 否 String 用户允许的访问 host,用户名+host唯一确定一个账号。
示例值: %

NodeInfo

描述实例的各个DB节点信息

被如下接口引用:DescribeDBInstanceDetail、DescribeInstanceNodeInfo

名称 必选 允许NULL 类型 描述
NodeId 是 否 String DB节点ID
示例值: a8cc5889fb3d
Role 是 否 String DB节点角色,取值为master或者slave
示例值: master

TmpInstance

临时实例

被如下接口引用:DescribeDBTmpInstances

名称 必选 允许NULL 类型 描述
AppId 是 是 Int64 应用ID
示例值: 1255000112
CreateTime 是 是 Datetime 创建时间
示例值: 2024-11-13 18:10:22
InstanceId 是 是 String 实例 ID,形如:tdsql-ow728lmc。
示例值:  tdsql-cq3ndzu7
InstanceRemark 是 是 String 实例备注
示例值: 业务实例
Ipv6Flag 是 是 Uint64 实例IPv6标志
示例值: 0
PeriodEndTime 是 是 Datetime 有效期结束时间
示例值: 2024-11-13 18:10:22
Region 是 是 String 实例所在地域
示例值: ap-region1
SrcInstanceId 是 是 String 源实例 ID,形如:tdsql-ow728lmc。
示例值:  tdsql-cq3ndzu9
Status 是 是 Int64 实例状态:0 创建中,1 流程处理中, 2 运行中,3 实例未初始化,-1 实例已隔离,4 实例初始化中,5 实例删除中,6 实例重启中,7 数据迁移中
示例值: 2
StatusDesc 是 是 String 实例状态描述
示例值: 运行中
TempType 是 是 Int64 0:非临时实例 ,1:无效临时实例, 2:回档成功的有效临时实例
示例值: 2
Vip 是 是 String 实例虚IP
示例值: 10.0.0.1
Vipv6 是 是 String 实例虚IPv6
示例值: FC00:0000:130F:0000:0000:09C0:876A:130B
Vport 是 是 Int64 实例虚端口
示例值: 3306
Zone 是 是 String 实例所在可用区
示例值: ap-region1-1

DBParamValue

云数据库参数信息。

被如下接口引用:CreateHourDBInstance、InitDBInstances、ModifyDBParameters

名称 必选 允许NULL 类型 描述
Param 是 否 String 参数名称
示例值: character_set_server
Value 是 否 String 参数值
示例值: utf8mb4

InstanceConfig

实例配置

被如下接口引用:DescribeConfigHistories

名称 必选 允许NULL 类型 描述
Id 是 否 Int64 实例配置ID,形如:1
示例值: 385
ModTime 是 否 String 修改时间
示例值: 2024-11-15 15:44:37
ParamName 是 否 String 参数名称
示例值: default_collation_for_utf8mb4
ParamNewValue 是 否 String 修改后参数值
示例值: utf8mb4_0900_ai_ci
ParamOldValue 是 否 String 修改前参数值
示例值: utf8mb4_general_ci
Status 是 否 Int64 修改状态, 0:成功, -1:失败, -2:值非法
示例值: 0
Type 是 否 String 参数类型, 当前支持:Database,Proxy
示例值: Database

ParamModifyResult

修改参数结果

被如下接口引用:ModifyDBParameters

名称 必选 允许NULL 类型 描述
Code 是 否 Int64 参数修改结果。0表示修改成功;-1表示修改失败;-2表示该参数值非法
示例值: 0
Param 是 否 String 修改参数名字
示例值: audit_txsql_audit_mode

DcnDetailItem

DCN详情条目

被如下接口引用:DescribeDcnDetail

名称 必选 允许NULL 类型 描述
DcnFlag 是 否 Int64 实例DCN标志,1-主,2-备
示例值: 0
DcnStatus 是 否 Int64 实例DCN状态,0-无,1-创建中,2-同步中,3-已断开
示例值: 0
InstanceId 是 否 String 实例ID
示例值: tdsql-kjh9rw3s
InstanceName 是 否 String 实例名称
示例值: tdsql-kjh9rw3s
Region 是 否 String 实例地域
示例值: ap-region1-region-jcctest-ops
Status 是 否 Int64 实例状态:0 创建中,1 流程处理中, 2 运行中,3 实例未初始化,-1 实例已隔离,4 实例初始化中,5 实例删除中,6 实例重启中,7 数据迁移中
示例值: 2
StatusDesc 是 否 String 实例状态描述
示例值: 运行中
Vip 是 否 String 实例IP地址
示例值: 10.0.0.10
Vipv6 是 否 String 实例IPv6地址
示例值: FC00:0000:130F:0000:0000:09C0:876A:130B
Vport 是 否 Int64 实例端口
示例值: 3306
Zone 是 否 String 实例可用区
示例值: ap-region1-region-jcctest-ops-1
ReplicaConfig 否 是 DCNReplicaConfig 只读实例复制配置信息,仅当实例为DCN备时有效
示例值:查看
ReplicaStatus 否 是 DCNReplicaStatus 只读实例复制状态,仅当实例为DCN备时有效
示例值:查看
EncryptStatus 是 否 Int64 KMS开启状态,0-未开启,1-已开启
示例值: 0
ExtraNetInfos 否 否 Array of ExtraNetInfo 备用网络信息
示例值:查看

ProxyConstraint

proxy参数约束

被如下接口引用:DescribeInstanceProxyConfig

名称 必选 允许NULL 类型 描述
Type 是 否 String 约束类型,如枚举enum,区间section
示例值: section
Range 否 是 ConstraintRange 约束类型为section时的范围
示例值:查看
Enum 否 否 String 约束类型为enum时的可选值列表
示例值: ALL,OFF,FILTER

CommonDBInstance

通用数据库实例

被如下接口引用:DescribeCommonDBInstances

名称 必选 允许NULL 类型 描述
AppId 是 是 Int64 应用Id
示例值: 1255000355
CreateTime 是 是 String 实例创建时间
示例值: 2024-11-13 18:10:22
InstanceId 是 是 String 实例ID
示例值: tdsql-cq3ndzu7
InstanceName 是 是 String 实例名称
示例值: tdsql-cq3ndzu7
NetType 是 是 Int64 0-基础网络,1-VPC网络
示例值: 1
PayMode 是 是 Int64 计费类型,1-包年包月,0-按量计费
示例值: 0
ProjectId 是 是 Int64 项目Id
示例值: 1
Region 是 是 String 地域
示例值: ap-region1
Status 是 是 String 实例状态:0 创建中,1 流程处理中, 2 运行中,3 实例未初始化,-1 实例已隔离,4 实例初始化中,5 实例删除中,6 实例重启中,7 数据迁移中。
示例值: 2
SubnetId 是 是 String 子网统一Id
示例值: subnet-2t690uja
Vips 是 是 Array of String VPC网络IP
示例值: [10.0.0.1]
VpcId 是 是 String VPC网络统一Id
示例值: vpc-dwc2uyn9
Vport 是 是 Int64 VPC网络端口
示例值: 3306
Zone 是 是 String 可用区
示例值: ap-region1-1

DCNReplicaStatus

描述只读实例的复制状态

被如下接口引用:DescribeDBInstanceDetail、DescribeDcnDetail

名称 必选 允许NULL 类型 描述
Status 是 否 String 该只读实例当前的复制状态,枚举值:RUNNING(正在复制中)、PAUSED(已暂停复制)、REACHED_DUE_TIME(已复制到指定时间点)
示例值: START
Delay 是 否 Int64 该只读实例相对于主实例的延迟情况,单位为秒
示例值: 1

TemplateConstraintRange

参数模板中数值型参数的范围约束

被如下接口引用:DescribeConfigTemplate、DescribeDefaultConfigTemplate

名称 必选 允许NULL 类型 描述
Max 是 否 String 约束范围最大值
示例值: 65535
Min 是 否 String 约束范围最小值
示例值: 1

ConfigParam

配置模板参数

被如下接口引用:CreateConfigTemplate、ModifyConfigTemplate

名称 必选 允许NULL 类型 描述
Param 是 否 String 参数名
示例值: audit_txsql_audit_mode
Value 是 否 String 参数值
示例值: OFF

ConfigValue

用户配置键值对

被如下接口引用:ModifyAccountConfig

名称 必选 允许NULL 类型 描述
Config 否 否 String 配置名
示例值: max_user_connections
Value 否 否 String 配置值
示例值: 1024

TableColumn

数据库列信息

被如下接口引用:DescribeDatabaseTable

名称 必选 允许NULL 类型 描述
Col 是 否 String 列名称
示例值: user
Type 是 否 String 列类型
示例值: string

FunctionPrivilege

函数权限

被如下接口引用:ModifyAccountPrivileges

名称 必选 允许NULL 类型 描述
Database 是 否 String 数据库
示例值: userDB
FunctionName 是 否 String 函数名
示例值: CONCAT
Privileges 是 否 Array of String 权限集合
示例值: [SELECT,UPDATE]

SpecConfigInfo

实例可售卖规格详细信息,创建实例和扩容实例时 Pid+MemSize 唯一确定一种售卖规格,磁盘大小可用区间为[MinDataDisk,MaxDataDisk]

被如下接口引用:DescribeDBInstanceSpecs

名称 必选 允许NULL 类型 描述
Cpu 是 否 Int64 Cpu核数
示例值: 1
Machine 是 否 String 设备型号
示例值: ST-80
MaxStorage 是 否 Int64 数据盘规格最大值,单位 GB
示例值: 1500
Memory 是 否 Int64 内存大小,单位 GB
示例值: 2
MinStorage 是 否 Int64 数据盘规格最小值,单位 GB
示例值: 10
NodeCount 是 否 Int64 节点个数,2 表示一主一从,3 表示一主二从
示例值: 1
Pid 是 否 Int64 产品类型 Id
示例值: 14319
Qps 是 否 Int64 最大 Qps 值
示例值: 2100
SuitInfo 是 否 String 推荐的使用场景
示例值: 日独立用户数上百人的小型应用

TimeSlices

可用备份时间段

被如下接口引用:DescribeBinlogTime

名称 必选 允许NULL 类型 描述
StartTime 否 否 String 开始时间
示例值: 2019-04-06 00:31:10
EndTime 否 否 String 结束时间
示例值: 2019-04-06 14:31:56

Database

数据库信息

被如下接口引用:DescribeDatabases

名称 必选 允许NULL 类型 描述
DbName 是 否 String 数据库名称
示例值: userDB

SlowLogData

慢查询条目信息

被如下接口引用:DescribeDBSlowLogs

名称 必选 允许NULL 类型 描述
CheckSum 是 否 String 语句校验和,用于查询详情
示例值: 4177280352063002725
Db 是 否 String 数据库名称
示例值: query_rewrite
ExampleSql 是 是 String 样例Sql
示例值: select sleep(10); limit 10
FingerPrint 是 否 String 抽象的SQL语句
示例值: select sleep(?); limit ?
LockTimeAvg 是 否 String 平均的锁时间
示例值: 0
LockTimeMax 是 否 String 最大锁时间
示例值: 0
LockTimeMin 是 否 String 最小锁时间
示例值: 0
LockTimeSum 是 否 String 锁时间总和
示例值: 0
QueryCount 是 否 String 查询次数
示例值: 1
QueryTimeAvg 是 否 String 平均查询时间
示例值: 10
QueryTimeMax 是 否 String 最大查询时间
示例值: 10
QueryTimeMin 是 否 String 最小查询时间
示例值: 10
QueryTimeSum 是 否 String 查询时间总和
示例值: 10
RowsExaminedSum 是 否 String 扫描行数
示例值: 0
RowsSentSum 是 否 String 发送行数
示例值: 1
TsMax 是 否 String 最后执行时间
示例值: 2024-11-18 11:11:29
TsMin 是 否 String 首次执行时间
示例值: 2024-11-18 11:11:29
User 是 否 String 帐号
示例值: tdsqlsys_normal
Host 是 否 String 主机
示例值: %

DBAccount

云数据库账号信息

被如下接口引用:DescribeAccounts

名称 必选 允许NULL 类型 描述
CreateTime 是 否 Datetime 创建时间
示例值: 2024-11-13 18:10:22
DelayThresh 是 是 Int64 该字段对只读帐号有意义,表示选择主备延迟小于该值的备机
示例值: 0
Description 是 否 String 用户备注信息
示例值: 测试账号
Host 是 否 String 用户可以从哪台主机登录(对应 MySQL 用户的 host 字段,UserName + Host 唯一标识一个用户,IP形式,IP段以%结尾;支持填入%;为空默认等于%)
示例值: %
ReadOnly 是 否 Int64 只读标记,0:否, 1:该账号的sql请求优先选择备机执行,备机不可用时选择主机执行,2:优先选择备机执行,备机不可用时操作失败。
示例值: 0
UpdateTime 是 否 Datetime 最后更新时间
示例值: 2024-11-13 18:10:22
UserName 是 否 String 用户名
示例值: tdsqlsys_normal
SlaveConst 否 否 Int64 针对只读账号,设置策略是否固定备机,0:不固定备机,即备机不满足条件与客户端不断开连接,Proxy选择其他可用备机,1:备机不满足条件断开连接,确保一个连接固定备机。
示例值: 0
MaxUserConnections 是 否 Int64 最大用户连接数量
示例值: 2

ReservedNetResources

尚未回收的网络资源

被如下接口引用:DescribeDBInstanceDetail

名称 必选 允许NULL 类型 描述
VpcId 否 否 String 保留的私有网络ID
示例值: vpc-1iy15ozp
SubnetId 否 否 String 保留的子网ID
示例值: subnet-l9bprnz2
Vip 否 否 String 保留的私有网络ip
示例值: 10.0.0.1
Vports 否 否 Array of Int64 保留的端口号
示例值: 3306
RecycleTime 否 否 String 回收时间
示例值: 2024-11-13 18:10:22

ConfTemplate

参数模板

被如下接口引用:DescribeConfigTemplates

名称 必选 允许NULL 类型 描述
AppId 是 否 Int64 应用id
示例值: 1255000355
ConfigTemplateId 是 否 Int64 参数模板Id
示例值: 1
TemplateDefault 是 否 String 默认模板
示例值: 8.0.24
TemplateDesc 是 否 String 参数模板描述
示例值: 8.0_temple_mariadb
TemplateName 是 否 String 参数模板名称
示例值: 8.0_temple_mariadb
DbVersionName 是 否 String 数据库版本
示例值: MySQL 8.0

DBEngineInfo

数据库引擎信息

被如下接口引用:DescribeDBEngines

名称 必选 允许NULL 类型 描述
Description 是 否 String 引擎描述
示例值: 完全兼容MySQL 8.0
Name 是 否 String 引擎名称,eg. 基于MariaDB 10.1.9 分支
示例值: MySQL 8.0
Type 是 否 String 引擎类型,MariaDB
Version 是 否 String 引擎版本,eg. 10.1.9
示例值: 8.0

InstanceBackupFileItem

实例备份文件详情

被如下接口引用:DescribeBackupFiles

名称 必选 允许NULL 类型 描述
InstanceId 否 否 String 实例ID
示例值: tdsql-osu5aib2
InstanceName 否 否 String 实例名称
示例值: tdsql-osu5aib2
InstanceStatus 否 否 Int64 实例状态
示例值: 2
ShardId 否 否 String 实例内的分片ID
示例值: “”
FilePath 否 否 String 文件路径
示例值: /backup/binlog+1731514873+20241114+002113+2007817982+binlog.000004.lz4
FileName 否 否 String 文件名称
示例值: binlog+1731514873+20241114+002113+2007817982+binlog.000004.lz4
Url 否 否 String 文件下载链接
示例值: /cos_backup%2ftdsql%2fgroup_1731482011_96057329%2fset_1731482512_5%2fbinlog%2f2024-11-14%2fbinlog%2b1731514873%2b20241114%2b002113%2b2007817982%2bbinlog.000004.lz4?sign=
FileSize 否 否 Int64 文件大小
示例值: 1
BackupType 否 否 String 备份类型,Data:数据备份,Binlog:Binlog备份,Errlog:错误日志,Slowlog:慢日志
示例值: Binlog
ManualBackup 否 否 Int64 手动备份,0:否,1:是
示例值: 0
StartTime 否 否 String 备份开始时间
示例值: 2022-05-10 12:00:00
EndTime 否 否 String 备份结束时间
示例值: 2022-05-10 12:00:00

DBInstance

描述云数据库实例的详细信息。

被如下接口引用:DescribeDBInstances

名称 必选 允许NULL 类型 描述
AppId 是 否 Int64 实例所属应用 ID
示例值: 1255000355
AutoRenewFlag 是 否 Int64 自动续费标志:0 否,1 是
示例值: 0
Cpu 是 否 Int64 实例CPU核数
示例值: 1
CreateTime 是 否 Datetime 实例创建时间,格式为 2006-01-02 15:04:05
示例值: 2024-11-19 10:47:08
DbEngine 是 是 String 数据库引擎
示例值: MySQL
DbVersion 是 是 String 数据库版本
示例值: 8.0
DcnDstNum 是 是 Int64 DCN灾备实例数
示例值: 0
DcnFlag 是 是 Int64 DCN标志,0-无,1-主实例,2-灾备实例
示例值: 0
DcnStatus 是 是 Int64 DCN状态,0-无,1-创建中,2-同步中,3-已断开
示例值: 0
ExclusterId 是 否 String 独享集群ID,为空表示为普通实例
示例值: feiteng-5000c
Id 是 否 Uint64 数字实例ID(过时字段,请勿依赖该值)
示例值: 312
InstanceId 是 否 String 实例 ID,唯一标识一个 TDSQL 实例
示例值: tdsql-cq3ndzu7
InstanceName 是 否 String 实例名称,用户可修改
示例值: tdsql-cq3ndzu7
Ipv6Flag 是 是 Uint64 实例IPv6标志
示例值: 0
IsAuditSupported 是 否 Uint64 该实例是否支持审计。1-支持;0-不支持
示例值: 1
IsEncryptSupported 是 否 Int64 是否支持数据加密。1-支持;0-不支持
示例值: 0
IsTmp 是 否 Uint64 是否临时实例,0为否,非0为是
示例值: 0
Locker 是 是 Int64 实例处于异步任务时的异步任务流程ID
示例值: 0
Machine 是 否 String 机器型号
示例值: ST-80
Memory 是 否 Int64 实例内存大小,单位 GB
示例值: 4
NodeCount 是 否 Uint64 节点数,2为一主一从,3为一主二从
示例值: 2
OriginSerialId 是 否 String 原始实例ID(过时字段,请勿依赖该值)
示例值: set_1727257567_1060380
Paymode 是 是 String 付费模式
示例值: postpaid
PeriodEndTime 是 否 Datetime 实例到期时间,格式为 2006-01-02 15:04:05
示例值: 2024-11-13 18:10:22
Pid 是 否 Int64 产品类型 ID
示例值: 11128
ProjectId 是 否 Int64 实例所属项目 ID
示例值: 1
Qps 是 否 Int64 最大 Qps 值
示例值: 2100
Region 是 否 String 实例所在地域名称,如 ap-region1
示例值: ap-region1
Status 是 否 Int64 实例状态:0 创建中,1 流程处理中, 2 运行中,3 实例未初始化,-1 实例已隔离,4 实例初始化中,5 实例删除中,6 实例重启中,7 数据迁移中。
示例值: 2
StatusDesc 是 是 String 实例目前运行状态描述
示例值: 运行中
Storage 是 否 Int64 实例存储大小,单位 GB
示例值: 10
SubnetId 是 否 Int64 子网 ID,基础网络时为 0
示例值: 1
TdsqlVersion 是 否 String TDSQL 版本信息
示例值: 基于MySQL 5.7.39设计(兼容Mysql 5.7)
Uin 是 否 String 实例所属账号
示例值: 110000002385
UniqueSubnetId 是 否 String 字符串型的私有网络子网ID
示例值: subnet-ouwji0s0
UniqueVpcId 是 否 String 字符串型的私有网络ID
示例值: vpc-grph5bup
UpdateTime 是 否 Datetime 实例最后更新时间,格式为 2006-01-02 15:04:05
示例值: 2024-10-03 14:16:52
Vip 是 否 String 内网 IP 地址
示例值: 10.0.0.9
Vipv6 是 是 String 内网IPv6
示例值: ""
VpcId 是 否 Int64 私有网络 ID,基础网络时为 0
示例值: 67071
Vport 是 否 Int64 内网端口
示例值: 3306
WanDomain 是 否 String 外网访问的域名,公网可解析
示例值: ceshi.cn
WanPort 是 否 Int64 外网端口
示例值: 8888
WanPortIpv6 是 是 Uint64 外网IPv6端口
示例值: 8888
WanStatus 是 否 Int64 外网状态,0-未开通;1-已开通;2-关闭;3-开通中
示例值: 0
WanStatusIpv6 是 是 Uint64 外网IPv6状态,1-支持,0-不支持
示例值: 0
WanVip 是 否 String 外网 IP 地址,公网可访问
示例值: 192.168.1.1
WanVipv6 是 是 String 外网IPv6
示例值: FC00:0000:130F:0000:0000:09C0:876A:130B
Zone 是 否 String 实例所在可用区名称,如 ap-region1-1
示例值: ap-region1-region-jcctest-ops-1
InstanceType 是 是 Int64 1: 主实例(独享型), 2: 主实例, 3: 灾备实例, 4: 灾备实例(独享型)
示例值: 2
CpuArch 否 否 String cpu架构
示例值: x86
AccountName 是 是 String 实例创建人账号名称
示例值: johnnylli@test.com
AccountId 是 是 Int64 实例创建人账号ID(uin)
示例值: 110000002385
StorageUsage 是 否 String 存储空间使用率
示例值: 0.1
SerialId 否 否 String 实例id
示例值: set_1753412640_5509092
ResourceTags 否 否 ResourceTags 标签键值对数组
示例值:查看
DbVersionId 否 否 String 数据库引擎版本
示例值: 5.7
OssId 否 否 String OSS集群ID
示例值: 1
ExclusterName 否 否 String 资源池名称
示例值: Resource_pool1
PlatformProjectId 否 是 String 平台项目ID
示例值: pr-3f3e2f46
PlatformProjectName 否 是 String 平台项目名称
示例值: qta-tdsql-1
ExtraNetInfos 否 否 Array of ExtraNetInfo 备用网络信息
示例值:查看

ExtraNetInfo

备用网络信息

被如下接口引用:CreateHourDBInstance、DescribeDBInstanceDetail、DescribeDBInstances、DescribeDBRollbackInstances、DescribeDcnDetail

名称 必选 允许NULL 类型 描述
ExtraNetId 否 否 Int64 备用网络信息ID
示例值: 1
InstanceId 否 否 Int64 实例数值类型ID
示例值: 1
NetType 否 否 Int64 实例网络类型:1-vpc
示例值: 1
VpcId 否 否 String 私有网络ID
示例值: vpc-dwc2uyn9
SubnetId 否 否 String 子网ID
示例值: subnet-2t690uja
Vip 否 否 String 虚拟IP
示例值: 10.0.0.2
Vport 否 否 Int64 虚拟端口
示例值: 3306
VpcGwId 否 否 String vpc集群ID
示例值: vpc-asdasda