文档首页/ 云数据库 RDS/ API参考/ API v3（推荐）/ 实例管理/ 变更数据库实例的规格
更新时间：2024-07-12 GMT+08:00
查看PDF
分享

变更数据库实例的规格

功能介绍

变更数据库实例规格。

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

调试

您可以在API Explorer中调试该接口。

接口约束

  • 需要变更的数据库实例规格不能与原数据库实例规格一样。
  • 实例状态仅为“正常”时可以进行调整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，为手动支付，默认该方式。

is_delay

否

Boolean

是否进行定时规格变更，该参数目前仅支持MySQL。

  • 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,
                "is_delay": 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"
}
    • 异常响应

      请参见异常请求结果。

状态码

错误码

请参见错误码。

父主题： 实例管理

相关文档