调用RestartDedicatedHost接口重启专属集群的主机。

调试

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

请求参数

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

系统规定参数,取值:RestartDedicatedHost

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-45F0B22EDSH

请求ID。

TaskId Integer 10254125

任务ID。

示例

请求示例

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

正常返回示例

XML格式

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

JSON格式

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

错误码

HttpCode 错误码 错误信息 描述
403 InvalidAction.NotSupport The host status does not support the operation. 当前主机状态不支持此操作

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