功能介绍

扩容实例相关的存储容量大小。

接口约束

该接口仅支持社区版按需计费的实例。

调试

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

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/enlarge-volume

• URI样例

  https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/enlarge-volume

• 参数说明

  表1 参数说明

  名称	是否必选	描述
  project_id	是	租户在某一region下的project ID。
  instance_id	是	实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	描述
  volume	是	Object	volume请求详细信息。详情请参见表3。

  表3 volume字段数据结构说明

  名称	是否必选	参数类型	描述
  group_id	否	String	角色组ID。 对于集群实例，该参数为shard组ID。 对于副本集和单节点实例，不传该参数。
  size	是	String	待扩容到的磁盘容量。取值为10的整数倍，并且大于当前磁盘容量。 对于集群实例，表示扩容到的单个shard组的磁盘容量。取值范围：10GB~2000GB。 对于副本集实例，表示扩容到的实例的磁盘容量，取值范围：10GB~3000GB。 对于单节点实例，表示扩容到的实例的磁盘容量，取值范围：10GB~1000GB。

• 请求体样例
  集群：

  {
  	"volume":
  		{
  			"group_id":"1b0c008adbcb495c81a3d5762a02a2abgr02",
  			"size":20
  		}
  }

  副本集：

  {
  	"volume":
  		{
  			"size":20
  		}
  }

  单节点：

  {
  	"volume":
  		{
  			"size":20
  		}
  }

响应消息

• 要素说明

  表4 要素说明

  名称	参数类型	描述
  job_id	String	任务ID。

• 响应样例

  {
      "job_id": "3711e2ad-5787-49bc-a47f-3f0b066af9f5"
  }

状态码

详情请参见状态码。

错误码

详情请参见错误码。