文档首页> 云数据库 RDS> API参考> API v3（推荐）> 实例管理> 扩容数据库实例的磁盘空间
更新时间：2024-03-28 GMT+08:00
查看PDF

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

功能介绍

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

接口约束

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

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

      请参见异常请求结果。

状态码

错误码

请参见错误码。

父主题： 实例管理