全部产品
Search

搜索本产品

    云服务器 ECS：RedeployDedicatedHost - 执行专有宿主机的故障迁移

    文档中心

    云服务器 ECS：RedeployDedicatedHost - 执行专有宿主机的故障迁移

    更新时间：Aug 28, 2026

    执行专有宿主机的故障迁移。

    接口说明

    DDH 状态为报警状态（UnderAssessment），即故障潜伏期时，建议您调用该接口执行 DDH 的故障迁移，避免 DDH 产生永久性故障。您可以调用 API DescribeDedicatedHosts 查询专有宿主机的状态信息。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ecs:RedeployDedicatedHost

    update

    *DedicatedHost

    acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    专有宿主机所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou
    DedicatedHostId

    string

    是

    专有宿主机 ID。

    dh-bp165p6xk2tlw61e****
    MigrationType

    string

    否

    是否先停止实例，再迁移到目标专有宿主机。取值范围：

    • Reboot：先停止实例再迁移。

    • LiveMigrationFirst：不停止实例，直接迁移。此时，您必须指定参数 DedicatedHostId。该取值不支持在迁移 ECS 实例的同时变更实例规格。如果在线迁移失败会默认走关机迁移。

    默认值：Reboot。

    Reboot

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    FCED4B7A-53D5-4C04-ABE3-26D4F3890D57

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "FCED4B7A-53D5-4C04-ABE3-26D4F3890D57"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 InvalidDedicatedHostStatus.Malformed The specified DedicatedHost is in inValid status to execute redeployment.
    400 InvalidInstanceStatus.Unstopped There is unstopped instances on DedicatedHost.
    403 InvalidUser.Unauthorized The user is not authorized.
    404 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist.

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

    变更历史

    更多信息，参考变更详情。