说明:当前页面接口为旧版 API,未来可能停止维护。容器服务 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 容器服务 API 3.0。
1. 接口描述
本接口 ( RedeployClusterService ) 用于将服务实例重新部署,常用场景为镜像仓库中镜像发生改变后,通过重部署触发服务重新拉取镜像。
重新部署实例时服务更新策略:
- 服务更新策略分为 Recreate 和 RollingUpdate 两种,详情请参阅 修改服务 输入参数表格中 strategy 的含义。
- 重新部署时,实例的更新策略取决于服务当前设置的更新策略。
- 新创建的服务在未做过任何修改时,默认的更新策略为:RollingUpdate。
接口请求域名:ccs.api.qcloud.com
。
2. 输入参数
以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数。
参数名称 | 描述 | 类型 | 必选 |
---|---|---|---|
clusterId | 集群 ID,请填写 查询集群列表 接口中返回的 clusterId 字段 | String | 是 |
serviceName | 服务名,请填写 查询服务列表 接口中返回的 serviceName 字段 | String | 是 |
namespace | 命名空间,请填写 查询服务列表 接口中返回的 namespace 字段,默认为 default | String | 否 |
3. 输出参数
参数名称 | 描述 | 类型 |
---|---|---|
code | 公共错误码。0 表示成功,其他值表示失败 | Int |
codeDesc | 业务错误码。成功时返回 Success,错误时返回具体业务错误原因 | String |
message | 模块错误信息描述,与接口相关 | String |
4. 示例
输入
https://domain/v2/index.php?Action=RedeployClusterService
&clusterId=clus-xxxxx
&serviceName=test
&其它公共参数
输出
{
"code" : 0,
"codeDesc": "Success",
"message" : "ok"
}