Upgrading the Major Version of an RDS for MySQL Instance

Function

This API is used to upgrade an instance from MySQL 5.7 to MySQL 8.0.

• Before calling this API, learn how to authenticate it.
• Before calling this API, learn about request header parameters.

Constraints

• This API supports only the upgrade from MySQL 5.7 to MySQL 8.0.
• Before using this API, contact customer service to apply for the required permissions.
• For detailed constraints, see Upgrading an RDS for MySQL Instance from 5.7 to 8.0.

URI

• URI format

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

• Parameter description

  Table 1 Parameters

  Parameter	Type	Mandatory	Description
  project_id	String	Yes	Definition Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
  instance_id	String	Yes	Definition Instance ID. Constraints N/A Range N/A Default Value N/A

Request

Example Request

Upgrade an instance from MySQL 5.7 to MySQL 8.0.

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

{
  "delay": false
}

Response

• Normal response

  Table 3 Parameters

  Parameter	Type	Description
  job_id	String	Definition Task flow ID. Range N/A

• Example normal response

  {
    "job_id": "234asdb34234-54367547-123213"
  }

• Abnormal response

  For details, see Abnormal Request Results.

Status Code

• Normal

  202

• Abnormal

  For details, see Status Codes.

Error Code

For details, see Error Codes.