更新时间:2024-03-28 GMT+08:00

变更数据库实例的规格

功能介绍

变更数据库实例规格。

变更数据库实例规格时,RDS会有5~10分钟的业务中断重启,请谨慎操作。

接口约束

  • Serverless型实例不支持该接口。
  • 需要变更的数据库实例规格不能与原数据库实例规格一样。
  • 实例状态仅为“正常”时可以进行调整CPU/内存。
  • 只能变更相同类型数据库实例的规格。(例如,单实例只能变更为单实例对应的规格,不能变更为HA的规格)。
  • RDS for MySQL本地盘规格变更时,变更后的目标规格的存储上限不能小于当前实例规格的存储空间。

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/action

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一Region下的项目ID。

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

    instance_id

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

resize_flavor

Object

请参见表3

表3 resize_flavor字段数据结构说明

名称

是否必选

参数类型

说明

spec_code

String

资源规格编码。例如:rds.mysql.m1.xlarge。其中,rds代表RDS产品,mysql代表数据库引擎,m1.xlarge代表性能规格,为高内存类型。带"rr"的表示只读实例规格,反之表示单实例和HA实例规格。

is_auto_pay

Boolean

变更包周期实例的规格时可指定,表示是否自动从客户的账户中支付。

  • true,为自动支付。
  • false,为手动支付,默认该方式。

请求示例

  • 变更MySQL数据库实例的规格为rds.mysql.m1.xlarge。
    POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
    {
    	"resize_flavor": {
    		"spec_code": "rds.mysql.m1.xlarge",
                    "is_auto_pay": true
    	}
    }
  • 变更PostgreSQL数据库实例的规格为rds.pg.c2.medium.ha。
    {
    	"resize_flavor": {
    		"spec_code": "rds.pg.c2.medium.ha",
                    "is_auto_pay": true
    	}
    }
  • 变更SQL Server数据库实例的规格为rds.mssql.2014.se.s3.large.2。
    {
    	"resize_flavor": {
    		"spec_code": "rds.mssql.2014.se.s3.large.2",
                    "is_auto_pay": true
    	}
    }

响应消息

  • 按需实例
    • 正常响应要素说明
      表4 要素说明

      名称

      参数类型

      说明

      job_id

      String

      任务ID。

    • 正常响应样例
      {
      	"job_id": "2b414788a6004883a02390e2eb0ea227"
      }
    • 异常响应

      请参见异常请求结果

  • 包周期实例
    • 正常响应要素说明
      表5 要素说明

      名称

      参数类型

      说明

      order_id

      String

      订单ID。

    • 正常响应样例
      {
      	"order_id": "CS2009151216NO2U1"
      }
    • 异常响应

      请参见异常请求结果

状态码

错误码

请参见错误码