1. 接口描述
接口请求域名： mariadb.api3.fincloud.tencent.com。
本接口(DescribeDBInstanceDetail)用于查询指定实例的详细信息。
默认接口请求频率限制：20次/秒。
接口更新时间：2025-05-11 02:50:33。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribeDBInstanceDetail |
| Version | 是 | 否 | String | 公共参数，本接口取值：2017-03-12 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| InstanceId | 是 | 否 | String | 实例Id形如：tdsql-ow728lmc。 示例值： tdsql-jv8z8fhl |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InstanceId | String | 实例Id 示例值： tdsql-jv8z8fhl |
| InstanceName | String | 实例名称 示例值： tdsql-e9tklsgz |
| Status | Int64 | 实例状态 示例值： 2 |
| StatusDesc | String | 实例目前运行状态描述 示例值： 运行中 |
| Vip | String | 内网 IP 地址 示例值： 192.168.240.44 |
| Vport | Int64 | 内网端口 示例值： 3306 |
| IsTmp | Int64 | 是否临时实例，0为否，非0为是 示例值： 0 |
| NodeCount | Int64 | 节点数，2为一主一从，3为一主二从 示例值： 3 |
| Region | String | 实例所在地域名称，如 ap-region1 示例值： ap-region1 |
| Zone | String | 实例所在可用区名称，如 ap-region1-1 示例值： ap-region1-2 |
| VpcId | String | 字符串型的私有网络Id 示例值： vpc-hqxhp43z |
| SubnetId | String | 字符串型的私有网络子网Id 示例值： subnet-15y3y4eo |
| WanStatus | Int64 | 外网状态，0-未开通；1-已开通；2-关闭；3-开通中；4-关闭中 示例值： 0 |
| WanDomain | String | 外网访问的域名，公网可解析 示例值： ceshi.cn |
| WanVip | String | 外网 IP 地址，公网可访问 示例值： 192.168.1.1 |
| WanPort | Int64 | 外网端口 示例值： 8888 |
| ProjectId | Int64 | 实例所属项目 Id 示例值： 0 |
| TdsqlVersion | String | TDSQL 版本信息 示例值： 基于MariaDB 10.0.10设计(兼容MySQL 5.5) |
| Memory | Int64 | 实例内存大小，单位 GB 示例值： 2 |
| Storage | Int64 | 实例存储大小，单位 GB 示例值： 10 |
| MasterZone | String | 主可用区，如 ap-region1-1 示例值： ap-region1-2 |
| SlaveZones | Array of String | 从可用区列表，如 [ap-region1-2] 示例值： ["ap-region1-2","ap-region1-2"] |
| AutoRenewFlag | Int64 | 自动续费标志：0 否，1 是 示例值： 0 |
| ExclusterId | String | 独享集群Id，普通实例为空 示例值： feiteng-5000c |
| PayMode | String | 付费模式：prepaid 表示预付费 示例值： postpaid |
| CreateTime | Datetime | 实例创建时间，格式为 2006-01-02 15:04:05 示例值： 2020-04-13 15:00:16 |
| IsAuditSupported | Bool | 实例是否支持审计 示例值： true |
| PeriodEndTime | Datetime | 实例到期时间，格式为 2006-01-02 15:04:05 示例值： 2019-12-06 15:00:16 |
| Machine | String | 机型信息 示例值： Z4 |
| StorageUsage | String | 存储空间使用率 示例值： 0.000 |
| LogStorage | Int64 | 日志存储空间大小，单位 GB 示例值： 8 |
| IsEncryptSupported | Int64 | 是否支持数据加密。1-支持；0-不支持 示例值： 0 |
| Vip6 | String | 内网IPv6 示例值： 0 |
| Cpu | Int64 | 实例Cpu核数 示例值： 1 |
| Pid | Int64 | 产品类型ID 示例值： 1002231 |
| Qps | Int64 | 最大QPS 示例值： 2100 |
| Ipv6Flag | Int64 | 是否支持IPv6 示例值： 0 |
| WanVipv6 | String | 外网IPv6地址，公网可访问 示例值： FC00:0000:130F:0000:0000:09C0:876A:130B |
| WanStatusIpv6 | Int64 | 外网状态，0-未开通；1-已开通；2-关闭；3-开通中；4-关闭中 示例值： 0 |
| WanPortIpv6 | Int64 | 外网IPv6端口 示例值： 0 |
| DbEngine | String | 数据库引擎 示例值： Pernoca |
| DbVersion | String | 数据库版本 示例值： 5.7.17 |
| ResourceTags | Array of ResourceTag | 标签信息 示例值：查看 |
| DcnFlag | Int64 | DCN标志，0-无，1-主实例，2-灾备实例 示例值： 1 |
| DcnStatus | Int64 | DCN状态，0-无，1-创建中，2-同步中，3-已断开 示例值： 2 |
| DcnDstNum | Int64 | DCN灾备实例数 示例值： 1 |
| PlatformProjectId | String | 平台项目ID 示例值： pr-49ed23d8 |
| PlatformProjectName | String | 平台项目名称 示例值： qta-tdsql-1 |
| ReplicaConfig | DCNReplicaConfig | 只读实例复制配置信息，仅当实例为DCN备时有效 示例值：查看 |
| ReplicaStatus | DCNReplicaStatus | 只读实例复制状态，仅当实例为DCN备时有效 示例值：查看 |
| InstanceType | Int64 | 1： 主实例（独享型）, 2: 主实例, 3： 灾备实例, 4： 灾备实例（独享型） 示例值： 1 |
| NodesInfo | Array of NodeInfo | 实例的各个DB节点信息 示例值：查看 |
| CpuArch | String | cpu架构 示例值： x86 |
| RsAccessStrategy | Int64 | 就近访问策略，0-无策略, 1-可用区就近访问 示例值： 0 |
| ExclusterName | String | 资源池名称 示例值： feiteng-5000c |
| ReservedNetResources | Array of ReservedNetResources | 尚未回收的网络资源 示例值：查看 |
| IsDcnSqlSyncSupported | Int64 | 是否支持强同步dcn 示例值： 1 |
| TemplateDefault | String | 参数模板列表匹配用的模板版本号 示例值： 8.0.24 |
| IsMaxUserConnectionsSupported | Bool | 实例是否支持设置用户连接限制 示例值： true |
| IsDcnStrongSyncSupported | Int64 | 是否支持强同步dcn。1支持，0不支持 示例值： 1 |
| DbVersionId | String | 对外显示的数据库版本 示例值： 5.7 |
| EncryptStatus | Int64 | 加密状态, 0-未开启，1-已开启 示例值： 0 |
| ExclusterType | Int64 | 独享集群类型，0:公有云或内部, 1:金融围笼, 2:CDC集群 示例值： 0 |
| GiftLogStoragePercentage | String | 日志存储空间大小与实例容量的百分比 示例值： 25% |
| IsDcnSwitchSupported | Int64 | 是否支持dcn切换，1-支持，0-不支持 示例值： 1 |
| OssId | String | OSS集群ID 示例值： 1 |
| IsPhysicalReplicationSupported | Bool | 是否支持物理复制 示例值： false |
| IsDelayedReplicationSupported | Int64 | 是否支持延迟复制，1-支持，0-不支持 示例值： 1 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError.DbOperationFailed | 查询数据库失败。 |
| InternalError.GetInstanceDetailFailed | 获取实例详情失败。 |
| InternalError.GetSubnetFailed | 查询虚拟私有网络子网信息失败。 |
| InternalError.OperateDatabaseFailed | 操作数据库失败。 |
| InvalidParameter.InstanceNotFound | 未找到请求的实例。 |
| UnauthorizedOperation.PermissionDenied | 没有权限操作该接口或资源。 |