别名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 全局参数。

表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

执行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 全局参数。

表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

执行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 输出示例

alias publish命令

alias publish命令，是对别名进行发布和更新的命令。

当执行命令alias publish -h/alias publish --help时，可以获取帮助文档。

当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 Serverless Devs 全局参数。

表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

执行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