升级边缘应用
功能介绍
升级边缘应用前需确保：
Edge处于在线状态。相关方法请参见：“查询Edge”接口。
待升级的应用版本状态已更新至发布。相关方法请参见：“更新应用版本状态”接口。
如升级边缘应用接口调用成功，稍后边缘设备将会自动升级至新版本无需手动操作。自动安装完成后应用将处于运行中的状态。
关于应用在设备侧升级的耗时问题：
从边缘应用升级成功到处于运行中状态的耗时取决于边缘设备所处的网络状况以及应用镜像包的大小，可通过查询边缘应用获取边缘应用部署状态。相关方法请参见：“查询边缘应用”接口。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v1/{project_id}/v2x-edges/{v2x_edge_id}/apps/{edge_app_id}
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 |
edge_app_id |
是 |
String |
参数说明：用户自定义应用唯一ID。 取值范围：长度不大于32，只允许字母、数字、下划线（_）、连接符（-）、美元符号（$）的组合。 |
v2x_edge_id |
是 |
String |
参数说明：Edge ID，用于唯一标识一个Edge，创建Edge后获得。方法参见 创建Edge。 取值范围：长度36，只允许小写字母、数字、连接符（-）的组合。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Instance-Id |
否 |
String |
参数说明：实例ID。DRIS物理实例的唯一标识，获取方法请参见“API参考 > 附录 > 获取Instance-Id”。 取值范围：仅支持数字，小写字母和连接符（-）的组合，长度36。 |
X-Auth-Token |
否 |
String |
参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 “获取IAM用户Token”接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见“API参考 > API > 应用侧API参考 > 如何调用API > 认证鉴权 > Token认证”。 最小长度：1 最大长度：20000 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
app_version |
是 |
String |
参数说明：应用版本，比如1.0.0，升级边缘应用版本时应确保应用版本状态为发布（PUBLISHED），查询应用版本状态方法参见：“查询应用版本详情”接口，更新应用版本状态方法参见：“更新应用版本状态”接口。 取值范围：只允许小写字母、数字、连接符（-）、点（.）的组合且要以小写字母或数字开头和结尾。 最小长度：1 最大长度：64 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
v2x_edge_id |
String |
参数说明：Edge ID，用于唯一标识一个Edge。 最小长度：0 最大长度：255 |
edge_app_id |
String |
参数说明：用户自定义应用唯一ID。 最小长度：1 最大长度：32 |
app_version |
String |
参数说明：应用版本，比如1.0.0。 最小长度：1 最大长度：64 |
status |
String |
参数说明：应用部署状态。 取值范围：
|
请求示例
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 |
错误码
请参见错误码。
