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 instancesUpgradeDBInstanceEngineMajorVersionPrecheck
Copy page
Download PDFManaging instances
UpgradeDBInstanceEngineMajorVersionPrecheck
Copy pageDownload PDFUpgradeDBInstanceEngineMajorVersionPrecheck
Call the UpgradeDBInstanceEngineMajorVersionPrecheck API to pre-check the instance before upgrading to a major version.
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-7510ba07**** | Instance ID. |
TargetMajorVersion | String | Yes | MySQL 8.0.43 | The target major version for the instance upgrade. Only MySQL 8.0.43 is currently supported. |
MySQLSlaveDelayThreshold | Integer | Yes | 10 | Data validation latency threshold. An integer from 1 to 10. Unit: seconds. |
Recheck | Boolean | No | true | Whether to restart the pre-check. Values:
|
Response parameters
Parameter | Type | Sample value | Description |
EventId | String | 20250410145924BA7FA42A930CFDBD****-83bd31 | Event ID for the pre-check of upgrading the instance major version. |
Sample
Sample request
POST /?Action=UpgradeDBInstanceEngineMajorVersionPrecheck&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-7510ba07****",
"TargetMajorVersion": "MySQL 8.0.43",
"MySQLSlaveDelayThreshold": 10
}
Sample response
{
"ResponseMetadata": {
"RequestId": "20250410150011691A1F663A1C51B9BE86-253c40",
"Action": "UpgradeDBInstanceEngineMajorVersionPrecheck",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-beijing"
},
"Result": {
"EventId": "20250410145924BA7FA42A930CFDBD****-83bd31"
}
}
Error code
Last updated: 2026.06.12 17:17:50
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
