云数据库 MySQL 版
云数据库 MySQL 版
云数据库 MySQL 版
文档指南
请输入
产品动态
内核功能
功能
用户指南
实例管理
连接管理
管理连接终端
备份恢复
服务可用性
日志管理
数据安全管理
参数管理
跨地域备份管理
API 参考
V2（2022-01-01）
实例管理
连接管理
账号管理
数据库管理
安全加密
备份与恢复
参数管理
资源包管理
附录
开发者工具
最佳实践
相关协议
- 文档首页
云数据库 MySQL 版API 参考V2（2022-01-01）实例管理DescribeDBSwitchBlueGreenPrecheck - 查询蓝绿部署切换的预检查结果
复制全文
下载 pdfDescribeDBSwitchBlueGreenPrecheck - 查询蓝绿部署切换的预检查结果
文档反馈
问问助手调用 DescribeDBSwitchBlueGreenPrecheck 接口查询蓝绿部署切换的预检查结果。
请求类型
同步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
InstanceId | String | 是 | mysql-f83edc2e**** | 蓝绿部署中蓝色实例的 ID。 |
BeginTime | String | 否 | 2025-07-24T09:20:52.477Z | 指定按照时间范围查询预检查结果时的时间起点（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 说明 无默认值。如不设定，则按照其他字段设定的查询条件返回。 |
EventId | String | 否 | 20250724171204259F91326A6ACD0B791D-5176f4 | 蓝绿部署切换预检查事件的 ID。 说明 无默认值。如不设定，则按照其他字段设定的查询条件返回。 |
返回参数
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
PrecheckResults | 请参见返回示例。 | 蓝绿部署切换的预检查结果。 |
BlueGreenPrecheckResult
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
CheckTime | String | 2025-07-24T09:25:52.477Z | 预检查的发起时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
EffectiveTime | String | 2025-07-25T09:25:52.477Z | 预检查结果有效期的终点（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
GreenInstanceId | String | mysql-06c7db72**** | 蓝绿部署中绿色实例的 ID。 |
PrecheckItems | 请参见返回示例。 | 蓝绿部署切换的预检查项。 | |
Progress | Long | 100 | 预检查的进度。单位为百分比。 |
Result | String | Pass | 预检查结果。取值：
|
TaskId | String | 2025072417253957250BB01665529D2515-961d25 | 任务 ID。 |
CheckItem
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
Description | String | initConnectCheck | 检查项的描述信息。 |
ItemName | String | initConnectCheck | 检查项的名称。 |
RiskLevel | String | Warning | 未能通过检查项的风险等级。取值：
|
示例
请求示例
POST /?Action=DescribeDBSwitchBlueGreenPrecheck&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
"InstanceId": "mysql-f83edc2e****"
}
返回示例
{
"ResponseMetadata": {
"RequestId": "202507241749444958F4F8739B10011CCC-32eedc",
"Action": "DescribeDBSwitchBlueGreenPrecheck",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-guangzhou"
},
"Result": {
"PrecheckResults": [
{
"CheckTime": "2025-07-24T09:25:52.477Z",
"EffectiveTime": "2025-07-25T09:25:52.477Z",
"GreenInstanceId": "mysql-06c7db72****",
"PrecheckItems": [
{
"Description": "蓝色、绿色实例切换后，监控告警配置可能不一致。",
"ItemName": "check_monitor",
"RiskLevel": "Notice"
},
{
"Description": "切换蓝色、绿色实例不会迁移实例备份。",
"ItemName": "check_backup",
"RiskLevel": "Notice"
},
{
"Description": "蓝色、绿色实例切换过程中，不会切换 IP，仅切换您指定的终端的域名。",
"ItemName": "check_domain",
"RiskLevel": "Notice"
},
{
"Description": "检查蓝色实例和绿色实例的增量数据一致性。",
"ItemName": "check_dts_incr_data_validation",
"RiskLevel": "Warning"
}
],
"Progress": 100,
"Result": "Pass",
"TaskId": "2025072417253957250BB01665529D2515-961d25"
},
{
"CheckTime": "2025-07-24T09:12:17.139Z",
"EffectiveTime": "2025-07-25T09:12:17.139Z",
"GreenInstanceId": "mysql-06c7db72****",
"PrecheckItems": [
{
"Description": "蓝色、绿色实例切换后，监控告警配置可能不一致。",
"ItemName": "check_monitor",
"RiskLevel": "Notice"
},
{
"Description": "切换蓝色、绿色实例不会迁移实例备份。",
"ItemName": "check_backup",
"RiskLevel": "Notice"
},
{
"Description": "蓝色、绿色实例切换过程中，不会切换 IP，仅切换您指定的终端的域名。",
"ItemName": "check_domain",
"RiskLevel": "Notice"
},
{
"Description": "检查蓝色实例和绿色实例的增量数据一致性。",
"ItemName": "check_dts_incr_data_validation",
"RiskLevel": "Warning"
}
],
"Progress": 100,
"Result": "Pass",
"TaskId": "20250724171204259F91326A6ACD0B791D-5176f4"
}
]
}
}
错误码
最近更新时间：2026.04.10 10:30:47
这个页面对您有帮助吗？
有用
有用
无用
无用