tencent cloud

云函数

动态与公告
产品动态
产品公告
新手指引
产品简介
产品概述
相关概念
工作原理
产品优势
应用场景
相关产品
购买指南
计费概述
计费方式
计费项与计费方式
函数算力支持
免费额度
产品定价
计费示例
欠费与停服说明
快速入门
使用控制台创建一个事件函数
操作指南
配额管理
函数管理
Web 函数管理
日志管理
并发管理
触发器管理
函数 URL
自定义域名
版本管理
别名管理
权限管理
运行实例管理
插件管理
监控与告警管理
网络配置
层管理
执行配置
扩展存储管理
DNS 缓存配置
资源托管模式管理
近离线资源托管模式
工作流
触发器
触发器概述
触发器事件消息结构汇总
API 网关触发器
COS 触发器
CLS 触发器
定时触发器
CKafka 触发器
Apache Kafka 触发器
MQTT 触发器
触发器配置描述
MPS 触发器
CLB 触发器说明
云 API 触发器
开发指南
基本概念
测试云函数
环境变量
依赖安装
使用容器镜像
使用 Docker 安装依赖
错误类型与重试策略
死信队列
云函数接入数据库
自动化部署
云函数状态码
常见错误码解决方法
开发者工具
Serverless Web IDE
函数间调用 SDK
第三方工具
代码开发
Python
Node.js
Golang
PHP
Java
Custom Runtime
使用镜像部署函数
Web 框架部署
通过命令行完成框架部署
快速部署 Egg 框架
快速部署 Express 框架
快速部署 Flask 框架
快速部署 Koa 框架
快速部署 Laravel 框架
快速部署 Nestjs 框架
快速部署 Nextjs 框架
快速部署 Nuxtjs 框架
快速部署 Django 框架
实践教程
最佳实践概述
云产品联合解决方案
业务开发相关实践
实时音视频 TRTC
对象存储 COS
消息队列 CKafka
日志服务CLS
负载均衡 CLB
视频处理 MPS
内容分发网络 CDN
云数据仓库 PostgreSQL
云点播 VOD
短信 SMS
Elasticsearch Service
定时任务
视频处理
客户案例
腾讯在线教育
在线教育行业案例
游戏聊天系统
腾讯互娱国际(IEGG)
API 文档
History
Introduction
API Category
Making API Requests
Other APIs
Namespace APIs
Layer Management APIs
Async Event Management APIs
Trigger APIs
Function APIs
函数和层的状态说明
Data Types
Error Codes
SDK文档
常见问题
通用问题
Web 函数相关问题
计费相关问题
网络相关问题
日志相关问题
SCF 工具相关问题
事件处理相关问题
API 网关触发器相关问题
相关协议
Service Level Agreement
联系我们
词汇表

流量路由配置

PDF
聚焦模式
字号
最后更新时间: 2026-01-20 10:08:37

操作场景

云函数(Serverless Cloud Function,SCF)支持流量路由设置。通过该设置,您可便捷控制函数版本在实际使用场合或环境中的灰度上线或回滚流程,避免一次性上线可能带来的风险。
在创建别名或进行流量配置调整时,可通过控制台控制流量指向两个函数版本,实现流量在版本间按照一定的规则路由。目前支持按权重随机路由按规则路由两种路由方案:
当您希望任意两个版本按设定的百分比权重进行随机路由时,可进行 按权重随机路由 操作。
当您想将包含有某个特定内容的请求路由到某一个版本时,可进行 按规则路由 操作。

操作步骤

按权重随机路由

本文以在创建别名时配置为例。完成创建后,流量将按设定的百分比在两个版本间随机路由。步骤如下:
1. 进入“创建别名”窗口。
2. 在“创建别名”窗口中,参考以下信息进行流量路由配置。如下图所示:

主要参数信息如下:
路由方法:选择按权重路由
版本权重设置:可通过下拉列表选择两个版本,并进行百分比权重配置。
3. 单击提交即可完成设置。

按规则路由

使用按规则配置路由时,目前的规则语法包括以下三部分:

匹配 Key

匹配时的取值位置,即通过定位来取值以判断是否命中。 Key 目前支持的写法为 invoke.headers.[userKey],其中 [userKey] 部分代表可修改内容。此写法含义为通过匹配 invoke 接口调用时,HTTP 请求 headers 中的 userKey 部分来进行匹配。

匹配方法

匹配时通过方法与表达式进行对比,目前支持的匹配方法有 exactrange
exact:精确匹配,在使用 exact 方法时,匹配表达式需为字符串。通过匹配 key 读取到的值与表达式精确相等时,即为命中规则。
range:范围匹配,在使用 range 方法时,匹配表达式需为 (a,b) 或 [a,b] 的写法,其中 a,b 要求为整数。通过匹配 key 读取到的值为整数,且在表达式定义的区间中时,即为命中规则。

匹配表达式

匹配设定值即为命中,表达式写法可参见 匹配方法 说明。
您可按照以下步骤,配置按规则路由:
1. 进入“创建别名”窗口。
2. 在“创建别名”窗口中,参考以下信息进行流量路由配置,并单击提交即可完成配置。如下图所示:

主要参数信息如下:
路由方法:选择按规则路由
版本规则设置:请结合以下示例,按需配置:
例如,您有两个版本(版本2和版本1),并且期望版本2匹配规则设置为 invoke.headers.User exact Bob,版本1设置为未命中。可参照下图进行设置:


根据此配置,云函数平台在通过 invoke 接口调用函数别名时,若将 routingKey 参数设置为{"User":"Bob"},则此次执行将使用版本2的代码和配置。若未设置 routingKey 参数或 routingKey 为其他值,则此次执行将使用版本1的代码和配置。
例如,您有两个版本(版本3和版本2),并且期望版本3匹配规则为 invoke.headers.userHash range [1,50],版本2设置为未命中。可参照下图进行配置:


根据此配置,云函数平台在通过 invoke 接口调用函数别名时,若将 routingKey 参数设置为 {"userHash":30},则此次执行将使用版本3的代码和配置。若未设置 routingKey 参数或 routingKey 为除了 [1,50] 外的其他值,例如 {"userHash":80},则此次执行将使用版本2的代码和配置。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈