1. 接口描述
接口请求域名： dbbrain.tencentcloudapi.com 。
获取指定时间段内的健康得分趋势
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DescribeHealthScoreTimeSeries。 |
| Version | 是 | String | 公共参数，本接口取值：2021-05-27。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| StartTime | 是 | Timestamp ISO8601 | 开始时间，如“2021-05-27 00:00:00”，支持的最早查询时间为当前时间的前30天。 示例值：2025-09-03T10:41:59+08:00 |
| EndTime | 是 | Timestamp ISO8601 | 结束时间，如“2021-05-27 01:00:00”，支持的最早查询时间为当前时间的前30天。 示例值：2025-09-03T10:41:59+08:00 |
| InstanceId | 是 | String | 实例ID列表。可通过 DescribeDiagDBInstances 接口获取。 示例值：cdb-test |
| Product | 是 | String | 服务产品类型，支持值包括："mysql" - 云数据库 MySQL，"redis" - 云数据库 Redis，"mariadb"-数据库mariadb 默认为"mysql"。 示例值：cdb |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Data | HealthScoreTimeSeriesData | 健康得分趋势数据 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 获取实例健康得分趋势
获取实例健康得分趋势
输入示例
POST / HTTP/1.1
Host: dbbrain.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeHealthScoreTimeSeries
<公共请求参数>
{
"StartTime": "2025-09-09T00:00:00+08:00",
"EndTime": "2025-09-09T12:00:00+08:00",
"InstanceId": "crs-qjdcfkzsat",
"Product": "redis"
}输出示例
{
"Response": {
"Data": {
"Avg": 100,
"HealthStatus": 1,
"Metric": "health_score",
"Series": [
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100,
100
],
"Timestamp": [
1757260800,
1757261100,
1757261400,
1757261700,
1757262000,
1757262300,
1757262600,
1757262900,
1757263200,
1757263500,
1757263800,
1757264100,
1757264400,
1757264700,
1757265000,
1757265300,
1757265600,
1757265900,
1757266200,
1757266500,
1757266800,
1757267100,
1757267400,
1757267700,
1757268000,
1757268300,
1757268600,
1757268900,
1757269200,
1757269500,
1757269800,
1757270100,
1757270400,
1757270700,
1757271000,
1757271300,
1757271600,
1757271900,
1757272200,
1757272500,
1757272800,
1757273100,
1757273400,
1757273700,
1757274000,
1757274300,
1757274600,
1757274900,
1757275200,
1757275500,
1757275800,
1757276100,
1757276400,
1757276700,
1757277000,
1757277300,
1757277600,
1757277900,
1757278200,
1757278500,
1757278800,
1757279100,
1757279400,
1757279700,
1757280000,
1757280300,
1757280600,
1757280900,
1757281200,
1757281500,
1757281800,
1757282100,
1757282400,
1757282700,
1757283000,
1757283300,
1757283600,
1757283900,
1757284200,
1757284500,
1757284800,
1757285100,
1757285400,
1757285700,
1757286000,
1757286300,
1757286600,
1757286900,
1757287200,
1757287500,
1757287800,
1757288100,
1757288400,
1757288700,
1757289000,
1757289300,
1757289600,
1757289900,
1757290200,
1757290500,
1757290800,
1757291100,
1757291400,
1757291700,
1757292000,
1757292300,
1757292600,
1757292900,
1757293200,
1757293500,
1757293800,
1757294100,
1757294400,
1757294700,
1757295000,
1757295300,
1757295600,
1757295900,
1757296200,
1757296500,
1757296800,
1757297100,
1757297400,
1757297700,
1757298000,
1757298300,
1757298600,
1757298900,
1757299200,
1757299500,
1757299800,
1757300100,
1757300400,
1757300700,
1757301000,
1757301300,
1757301600,
1757301900,
1757302200,
1757302500,
1757302800,
1757303100,
1757303400,
1757303700,
1757304000,
1757304300,
1757304600,
1757304900,
1757305200,
1757305500,
1757305800,
1757306100,
1757306400,
1757306700,
1757307000,
1757307300,
1757307600,
1757307900,
1757308200,
1757308500,
1757308800,
1757309100,
1757309400,
1757309700,
1757310000,
1757310300,
1757310600,
1757310900,
1757311200,
1757311500,
1757311800,
1757312100,
1757312400,
1757312700,
1757313000,
1757313300,
1757313600,
1757313900,
1757314200,
1757314500,
1757314800,
1757315100,
1757315400,
1757315700,
1757316000,
1757316300,
1757316600,
1757316900,
1757317200,
1757317500,
1757317800,
1757318100,
1757318400,
1757318700,
1757319000,
1757319300,
1757319600,
1757319900,
1757320200,
1757320500,
1757320800,
1757321100,
1757321400,
1757321700,
1757322000,
1757322300,
1757322600,
1757322900,
1757323200,
1757323500,
1757323800,
1757324100,
1757324400,
1757324700,
1757325000,
1757325300,
1757325600,
1757325900,
1757326200,
1757326500,
1757326800,
1757327100,
1757327400,
1757327700,
1757328000,
1757328300,
1757328600,
1757328900,
1757329200,
1757329500,
1757329800,
1757330100,
1757330400,
1757330700,
1757331000,
1757331300,
1757331600,
1757331900,
1757332200,
1757332500,
1757332800,
1757333100,
1757333400,
1757333700,
1757334000,
1757334300,
1757334600,
1757334900,
1757335200,
1757335500,
1757335800,
1757336100,
1757336400,
1757336700,
1757337000,
1757337300,
1757337600,
1757337900,
1757338200,
1757338500,
1757338800,
1757339100,
1757339400,
1757339700,
1757340000,
1757340300,
1757340600,
1757340900,
1757341200,
1757341500,
1757341800,
1757342100,
1757342400,
1757342700,
1757343000,
1757343300,
1757343600,
1757343900,
1757344200,
1757344500,
1757344800,
1757345100,
1757345400,
1757345700,
1757346000,
1757346300,
1757346600,
1757346900,
1757347200
],
"Unit": "分"
},
"RequestId": "4540d916-108f-407f-9a6e-7c78a6d3f8c0"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| AuthFailure | CAM签名/鉴权错误。 |
| FailedOperation | 操作失败。 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| LimitExceeded | 超过配额限制。 |
| MissingParameter | 缺少参数错误。 |
| OperationDenied | 操作被拒绝。 |
| OperationDenied.UserHasNoStrategy | CAM鉴权错误。 |
| ResourceNotFound | 资源不存在。 |
| UnauthorizedOperation | 未授权操作。 |
| UnknownParameter | 未知参数错误。 |
| UnsupportedOperation | 操作不支持。 |
