更新时间：2026-09-02 GMT+08:00

重试(终止)升级失败或切换可用区失败的任务

功能介绍

由于升级、切换实例可用区过程时间较长，可能由于网络等原因导致升级失败，通过该接口可以重试或停止升级失败的任务。

接口约束

执行此接口时，任务状态须为失败。
执行跨版本升级时，当系统显示“任务状态”为“失败”，必须验证所有节点均未成功升级，方可终止升级任务。
执行切换可用区任务时，当系统显示“任务状态”为“失败”，必须验证所有节点均未成功切换，方可终止切换任务。

调用方法

请参见如何调用API。

URI

PUT /v1.0/{project_id}/clusters/{cluster_id}/upgrade/{action_id}/retry

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及取值范围：账户的项目ID。默认取值：不涉及
cluster_id	是	String	参数解释：指定重试的集群ID。获取方法请参见获取集群ID。约束限制：不涉及取值范围：集群ID。默认取值：不涉及
action_id	是	String	参数解释：指定重试的任务ID。获取方法请参见获取集群升级或切换AZ的详情信息。约束限制：失败任务ID。取值范围：不涉及默认取值：不涉及

表2 Query参数
参数	是否必选	参数类型	描述
retry_mode	否	String	参数解释：选择重试模式。当配置该参数时，表示是终止升级任务；当不配置该参数时，表示重试升级任务。约束限制：当前仅支持abort。取值范围： abort：终止升级任务。默认取值：不涉及

请求参数

无

响应参数

状态码：200

请求成功。

无

请求示例

升级任务、切换集群实例可用区任务重试请求示例。

PUT https://{Endpoint}/v1.0/{project_id}/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/upgrade/bcdb711c-a7f0-4007-b8ee-9f13c05f8326/retry

升级任务、切换集群实例可用区任务终止请求示例。

PUT https://{Endpoint}/v1.0/{project_id}/clusters/ea244205-d641-45d9-9dcb-ab2236bcd07e/upgrade/bcdb711c-a7f0-4007-b8ee-9f13c05f8326/retry?retry_mode=abort

响应示例

无

状态码

状态码	描述
200	请求成功。
400	非法请求。建议直接修改该请求，不要重试该请求。
403	请求被拒绝访问。返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

描述

200

请求成功。

400

非法请求。

建议直接修改该请求，不要重试该请求。

403

请求被拒绝访问。

返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。

错误码

请参见错误码。

父主题： 集群管理