调用RebuildDBInstance接口重建专属集群中的RDS备实例。

专属集群功能以集群形式批量管理实例，一个地域可以创建多个专属集群，一个专属集群包含多个主机，一个主机包含多个实例。详情请参见专属集群简介。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 RebuildDBInstance

系统规定参数。取值：RebuildDBInstance。

DedicatedHostGroupId String 是 dhg-4nxxxxxxx

专属集群ID。可调用DescribeDedicatedHostGroups获取。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

专属集群内的实例ID。
DedicatedHostId String 否 i-bpxxxxxxx

需要重建备实例的主机ID。

说明 不传入该参数时，备实例会优先在原主机上重建，如果原主机空间不足，系统会选择非主实例所在的主机，若还是找不到足够空间，会返回空间不足错误。
RegionId String 否 cn-hangzhou

地域ID。可调用DescribeRegions获取。

RebuildNodeType String 否 FOLLOWER

需要重建的备实例类型。取值：

  • FOLLOWER：备节点。
  • LOG：日志节点。

返回数据

名称 类型 示例值 描述
MigrationId Integer 3298015

重建排队序号。当序号为0时，就会进行重建迁移。
RequestId String 355DA57C-8CC4-40AB-B3F8-B684BA32EB9E

请求ID。
TaskId Integer 208676661

任务ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=RebuildDBInstance
&DedicatedHostGroupId=dhg-4nxxxxxxx
&DedicatedHostId=i-bpxxxxxxx
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>

正常返回示例

XML格式 

<RebuildDBInstanceResponse>
  <MigrationId>3298015</MigrationId>
  <RequestId>355DA57C-8CC4-40AB-B3F8-B684BA32EB9E</RequestId>
  <TaskId>208676661</TaskId>
</RebuildDBInstanceResponse>

JSON格式 

{
	"MigrationId": 3298015,
	"RequestId": "355DA57C-8CC4-40AB-B3F8-B684BA32EB9E",
	"TaskId": 208676661
}

错误码

HttpCode 错误码 错误信息 描述
404 InsufficientResourceCapacity No host is available for the requested instance. 资源不足，分配失败

访问错误中心查看更多错误码。