Domain name for API request: cynosdb.intl.tencentcloudapi.com.
This API is used to upgrade or downgrade the configuration of an instance.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: UpgradeInstance. |
| Version | Yes | String | Common Params. The value used for this API: 2019-01-07. |
| Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. This API only supports: ap-bangkok, ap-beijing, ap-chengdu, ap-chongqing, ap-guangzhou, ap-hongkong, ap-jakarta, ap-nanjing, ap-seoul, ap-shanghai, ap-shenzhen-fsi, ap-singapore, ap-tokyo, eu-frankfurt, na-ashburn, na-siliconvalley, sa-saopaulo. |
| InstanceId | Yes | String | Instance ID. |
| Cpu | Yes | Integer | Database CPU |
| Memory | Yes | Integer | Database memory in GB |
| UpgradeType | Yes | String | Upgrade type: upgradeImmediate, upgradeInMaintain |
| DeviceType | No | String | Instance machine type 1. common: universal type. 2. exclusive: dedicated. |
| StorageLimit | No | Integer | This parameter has been deprecated. |
| AutoVoucher | No | Integer | Whether to automatically select a voucher. 1: Yes; 0: No. Default is 0. |
| DbType | No | String | This parameter has been deprecated. |
| DealMode | No | Integer | Transaction mode 0-Place order and pay 1-Place order |
| UpgradeMode | No | String | NormalUpgrade: adjust. FastUpgrade: rapid configuration change. If the configuration adjustment is judged to cause a transient disconnection, the configuration adjustment process will be terminated. |
| UpgradeProxy | No | UpgradeProxy | Synchronously upgrade proxy |
| Parameter Name | Type | Description |
|---|---|---|
| TranId | String | Frozen transaction ID |
| BigDealIds | Array of String | Large order number. |
| DealNames | Array of String | Order ID |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: cynosdb.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: UpgradeInstance
<Common request parameters>
{
"InstanceId": "cynosdbmysql-ins-n7ocdslw",
"UpgradeType": "upgradeImmediate",
"Cpu": 2,
"Memory": 4,
"UpgradeProxy": {
"Cpu": 4,
"Mem": 8000,
"ReloadBalance": "auto",
"ProxyZones": [
{
"ProxyNodeZone": "ap-guangzhou-3",
"ProxyNodeCount": 1
}
]
}
}{
"Response": {
"BigDealIds": [],
"DealNames": [
"20241025054071351304161"
],
"RequestId": "588fbc90-61a4-4125-bc70-65a3f8d1327e",
"TranId": "20241025054071351304171"
}
}TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| FailedOperation.CreateOrder | Failed to create and pay the order. |
| FailedOperation.DatabaseAccessError | Database access failed. Try again later. If the issue persists, contact customer service. |
| FailedOperation.OperationFailedError | Operation failed. Try again later. If the issue persists, contact customer service. |
| FailedOperation.TradeCreateOrderError | Failed to create and pay for the order. Try again later. If the issue persists, contact customer service. |
| InternalError.SystemError | Internal system error. |
| InternalError.UnknownError | Unknown internal error. |
| InvalidParameterValue.DBTypeNotFound | Unsupported instance type. |
| InvalidParameterValue.InstanceNotFound | The instance does not exist. |
| InvalidParameterValue.ParamError | Parameter error. |
| OperationDenied.ClusterOpNotAllowedError | Operation forbidden. The current cluster does not allow this operation. |
| OperationDenied.InstanceStatusDeniedError | Operation not allowed in the current instance status. |
| OperationDenied.InsufficientBalanceError | Insufficient account balance. |
| OperationDenied.TradeBusinessCheckError | Business inspection failed: {{1}} |
| ResourceNotFound.ClusterNotFoundError | The cluster does not exist. |
| UnauthorizedOperation.PermissionDenied | CAM authentication failed. |
文档反馈