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

当主机状态为故障中时,您可调用DescribeDedicatedHostAttribute接口,通过返回参数HostStatus的值获取当前主机的状态。

调试

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

请求参数

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

系统规定参数,取值:ReplaceDedicatedHost

DedicatedHostId String dhg-h5i4p331f509****

专属集群的主机ID,可调用DescribeDedicatedHosts获取。

FailoverMode String MaintainTime

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

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

地域ID。可调用DescribeRegions获取。

返回数据

名称 类型 示例值 描述
DedicatedHostId String dhg-6w7q18iwt5jo****

专属集群的主机ID。

RequestId String D6E068C3-25BC-455A-85FE-45F0B22E****

请求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"}

错误码

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