# 别名alias
alias命令是对函数别名操作的命令；主要包括别名的查看、发布、修改、删除等功能。
#### 命令解析
当执行命令**alias -h/alias --help**时，可以获取帮助文档。
在该命令中，包括了四个子命令：
- [alias get命令]
- [alias list命令]
- [alias publish命令]
- [remove alias命令]
 
 #### alias get命令
alias get命令，是获取服务指定别名详情的命令。
当执行命令**alias get -h/alias get --help**时，可以获取帮助文档。
当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 [Serverless Devs 全局参数](https://support.huaweicloud.com/devg-functiongraph/functiongraph_02_0732.html)。
表1参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义 |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区   |
| function-name | -    | 选填        | 必填       | 函数名称 |
| alias-name    | -    | 必填        | 必填       | 别名   |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s alias get --alias-name aliasName**进行指定的别名详情获取；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如**s cli fgs alias get --region cn-north-4 --function-name fg-test --alias-name pre**
![](https://support.huaweicloud.com/devg-functiongraph/public_sys-resources/notice_3.0-zh-cn.png)
执行cli 模式时，如果密钥信息不是default，需要添加 access参数，例如**s cli fgs alias get --region cn-north-4 --function-name fg-test --alias-name pre --access xxxx**
上述命令的执行结果示例：
```
fg-test:
  aliasName:               pre
  versionId:               1
  description:             test publish version
  additionalVersionWeight:
  createdTime:             2021-11-08T06:51:36Z
  lastModifiedTime:        2021-11-08T06:54:02Z
```
 #### alias list命令
alias list命令，是列举别名列表的命令。
当执行命令**alias list -h/alias list --help**时，可以获取帮助文档。
当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 [Serverless Devs 全局参数](https://support.huaweicloud.com/devg-functiongraph/functiongraph_02_0732.html)。
表2参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义      |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区        |
| function-name | -    | 选填        | 必填       | 函数名称      |
| table         | -    | 选填        | 选填       | 是否以表格形式输出 |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s alias list**获取别名列表；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如**s cli fgs alias list --region cn-north-4 --function-name fg-test**
![](https://support.huaweicloud.com/devg-functiongraph/public_sys-resources/notice_3.0-zh-cn.png)
执行cli 模式时，如果密钥信息不是default，需要添加 access参数，例如**s cli fgs alias list --region cn-north-4 --function-name fg-test --access xxxx**
上述命令的执行结果示例：
```
fg-test:
  -
    aliasName:               pre
    versionId:               1
    description:             test publish version
    lastModifiedTime:        2021-11-08T06:54:02Z
    additionalVersionWeight:
```
如果指定了--table参数，如[图1]所示：
图1输出示例   
![](https://support.huaweicloud.com/devg-functiongraph/zh-cn_image_0000002165932328.png "点击放大")
 #### alias publish命令
alias publish命令，是对别名进行发布和更新的命令。
当执行命令**alias publish -h/alias publish --help**时，可以获取帮助文档。
当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 [Serverless Devs 全局参数](https://support.huaweicloud.com/devg-functiongraph/functiongraph_02_0732.html)。
表3参数说明 
| 参数全称          | 参数缩写 | Yaml模式下必填 | Cli模式下必填 | 参数含义                 |
|:---|:---|:---|:---|:---|
| region        | -    | 选填        | 必填       | 地区                   |
| function-name | -    | 选填        | 必填       | 函数名称                 |
| alias-name    | -    | 必填        | 必填       | 别名                   |
| version-name  | -    | 选填        | 必填       | 别名对应的版本名称            |
| description   | -    | 选填        | 选填       | 别名描述                 |
| gversion      | -    | 选填        | 选填       | 灰度版本 Id。灰度版本权重填写时必填  |
| weight        | -    | 选填        | 选填       | 灰度版本权重。灰度版本 Id 填写时必填 |
   
**操作案例：**
- 有资源描述文件（Yaml）时，可以直接执行**s alias publish**进行别名的发布或者更新；
- 纯命令行形式（在没有资源描述Yaml文件时），需要指定服务所在地区以及服务名称，例如 **s cli fgs alias publish --region cn-north-4 --function-name fg-test --alias-name pre --version-name 1**
![](https://support.huaweicloud.com/devg-functiongraph/public_sys-resources/notice_3.0-zh-cn.png)
执行cli 模式时，如果密钥信息不是default，需要添加 access参数，例如**s cli fgs alias publish --region cn-north-4 --function-name fg-test --alias-name pre --version-name 1 --access xxxx**
上述命令的执行结果示例：
```
fg-test:
  aliasName:               pre
  versionId:               1
  description:
  additionalVersionWeight:
  createdTime:             2021-11-08T06:51:36Z
  lastModifiedTime:        2021-11-08T06:51:36Z
```
如果需要对别名进行升级，只需要指定别名之后，进行相对应的参数更新，例如针对上述的pre别名，指定--description参数后再次执行上述命令，执行示例：
```
fc-deploy-test:
  aliasName:               pre
  versionId:               1
  description:             test publish version
  additionalVersionWeight:
  createdTime:             2021-11-08T06:51:36Z
  lastModifiedTime:        2021-11-08T06:54:02Z
```
 #### remove alias命令
具体命令详情请参考[remove alias命令]。