文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 实例管理/ 扩容数据库实例的磁盘空间
更新时间:2024-03-28 GMT+08:00

扩容数据库实例的磁盘空间

功能介绍

扩容数据库实例的磁盘空间。

接口约束

  • 备实例大小和主实例大小一致,当主实例扩容时,会同时扩容备实例。
  • 实例状态为“正常”和“存储空间满”时可以进行扩容。

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

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

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

    instance_id

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

enlarge_volume

Object

所需扩容到的磁盘容量大小。

详情请参见表3

表3 enlarge_volume字段数据结构说明

名称

是否必选

参数类型

说明

size

Integer

每次扩容最小容量为10GB,实例所选容量大小必须为10的整数倍,取值范围:40GB~4000GB。

RDS for PostgreSQL部分用户支持40GB~15000GB,如果您想开通该功能,请联系客服。

is_auto_pay

Boolean

扩容包周期实例的磁盘空间时可指定,表示是否自动从客户的账户中支付。

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

请求示例

扩容数据库实例的磁盘空间到400GB。
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
{
	"enlarge_volume": {
		"size": 400,
                "is_auto_pay": true
	}
}

响应消息

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

      名称

      参数类型

      说明

      job_id

      String

      任务ID。

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

      请参见异常请求结果

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

      名称

      参数类型

      说明

      order_id

      String

      订单ID。

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

      请参见异常请求结果

状态码

错误码

请参见错误码