RDS for MySQL
RDS for MySQL
RDS for MySQL
Document
What's new
Announcement
Product introduction
Product billing
Billing method
Kernel functions
Feature
Stability
Performance
Quick start
User guide
Managing instances
Changing an instance configuration
Upgrading kernel versions
Managing tags
Managing disaster instances
Managing blue-green deployment
Migrating data
Managing connections
Database proxy
Connecting to an instance
Managing connection endpoints
Diagnosing connections
Managing connection pool modes
Managing access addresses and ports
Managing databases
Account and access authorization
Backup recovery
Backup data
Data recovery
Service availability
Managing logs
Managing data security
Managing allowlists
Configuring SSL encryption
Managing parameters
Monitoring and alerts
Task center
Operation and maintenance events
Backups of deleted instances
Managing cross-regional backups
API reference
V2（2022-01-01）
Global management
Managing instances
Managing connections
Managing accounts
Managing databases
Security encryption
Backup and recovery
Managing parameters
Managing tasks
Event management
Managing logs
Resource plan management
Appendix
SDK reference
Developer tools
Best practice
Performance document
Troubleshooting
- Documentation
RDS for MySQLAPI referenceV2（2022-01-01）Managing instancesSwitchDBPrecheckBlueGreen
Copy page
Download PDFManaging instances
SwitchDBPrecheckBlueGreen
Copy pageDownload PDFSwitchDBPrecheckBlueGreen
Call the SwitchDBPrecheckBlueGreen API to initiate a pre-check for a blue-green deployment switch.
Request type
Asynchronous request.
Debug
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
Request parameters
Parameter | Type | Is it required? | Example | Description |
InstanceId | String | Yes | mysql-f83edc2e**** | The ID of the blue instance in the blue-green deployment. |
Recheck | Boolean | No | false | Whether to restart the pre-check. Values:
tip This parameter has no default value. |
Endpoints | No | See the request example. | Instance connection information. |
SwitchDBEndpoint
Parameter | Type | Is it required? | Sample value | Description |
OriginEndpointId | String | Yes | mysql-f83edc2e****-cluster | The connection endpoint ID of the blue instance. |
TargetEndpointId | String | Yes | mysql-06c7db72****-cluster | The connection endpoint ID of the green instance. |
Response parameters
Parameter | Type | Sample value | Description |
EventId | String | 20250724171204259F91326A6ACD0B****-5176f4 | Event ID. |
Sample
Sample request
POST /?Action=SwitchDBPrecheckBlueGreen&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****",
"Recheck": false
}
Sample response
{
"ResponseMetadata": {
"RequestId": "202507241749444958F4F8739B10011CCC-32eedc",
"Action": "SwitchDBPrecheckBlueGreen",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-guangzhou"
},
"Result": {
"EventId": "20250724171204259F91326A6ACD0B****-5176f4"
}
}
Error code
Last updated: 2026.06.12 17:17:53
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
