
# 删除remove
#### remove命令
remove 命令是对已经部署的资源进行移除的操作。**资源一旦移除可能无法恢复，所以在使用移除功能时，请您慎重操作。**
#### 命令解析
当执行命令**remove -h/remove --help**时，可以获取帮助文档。
在该命令中，包括了四个子命令：
- [function：删除指定的函数]
- [trigger：删除指定的触发器]
- [version：删除指定的版本]
- [alias：删除指定的别名]
表1参数说明 
| 参数全称       | 参数缩写 | Yaml模式下必填 | 参数含义       |
|:---|:---|:---|:---|
| assume-yes | y    | 选填        | 在交互时，默认选择y |
   
**操作案例：**
有资源描述文件（Yaml）时，可以直接执行**s remove** 进行资源删除，描述文件（Yaml）示例：
```
Function [myFunction] deleted successfully.
```
 #### remove function命令
remove function命令，是删除指定函数的命令。默认会把整个函数删除，包含所有的版本、别名以及触发器。
当执行命令**remove function -h/remove function --help**时，可以获取帮助文档。
表2参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义       |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区         |
| function-name | -    | 选填        | 必填       | 函数名        |
| assume-yes    | y    | 选填        | 必填       | 在交互时，默认选择y |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s remove function**删除指定的函数；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如**s cli fgs remove function --region cn-north-4 --function-name fgs-test**
  ![](https://support.huaweicloud.com/devg-functiongraph/public_sys-resources/notice_3.0-zh-cn.png)
  执行cli 模式时，如果密钥信息不是default，需要添加 access参数，例如**s cli fgs remove function --region cn-north-4 --function-name fgs-test --access xxxx**
  上述命令的执行结果示例：
  ```
  Function [fg-test] deleted.
  ```
  
 
 #### remove trigger命令
remove trigger命令，是删除指定触发器的命令。
当执行命令**remove trigger -h/remove trigger --help**时，可以获取帮助文档。
当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 [Serverless Devs 全局参数](https://support.huaweicloud.com/devg-functiongraph/functiongraph_02_0732.html)。
表3参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义                               |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区                                 |
| function-name | -    | 选填        | 必填       | 函数名                                |
| version-name  | -    | 选填        | 选填       | 指定版本，不设置默认为latest版本                |
| trigger-type  | -    | 选填        | 必填       | 触发器类型                              |
| trigger-name  | -    | 选填        | 必填       | 触发器名，APIG为API名称，OBS为桶名，TIMER为触发器名称 |
| assume-yes    | y    | 选填        | 选填       | 在交互时，默认选择y                         |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s remove trigger**删除Yaml中声明的触发器；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如**s cli fgs remove trigger --region cn-north-4 --function-name fgs-test --trigger-type APIG --trigger-name fgs-test-trigger**
上述命令的执行结果示例：
```
Trigger [fgs-test-trigger] deleted.
```
 #### remove version命令
remove version命令，是用户删除指定已发布的版本命令。
当执行命令**remove version -h/remove version --help**时，可以获取帮助文档。
当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 [Serverless Devs 全局参数](https://support.huaweicloud.com/devg-functiongraph/functiongraph_02_0732.html)。
表4参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义           |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区             |
| function-name | -    | 选填        | 必填       | 服务名            |
| version-name  | -    | 必填        | 必填       | 版本名称，不能为latest |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s remove version --version-name versionName**删除指定versionName的版本；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如**s cli fgs remove version --region cn-north-4 --function-name fgs-test --version-name v1**
上述命令的执行结果示例：
```
Version [v1] deleted.
```
 #### remove alias命令
remove alias命令，是删除指定服务别名的命令。
当执行命令**remove alias -h/remove alias --help**时，可以获取帮助文档。
当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 [Serverless Devs 全局参数](https://support.huaweicloud.com/devg-functiongraph/functiongraph_02_0732.html)。
表5参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义 |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区   |
| function-name | -    | 选填        | 必填       | 服务名  |
| alias-name    | -    | 必填        | 必填       | 别名   |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s remove alias --alias-name aliasName**删除指定别名；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如**s cli fgs remove alias --region cn-north-4 --function-name fgs-test --alias-name pre**
上述命令的执行结果示例：
```
Alias [pre] deleted.
```
