调用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"
}

错误码

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