本文导读

展开导读

文档首页/ 函数工作流 FunctionGraph/ 开发指南/ 开发工具/ Serverless Devs/ 指令使用方法/ 别名alias

别名alias

更新时间：2025-02-18 GMT+08:00

查看PDF

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

remove alias命令

具体命令详情请参考remove alias命令。

父主题： 指令使用方法

上一篇：删除remove

下一篇：Yaml文件

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

别名alias

命令解析

alias get命令

alias list命令

alias publish命令

remove alias命令

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈