变更数据库实例的规格

功能介绍

变更数据库实例规格。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

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

接口约束

• 需要变更的数据库实例规格不能与原数据库实例规格一样。
• 实例状态仅为服务中时可以进行调整CPU/内存。
• 只能变更相同类型数据库实例的规格。（例如，单实例只能变更为单实例对应的规格，不能变更为HA的规格）。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/action

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project 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实例规格。

  • 请求样例

    MySQL：

    {
    	"resize_flavor": {
    		"spec_code": "rds.mysql.m1.xlarge"
              
    	}
    }

    PostgreSQL：

    {
    	"resize_flavor": {
    		"spec_code": "rds.pg.c2.medium.ha"
              
    	}
    }

    SQL Server：

    {
    	"resize_flavor": {
    		"spec_code": "rds.mssql.2014.se.s3.large.2"
              
    	}
    }

响应消息

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

    表4 要素说明

    名称	参数类型	说明
    job_id	String	任务ID。

  • 正常响应样例

    {
    	"job_id": "2b414788a6004883a02390e2eb0ea227"
    }

  • 异常响应

    请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。