ReplaceDedicatedHost - 替换专属集群的主机

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

接口说明

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

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RegionIdstring

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

cn-hangzhou
DedicatedHostIdstring

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

ch-bp10a5id3boqi****
FailoverModestring

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

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

返回参数

名称类型描述示例值
object
DedicatedHostIdstring

专属集群的主机 ID。

ch-bp10a5id3boqi****
RequestIdstring

请求 ID。

D6E068C3-25BC-455A-85FE-45F0B22EDSD8
TaskIdinteger

任务 ID。

10254125

示例

正常返回示例

JSON格式

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

JSON格式

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

错误码

HTTP status code错误码错误信息
404InvalidDedicatedHostId_NotFoundspecific DedicatedHostId not found

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