
# 配置函数的别名
FunctionGraph支持为函数创建别名，并关联指定版本的函数，通过别名调用函数时，即可调用到指定版本的函数。在实际业务场景下，可以通过修改在别名上配置的版本，实现函数版本的更新和回滚，客户端无感知。
一个别名支持配置最多2个函数版本，并为两个版本分配不同的权重，实现灰度发布。
#### 约束与限制
- 单个函数最多可以创建10个别名。
- 一个别名支持配置最多2个函数版本。
 
#### 创建别名
1. 登录[函数工作流控制台](https://console.huaweicloud.com/functiongraph/?locale=zh-cn)，在左侧的导航栏选择"函数 \> 函数列表"。
2. 单击函数的名称，进入函数详情页。
3. 在"别名"页签下，单击"创建别名"。创建指向现有版本的别名，可通过该别名来调用对应版本的函数。
   表1别名配置参数说明 
   | 参数     | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   |:---|:---|
   | 别名名称   | 自定义的别名名称，用于区分不同的别名。以大写或小写字母开头，以字母或数字结尾，可包含字母、数字、下划线和中划线，长度不超过63个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   | 对应版本   | 选择需要关联的函数版本。仅可以为每个版本创建1个别名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | 开启灰度版本 | 选择是否开启灰度版本，开启灰度版本后，一个别名可以同时关联两个版本，根据设置的权重比例，函数切换部分主版本的请求到灰度版本运行。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 灰度版本   | **仅"开启灰度版本"开启时需要配置。** 选择需要关联的灰度版本，latest版本不能作为灰度版本。如需创建版本可参考[配置函数的版本](https://support.huaweicloud.com/usermanual-functiongraph/functiongraph_01_0180.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   | 灰度类型   | **仅"开启灰度版本"开启时需要配置。** 选择灰度版本的流量切换类型。 - 按百分比随机灰度：发给主版本的请求中，根据权重值把对应比例的请求切换到灰度版本。比如权重值为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创建别名   
   ![](https://support.huaweicloud.com/usermanual-functiongraph/zh-cn_image_0000002361884790.png "点击放大")
   
   
 
#### 管理函数别名
1. 登录[函数工作流控制台](https://console.huaweicloud.com/functiongraph/?locale=zh-cn)，在左侧的导航栏选择"函数 \> 函数列表"。
2. 单击函数的名称，进入函数详情页。
3. 在函数详情页的最上方选择"latest"版本。
4. 在"别名"页签下，可看到已创建的别名列表。
   - 单击别名右侧的"编辑"，可修改别名的配置信息。
     图2修改别名   
     ![](https://support.huaweicloud.com/usermanual-functiongraph/zh-cn_image_0000002146051014.png "点击放大") 
   
   - 单击别名右侧的"删除"，在弹窗中单击确定，可删除别名。
     图3删除别名   
     ![](https://support.huaweicloud.com/usermanual-functiongraph/zh-cn_image_0000002181368365.png "点击放大") 
    
 
#### 相关文档
除使用控制台外，函数工作流支持通过API的方式管理函数版本，详情请参见[函数版本别名API](https://support.huaweicloud.com/api-functiongraph/VersionsandAliases.html)。
