更新时间:2025-07-25 GMT+08:00
分享

配置函数的别名

FunctionGraph支持为函数创建别名,并关联指定版本的函数,通过别名调用函数时,即可调用到指定版本的函数。在实际业务场景下,可以通过修改在别名上配置的版本,实现函数版本的更新和回滚,客户端无感知。

一个别名支持配置最多2个函数版本,并为两个版本分配不同的权重,实现灰度发布。

约束与限制

  • 单个函数最多可以创建10个别名。
  • 一个别名支持配置最多2个函数版本。

创建别名

  1. 登录函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 单击函数的名称,进入函数详情页。
  3. 在“别名”页签下,单击“创建别名”。创建指向现有版本的别名,可通过该别名来调用对应版本的函数。
    表1 别名配置参数说明

    参数

    说明

    别名名称

    自定义的别名名称,用于区分不同的别名。以大写或小写字母开头,以字母或数字结尾,可包含字母、数字、下划线和中划线,长度不超过63个字符。

    对应版本

    选择需要关联的函数版本。仅可以为每个版本创建1个别名。

    开启灰度版本

    选择是否开启灰度版本,开启灰度版本后,一个别名可以同时关联两个版本,根据设置的权重比例,函数切换部分主版本的请求到灰度版本运行。

    灰度版本

    仅“开启灰度版本”开启时需要配置。

    选择需要关联的灰度版本,latest版本不能作为灰度版本。如需创建版本可参考配置函数的版本

    灰度类型

    仅“开启灰度版本”开启时需要配置。

    选择灰度版本的流量切换类型。

    • 按百分比随机灰度:发给主版本的请求中,根据权重值把对应比例的请求切换到灰度版本。比如权重值为5%,则会将5%的主版本请求切到灰度版本,95%的请求继续发给主版本。
    • 按指定规则灰度:把满足设定规则的请求切换到灰度版本,该模式仅支持HTTP函数或使用APIG触发器的函数

    权重

    仅“开启灰度版本”开启,且“灰度类型”选择“按百分比随机灰度”时需要配置。

    发给主版本的请求中,切到灰度版本的比例。

    规则模式

    仅“开启灰度版本”开启,且“灰度类型”选择“按指定规则灰度”时需要配置。

    选择满足规则条件的模式。

    • 满足下列所有规则:只有该请求满足规则列表中的所有规则时,才会发送给灰度版本。
    • 满足下列任意规则:只要请求满足规则列表中的任意一条规则,就会发送给灰度版本。

    规则列表

    仅“开启灰度版本”开启,且“灰度类型”选择“按指定规则灰度”时需要配置。

    设置函数请求要满足的规则条件:

    • 参数类型:默认为“Header”,即HTTP请求中的Header参数。
    • 参数:HTTP请求中Header参数的名称,不区分大小写。
    • 条件:Header参数要满足的条件类型,有“=”和“in”两种条件类型。
    • 值:Header参数的值,字符串类型。
      • 条件为“=”时,表示请求中Header参数的值等于设定值时才满足条件。
      • 条件为“in”时,可以设置多个值,并用英文逗号(,)隔开,表示Header参数的值满足其中一个值即满足条件。

    例如,规则1中“参数”为“aaa”,“条件”设置为“=”,“值”设置为“123”,规则2中“参数”为“bbb”,“条件”设置为“in”,“值”设置为“111,222,333”。如果HTTP请求中有Header参数aaa=123,则满足规则1;如果HTTP请求中有Header参数bbb=222,则满足规则2;如果HTTP请求中有Header参数aaa=123和bbb=111,则同时满足规则1和规则2。

    描述

    别名的描述信息,长度不超过512个字符。

  4. 单击“确定”,完成别名的创建,将自动跳转到别名函数的详情页。
    图1 创建别名

管理函数别名

  1. 登录函数工作流控制台,在左侧的导航栏选择“函数 > 函数列表”。
  2. 单击函数的名称,进入函数详情页。
  3. 在函数详情页的最上方选择“latest”版本。
  4. 在“别名”页签下,可看到已创建的别名列表。
    • 单击别名右侧的“编辑”,可修改别名的配置信息。
      图2 修改别名
    • 单击别名右侧的“删除”,在弹窗中单击确定,可删除别名。
      图3 删除别名

相关文档

除使用控制台外,函数工作流支持通过API的方式管理函数版本,详情请参见函数版本别名API

相关文档