调用ReplaceDedicatedHost接口替换专属集群的主机。

当MySQL主机故障策略选择手动替换,且MySQL主机状态为故障中时,您可调用该接口替换主机。

说明 您可通过调用 DescribeDedicatedHostAttribute接口,根据返回参数 HostStatus的值获取当前主机的状态。

调试

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

请求参数

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

系统规定参数,取值:ReplaceDedicatedHost

DedicatedHostId String ch-bp10a5id3boqi****

主机ID。可调用DescribeDedicatedHosts获取目标主机ID。

FailoverMode String MaintainTime

实例主库的切换方案。取值:

  • MaintainTime(默认):在实例维护时间段切换,等待当前主机上的主实例都切换成其他主机的备实例后再重启主机,避免影响业务。
  • Immediate:立即强制重启主机。
RegionId String cn-hangzhou

目标主机所在地域ID。可调用DescribeDedicatedHostAttribute获取。

返回数据

名称 类型 示例值 描述
DedicatedHostId String ch-bp10a5id3boqi****

专属集群的主机ID。

RequestId String D6E068C3-25BC-455A-85FE-45F0B22EDSD8

请求ID。

TaskId Integer 10254125

任务ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=ReplaceDedicatedHost
&DedicatedHostId=dhg-h5i4p331f509****
&FailoverMode=MaintainTime
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<ReplaceDedicatedHostReponse>
  <DedicatedHostId> dhg-6w7q18iwt5jo****</DedicatedHostId>
  <TaskId>10254125</TaskId>
  <RequestId>D6E068C3-25BC-455A-85FE-45F0B22EDSD8</RequestId>
</ReplaceDedicatedHostReponse>

JSON格式

{
    "DedicatedHostId": " dhg-6w7q18iwt5jo****",
    "TaskId": "10254125",
    "RequestId": "D6E068C3-25BC-455A-85FE-45F0B22EDSD8"
}

错误码

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