注意事项
尊敬的腾讯云用户，您好！
由于 API 网关产品计划于2025年6月30日停止服务，云函数 SCF & Serverless 应用的 API 网关触发器将进行如下调整：
1. 2024年7月1日，新老用户不再支持新建 API 网关触发器，存量 API 网关触发器不受影响。
如果您使用的是 API 网关基础功能，建议改用 函数 URL。
2. 2024年12月31日，API 网关触发器停止发布新版本和新功能，存量 API 网关触发器不受影响。为保障服务的稳定性，建议在此时间点前根据以下指引迁移至函数 URL 或云原生网关。
3. 2025年6月30日，API 网关触发器下线，存量 API 网关触发器将不能查看和使用。
退费操作
如果您有资源在2024年12月31日以后仍在付费有效期内，建议您参见下列指引完成退费操作。
套餐包：参见 套餐包退费。
资源包：参见 资源包退费。
其他函数均不涉及退费，操作删除即可。
对于给您带来的任何不便，我们深表歉意。如果您在迁移期间有其他问题，请随时与我们联系。我们很荣幸能支持您的业务，并期待继续为您服务。谢谢！
迁移指引
函数 URL、云原生网关、API 网关功能对比
对比项 | API 网关 | 函数 URL | TSE 云原生网关 |
产品定位 | 提供 API 完整生命周期管理，提供常见的鉴权限流等应用层能力。 | 函数 URL 是函数的专用，高效 HTTP(S) 端点，提供基于 Serverless 的全生命周期的管理能力，统一由云函数团队维护管理，避免因中间链路网关故障导致可用性问题。 | 流量网关、微服务网关和安全网关三合一，一个高集成、高性能、易扩展、热更新的云原生网关。 支持60多款开源插件和 TSE 增强插件。 提供七层流量处理能力与丰富的高级路由功能。 支持多种服务发现模式（如注册中心、容器、云函数等）和多种服务灰度策略（如金丝雀发布、A/B Test、蓝绿部署和全链路灰度）。 专门面向应用层负载场景，与容器深度集成，网关转发请求时直连后端 Pod IP，支持弹性伸缩，Ingress 模式。 提供丰富的可观测和可运维能力。 |
产品架构 | 自研，支持共享版和专享版。 | 基于云函数底座，支持默认域名。 | 基于开源 Kong，用户独享实例。 |
计费模式 | 共享版：调用次数费+公网流量费 专享版：实例费+公网流量费。 | 不收费。 | 实例费 + 公网流量费。 |
支持协议 | 支持 HTTP 和 HTTPS 协议。 支持 WebSocket、WSS 和 gRPC 协议。 | 支持 HTTPS 协议。 支持 WebSocket、WSS 和 gRPC 协议（规划中）。 | 支持 HTTP 和 HTTPS 协议。 支持 WebSocket、WSS 和 gRPC 协议。 支持 TCP、UDP、HTTP 2.0、HTTP3.0（规划中）。 |
基础路由 | 路由匹配支持 Path，Method。 支持重定向、重写、跨域、超时和重试等。 支持加权轮询负载均衡方式。 | 函数路由规则 链路纯透传 | 路由匹配支持 Path, Method, Host, Header。 支持重定向、重写、跨域、超时和重试等。 支持 HTTP 请求改写（Header, Query, Body, URL）。 支持标准的轮询、最小请求数、一致性 Hash 和预热等。负载均衡模式。支持慢热启动，保证在指定时间窗口转发到后端某机器的流量逐步平滑递增。 支持千级别的路由规则。 |
流量控制 | 支持基础限流、参数限流。 支持缓存、熔断、流量镜像、防重放。 | 支持基于函数版本灰度流量策略。 支持限流、熔断。 | 支持基础限流、参数限流。 支持多条件限流。 支持缓存、熔断、流量镜像。 支持请求改写、响应改写。 |
安全性 | 支持对接 SaaS-WAF。 支持高防 IP。 | 防 DDos。 | 支持对接 SaaS-WAF。 支持对接旁路 WAF（更省流量），支持实例/服务/路由级防护。 支持高防 IP。 支持高防包。 |
认证鉴权 | 支持Basic Auth、密钥对认证、应用认证、OAuth2.0。 支持自定义认证。 | CAM 鉴权：需要对函数 CAM 鉴权验证，用户可以基于函数 InvokeFunctionUrl 接口进行资源管理和使用权限配置。您可以通过配置 InvokeFunctionUrl 策略权限来开放或限制接口的访问。 | 支持 Basic Auth、OAuth2.0、HMAC、APIKey认证。 支持 JWT。 支持自定义认证。 |
可观测能力 | 支持采集Access/Error Log 日志。 支持日志投递到 CLS 。 支持默认监控（16项监控指标）。 通过 Prometheus 进行监控和告警配置。 | 支持采集 Access/Error Log 日志，支持自定义日志格式。 支持日志投递到，支持自定义日志格式，支持 CLS 日志大盘。 支持函数级别、实例级别默认监控。 通过 Prometheus 进行监控和告警配置。 | 支持采集 Access/Error Log，支持自定义日志格式。 支持投递日志到 CLS，支持自定义日志格式，支持 CLS 日志大盘。 支持默认监控（60 多项监控指标）。 支持通过 Prometheus 配置监控和告警，支持内嵌 grafana 视图。 支持 Tracing，包括 SkyWalking、Zipkin、Jaeger、OT。 |
运维能力 | 不支持规格升降配。 不支持弹性伸缩。 | 函数 Serverless 主动调度，超高弹性伸缩，相比 HPA 弹性能力更强。 全托管，免运维。 支持函数、并发、网络升降配。 支持故障演练。 | 全托管，免运维（专业版支持自主网关节点运维）。 支持节点数量/节点规格/网关规格升降配。 支持弹性伸缩 HPA 和 HPC。 支持故障演练（对接腾讯云混沌工程）。 |
后端集成 | 公网 URL/IP VPC 内资源 云函数 SCF（事件函数 /Web函数） 对象存储 COS 事件总线 EB Mock 容器 TKE 通道 注册中心 TSF | 公网 URL/ 内网 URL VPC 内资源 对象存储 COS 事件总线 EB 消息队列 CKAFKA 负载均衡 CLB 容器服务 K8s | 公网 URL/IP 云函数 SCF（事件函数 /Web 函数） 容器服务 K8s 注册中心：Nacos、TSF、TEM DNS：私有 DNS、腾讯云 privateDNS |
扩展性 | 不支持 | 不支持 | 支持自定义插件 |
API 网关迁移到函数 URL
API 网关迁移到函数 URL 迁移步骤如下：
步骤1. 配置迁移
1. 确认域名类型，采用默认域名还是自定义域名。
如果是默认域名，请选择函数 URL。
如果是自定义域名，请使用云原生网关（后续函数 URL 会支持）。
2. 登录 Serverless 控制台，使用控制台创建函数 URL，详情请参见 创建函数 URL。
3. 新建函数 URL 时，进行函数 URL 相关配置、选择版本别名进行流量设置、访问类型。
4. 配置函数错误码相关告警、配置函数日志等。
5. 函数 URL 兼容 apigw 响应集成，无需改造。
6. 黑名单功能暂时无法支持。
步骤2. 切流测试
1. 选取部分非核心业务场景，修改访问地址，将域名由原本的 API 网关地址改为函数 URL 地址。
2. 验证流量是否符合预期。
步骤3. 流量迁移
1. 切流测试通过后，逐步扩展到核心业务。
2. 待充分验证后，进行全量迁移。
3. 迁移过程中配合函数监控告警。
步骤4. 完成
验证迁移是否成功。
API 网关迁移到云原生 API 网关（调用云函数）
步骤1. 配置迁移
1. 明确服务来源，确认服务来源是 SCF、TKE 还是 TSF。
2. 明确服务类型，确认服务类型是 VPC 内、公网 URL/IP 还是 SCF。
3. 从 API 网关导出 API。
4. 将 API 导入到云原生 API 网关的路由中。
5. 配置所需的插件。
6. 配置相关证书。
步骤2. 切流测试
1. 选取部分非核心业务场景修改访问地址，将 DNS 解析到云原生 API 网关的 CLB 地址。
2. 配置 DNS 权重，验证流量是否符合预期。
步骤3. 流量迁移
1. 切流测试通过后，逐步扩展到核心业务。
2. 待充分验证后，切换域名解析进行全量迁移。
3. 迁移过程中配合网关监控告警。
步骤4. 完成
验证迁移是否成功。
