调用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. 资源不足,分配失败

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