
# 卸载应用 - Uninstall
#### 功能介绍
本接口用于在工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）中卸载指定运行服务下的应用。及时卸载不再使用的应用，可释放资源用于部署其他应用，避免资源浪费。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/iDME/doc?api=Uninstall)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-idme/idme_api_0017.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                  | 访问级别  | 资源类型（\*为必须）   | 条件键                                                                                                                                                                                                                                                                                                                                                                                                                                        | 别名                  | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | dme:envs:undeployApp | Write | xDM-F-Runtime | - g:ResourceTag/\<tag-key\>   - g:EnterpriseProjectId    | dme:envs:destroyApp | -      |
     
  
 
#### URI
DELETE /v1/{project_id}/envs/{env_id}/apps/{app_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID，用于标识资源所属的项目空间。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-idme/idme_api_0024.html)。 **约束限制：** 不涉及。 **取值范围：** 由英文字母和数字组成，长度为1-36个字符。 **默认取值：** 不涉及。 |
| env_id     | 是    | String | **参数解释：** 运行服务的唯一标识，用于区分不同的运行服务实例。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。                                                                                                                                            |
| app_id     | 是    | String | **参数解释：** 应用唯一标识，用于指定要删除的应用。 **约束限制：** 不涉及。 **取值范围：** 由英文和数字组成。当唯一标识为应用名称时，长度为1-36个字符；当唯一标识为应用ID时，长度固定为32个字符。 **默认取值**： 不涉及。                                                                                               |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** IAM用户的认证Token，用于接口调用身份鉴权。 获取方法请参见[获取IAM用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表示应用卸载成功。
无
#### 请求示例
卸载指定环境的应用
```
DELETE https://{endpoint}/v1/1234567890/envs/000117e9-8c9c-420c-a33a-faea1c1237f1/apps/0069c1abcfda420e9e27588cefbe86dd
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 表示应用卸载成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-idme/ErrorCode.html)。
