更新时间:2025-08-22 GMT+08:00

MySQL大版本升级

功能介绍

MySQL 5.7升级到MySQL 8.0版本。

接口约束

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/major-upgrade

  • 参数说明
    表1 参数说明

    名称

    参数类型

    是否必选

    说明

    project_id

    String

    参数解释:

    租户在某一region下的project ID。

    获取方法请参见获取项目ID

    约束限制:

    不涉及

    取值范围:

    不涉及

    默认取值:

    不涉及

    instance_id

    String

    参数解释:

    实例ID。

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

请求消息

表2 参数说明

名称

参数类型

是否必选

说明

delay

Boolean

参数解释:

是否在运维时间窗内切换版本。

约束限制:

不涉及。

取值范围:

  • true:在运维时间窗内切换版本。
  • false:不在运维时间窗内切换版本。

默认取值:

false

configuration_id

String

参数解释:

指定新版本的参数模板。

约束限制:

该参数值不填,则默认会最大限度继承原实例的参数。

取值范围:

不涉及。

默认取值:

不涉及。

请求示例

下发MySQL 5.7升级8.0操作。

POST https://{Endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/d8e6ca5a624745bcb546a227aa3ae1cfin01/major-upgrade

{
  "delay": false
}

响应消息

  • 正常响应要素说明
    表3 参数说明

    名称

    参数类型

    说明

    job_id

    String

    参数解释:

    任务流ID。

    取值范围:

    不涉及。

  • 正常响应样例
    {
      "job_id": "234asdb34234-54367547-123213"
    }

状态码

错误码

请参见错误码