全部产品
Search

搜索本产品

    边缘节点服务ENS：UpgradeApplication - 应用容器版本升级

    文档中心

    边缘节点服务ENS：UpgradeApplication - 应用容器版本升级

    更新时间：Aug 27, 2026

    调用UpgradeApplication异步进行容器版本更新，支持多种灰度策略。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:UpgradeApplication

    update

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    AppId

    string

    是

    应用 ID。

    a2bac6f4-75dc-455e-8389-2dc8e47526d3
    Template

    string

    是

    灰度升级信息模版，Json 格式的字符串，内容包括：

    • 待升级版本范围

    • 目标版本配置信息

    • 资源灰度选择策略

    • 智能升级策略（时间窗口、水位等信息）

    {\"fromAppVersions\":{ \"operator\":\"In\", \"values\":[ \"v1\", \"v2\" ] }, \"toAppVersion\":\"v3\", \"descrip\":\"xxx\", \"workload\":[ { \"name\":\"nginx\", \"podSpec\":{ } } ], \"upgradeStrategy\":{ \"name\":\"ScheduleToISP\", \"parameters\":{ \"operator\":\"In\", \"values\":[ \"telecom\" ] } }, \"autoUpgradeStrategy\":{ \"name\":\"AdjustToPodUsage\", \"checkInterval\":600, \"startTime\":\"2021-02-19 00:00:00\", \"startHourPoint\":\"0\", \"endHourPoint\":\"8\", \"endTime\":\"2021-02-19 08:00:00\", \"level\":\"RegionId\", \"rules\":[ { \"regionCodes\":[ \"cn-wuxi-telecom_unicom_cmcc\", \"cn-shijiazhuang-telecom_unicom_cmcc\" ], \"usageRatioLimit\":{ \"maxPodUsageRatio\":50 }, \"maxUpgradingRatio\":50 }, { \"regionCodes\":[ \"cn-wuhan-telecom_unicom_cmcc\" ], \"usageRatioLimit\":{ \"maxPodUsageRatio\":30 }, \"maxUpgradingRatio\":20 }, { \"regionCodes\":[ \"All\" ], \"usageRatioLimit\":{ \"maxPodUsageRatio\":20 }, \"maxUpgradingRatio\":50, \"maxUpgradingCount\":2 } ] }}
    Timeout

    integer

    否

    应用异步升级的超时时间，单位秒。默认 300。

    1800

    返回参数

    名称

    类型

    描述

    示例值

    object

    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    TaskId

    string

    任务 ID，可以通过任务 ID 查询升级进度或状态。

    6f24a774-6bd5-4026-bb7d-deffb1dad875

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TaskId": "6f24a774-6bd5-4026-bb7d-deffb1dad875"
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 MissingParameter The input parameter that is mandatory for processing this request is not supplied.
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.
    400 InvalidParameter The errorMessage is %s. Please check it again.
    400 ens.interface.error An error occurred while calling the API.
    400 CallInterface Call Interface Happen Error. 接口调用出错。

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

    变更历史

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