升级数据库引擎版本

最近更新时间:2017-12-26 11:13:43

1. 接口描述

本接口(UpgradeCdbEngineVersion)用于升级云数据库实例的引擎版本。
接口请求域名:cdb.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为UpgradeCdbEngineVersion。

参数名称 是否必选 类型 描述
cdbInstanceId String 实例ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同,可使用查询实例列表 接口获取,其值为输出参数中字段 uInstanceId 的值。
engineVersion String MySQL版本,值包括:5.5和5.6

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
codeDesc String 英文错误描述
data Array 返回数据

其中实例计费模式为包年包月时,data参数的构成如下:

参数名称 类型 描述
dealIds Array 短订单ID,用于调用云API相关接口,如获取订单信息
dealNames Array 长订单ID,用于反馈订单问题给腾讯云官方客服
jobId Int 升级任务ID,可使用查询任务列表获取其执行情况

其中实例计费模式为按量计费时,data参数的构成如下:

参数名称 类型 描述
dealIds Array 按量计费订单ID,用于反馈订单问题给腾讯云官方客服
jobId Int 升级任务ID,可使用查询任务列表获取其执行情况

4. 错误码表

以下错误码表列出了该接口的业务逻辑错误码。

错误码 英文错误码 描述
9003 InvalidParameter 参数错误
9006 InternalError 数据库内部错误
9301 InvalidParameter 交易参数错误

5. 示例

输入

https://cdb.api.qcloud.com/v2/index.php?Action=UpgradeCdbEngineVersion
&<公共请求参数>
&cdbInstanceId=cdb-8qrg9t04
&engineVersion=5.6

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "dealIds": [
            "20161123160000035193343514402319"
        ],
        "jobId":"111"
    }
}