调用MigrateDBInstance接口迁移主机组内的RDS实例。

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

调试

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

请求参数

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
DedicatedHostGroupId String 是 dhg-4nxxxxxxx

主机组ID。
TargetDedicatedHostIdForMaster String 是 i-bpxxxxxxx1

主实例要迁移的目标主机ID。
TargetDedicatedHostIdForSlave String 是 i-bpxxxxxxx2

备实例要迁移的目标主机ID。
RegionId String 否 cn-hangzhou

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

EffectiveTime String 否 MaintainTime

迁移时间。取值：

  • Immediately：立即切换（默认）
  • MaintainTime：在运维时间段切换
  • Specified：指定时间切换
SpecifiedTime String 否 2019-10-21T10:00:00Z

指定切换的时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

说明 当EffectiveTime=Specified时需要填入本参数。
AccessKeyId String 否 LTAIfCxxxxxxx

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

返回数据

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

迁移排队序号。当序号为0时，就会进行迁移切换。
RequestId String 498AE8CA-8C81-4A01-AF37-2B902014ED30

请求ID。
TaskId Integer 108246861

任务ID。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=MigrateDBInstance
&DBInstanceId=rm-uf6wjk5xxxxxxx
&DedicatedHostGroupId=dhg-4nxxxxxxx
&TargetDedicatedHostIdForMaster=i-bpxxxxxxx1
&TargetDedicatedHostIdForSlave=i-bpxxxxxxx2
&<公共请求参数>

正常返回示例

XML 格式 

<MigrateDBInstanceResponse>
  <MigrationId>2245016</MigrationId>
  <RequestId>498AE8CA-8C81-4A01-AF37-2B902014ED30</RequestId>
  <TaskId>108246861</TaskId>
</MigrateDBInstanceResponse>

JSON 格式 

{
	"MigrationId":2245016,
	"RequestId":"498AE8CA-8C81-4A01-AF37-2B902014ED30",
	"TaskId":108246861
}

错误码

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