创建应用，发布应用版本方法参 见：更新应用版本状态。
1.1.9.3 升级边缘应用
}
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed 409 Conflict
429 Too Many Requests 500 Internal Server Error
错误码
请参见错误码。
1.1.9.3 升级边缘应用
功能介绍
升级边缘应用前需确保：
● Edge处于在线状态。相关方法请参见：查询Edge。
● 待升级的应用版本状态已更新至发布。相关方法请参见：更新应用版本状态 如升级边缘应用接口调用成功，稍后边缘设备将会自动升级至新版本无需手动操作。
自动安装完成后应用将处于运行中的状态。
URI
PUT /v1/{project_id}/v2x-edges/{v2x_edge_id}/apps/{edge_app_id}
表1-130 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
edge_app_id 是 String 参数说明：应用唯一ID，升级边 缘应用前应先部署边缘应用，方 法参见：部署边缘应用。
取值范围：只允许字母、数字、
下划线（_）、连接符（-）、美 元符号（$）的组合。
最小长度：1 最大长度：32
v2x_edge_id 是 String 参数说明：Edge ID，用于唯一 标识一个Edge，创建Edge后获 得。方法参见 创建Edge。
最大长度：255
请求参数
表1-131 请求 Header 参数
参数 是否必选 参数类型 描述
Instance-Id 否 String 参数说明：实例ID。dris物理实 例的唯一标识。获取方法参见获
取Instance-Id。
取值范围：仅支持数字，小写字 母和连接符（-）的组合，长度 36。
正则匹配：^[a-z0-9-]{36}$
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 参数说明：用户Token，Token 认证鉴权时必选。通过调用IAM 服务 获取IAM用户Token接口 获取，接口返回的响应消息头中
“X-Subject-Token”就是需要 获取的用户Token。简要的获取 方法样例请参见 Token认证。
最小长度：1 最大长度：20000
表1-132 请求 Body 参数
参数 是否必选 参数类型 描述
app_version 是 String 参数说明：应用版本，比如 1.0.0，升级边缘应用版本时应 确保应用版本状态为发布
（PUBLISHED），查询应用版 本状态方法参见：查询应用版本
详情，更新应用版本状态方法参
见：更新应用版本状态。取值范围：只允许小写字母、数 字、连接符（-）、点（.）的组 合且要以小写字母或数字开头和 结尾。
最小长度：1 最大长度：64
正则匹配：^([a-z0-9]([a-z0-9-.])*[a-z0-9])|([a-z0-9])$
响应参数
状态码： 200
表1-133 响应 Body 参数
参数 参数类型 描述
v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge。
最小长度：0
参数 参数类型 描述
edge_app_id String 参数说明：用户自定义应用唯一ID。
最小长度：1 最大长度：32
正则匹配：^[A-Za-z0-9-_$]*$
app_version String 参数说明：应用版本，比如1.0.0。
最小长度：1 最大长度：64
正则匹配：^([a-z0-9]([a-z0-9-.])*[a-z0-9])|([a-z0-9])$
status String 参数说明：应用部署状态。
取值范围：
● UNINSTALLED：待部署
● INSTALLED：部署中
● OFFLINE：离线
● ONLINE：在线
● UPGRADING：升级中
● DELETING：删除中
● RUNNING：运行中
请求示例
PUT https://{endpoint}/v1/{project_id}/v2x-edges/{v2x_edge_id}/apps/{edge_app_id}
Content-Type:application/json X-Auth-Token:********
Instance-Id:********
{ "app_version" : "1.0.1"
}
响应示例
状态码： 200 OK
{ "v2x_edge_id" : "74297d76-6f99-4fe2-a435-1e27a524e4c8", "edge_app_id" : "test-app",
"app_version" : "1.0.1", "status" : "RUNNING"
}
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed 409 Conflict
429 Too Many Requests 500 Internal Server Error
错误码
请参见错误码。