简介
云函数(Serverless Cloud Function,SCF)的别名是指向已绑定函数版本的指针,通过使用别名可以调用已绑定的函数。在实际的开发过程中,别名可以帮助您更好的管理项目版本的更新和回滚。同一个版本的函数可以有一个或多个别名,关于函数版本管理请参见 版本管理概述。
使用场景
可以通过别名的设置,为函数创建出多个不同的环境(stage)的区分。例如:
可通过创建 test、release 别名,并配置触发器指向这些别名,来使得不同的代码和配置生效。
可使用别名绑定不同的函数版本,待版本通过测试环境验证后,将正式环境的流量通过路由配置转移到新版本上。流量路由配置的方法请参见 流量路由配置说明。
默认别名
函数在创建后缺省具有一个默认别名($DEFAULT),默认别名生成时指向最近版本($LATEST)。默认别名不可删除或修改名称,但支持流量路由配置。
默认别名的使用
配置触发器和通过云 API 来触发函数时,建议将调用时的
Qualifier
参数置为默认别名($DEFAULT)。说明
通过配置默认别名,可以将触发器和云 API 调用产生的默认流量进行路由控制。
别名的触发器
目前云函数已创建的别名均可以独立绑定触发器。触发器的调用将经过别名,并依据别名的路由配置拉起具体的版本执行。
操作步骤
创建别名
1. 登录 Serverless 控制台,单击左侧导航栏的函数服务。
2. 在“函数服务”列表页面中,单击函数名,进入该函数详情页面。
3. 选择页面右上角的操作 > 创建别名。如下图所示: n
4. 在弹出的“创建别名”窗口中,参考以下信息进行创建。如下图所示:
注意
别名创建完成后,将无法修改别名的名称。
n主要参数信息如下:别名名称:自定义名称。最长60个字符,最短2字符,以字母开头,可包含
a - z
、A - Z
、0 - 9
、-
、_
,且需要以数字或字母结尾,例如 Tencent-cloud_scf
。别名描述:自定义描述。最长1000个字符,可包含英文字母、数字、空格、逗号、句号、中文。
路由方法及版本权重配置:详情请参见 流量路由配置。
5. 单击提交即可完成创建。
修改函数版本绑定的别名
1. 选择函数详情页右上角的操作 > 流量设置。如下图所示: n
2. 在弹出的“流量设置”窗口中,参考以下信息进行设置。如下图所示: n
n主要参数信息如下:别名:在下拉列表中,选择该版本期望绑定的别名。本文以
test02
为例。路由方法及版本权重配置: 配置方法详情请参见 流量路由配置,本文以修改
$LATEST
版本绑定别名为例:路由方法选择为按权重路由。
版本权重配置为:版本
$LATEST
的权重路由为70%,版本1
的权重路由为30%。3. 单击提交即可完成修改,打开版本下拉列表,即可查看修改后效果。如下图所示: n
删除别名
注意
仅永久删除该别名,不包括底层版本代码和配置。
1. 选择在函数详情页右上角的操作 > 删除别名。如下图所示: n
2. 在弹出的“删除别名”窗口中,在下拉列表中选择需删除的别名,并单击提交即可。本文以删除别名
test02
为例。如下图所示: n