调用RebuildDBInstance接口将RDS主机组内实例的备实例重建。

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

调试

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

请求参数

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

系统规定参数。取值:RebuildDBInstance

DedicatedHostGroupId String dhg-4nxxxxxxx

主机组ID。

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

DedicatedHostId String i-bpxxxxxxx

备实例要重建到的目标主机ID。

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

地域ID。可以通过接口DescribeRegions查看地域ID。

AccessKeyId String LTAIfCxxxxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
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
}

错误码

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