跳到主要内容

绑定云函数

提示

如果您需要集成配套的云函数模板代码（含微信支付、微信公众号等场景的云函数源码 + 前端示例 + 最小可运行 demo），可以前往 示例工程与参考资料 直接 clone 改造。

使用 tcb integration bind-resource 命令将集成实例绑定到云函数，实现业务逻辑与集成的关联。

tcb integration bind-resource <keyId> --function <function-name>

命令参数​

参数说明必填
<keyId>集成实例标识（位置参数）是
--function <function>要绑定的云函数名称是
--yes跳过覆盖确认否
--json以 JSON 格式输出结果否

注意：集成实例通过位置参数 <keyId> 指定，不支持 --name 选项（因为 name 不是唯一标识，可能有多个同名集成）。

使用示例​

通过 Key ID 绑定​

tcb integration bind-resource zhifuceshi-2qrnox2h --function my-function

JSON 格式输出​

tcb integration bind-resource zhifuceshi-2qrnox2h --function my-function --json

输出示例：

{
  "RequestId": "abc-123-def-456"
}

自动化脚本​

在 CI/CD 流程中，建议使用 --yes 参数跳过交互确认（覆盖绑定时需要）：

tcb integration bind-resource zhifuceshi-2qrnox2h --function my-function --yes

输出示例​

普通输出​

✓ 已将集成实例 zhifuceshi-2qrnox2h 绑定到云函数 my-function

改绑输出​

如果集成实例已绑定到其他云函数，会提示确认覆盖：

? 集成实例 zhifuceshi-2qrnox2h 已绑定云函数 old-function，确认改绑到 new-function 吗？ (y/N)

确认后会输出：

✓ 已将集成实例 zhifuceshi-2qrnox2h 由 old-function 改绑到云函数 new-function

已绑定输出​

如果集成实例已经绑定到指定云函数，会提示无需变更：

i 集成实例 zhifuceshi-2qrnox2h 已绑定到云函数 my-function，无需变更

工作原理​

绑定云函数后，集成实例会与指定的云函数建立关联：

  1. 集成配置传递：集成的配置信息（如 AppId、AppSecret 等）会传递给云函数
  2. 业务逻辑执行：云函数可以使用集成配置执行相应的业务逻辑
  3. 权限管理：通过集成绑定方式，实现权限的统一管理和控制

注意事项​

  • 绑定前请确保云函数已部署
  • 一个集成实例只能绑定一个云函数
  • 重复绑定会覆盖之前的绑定关系（需要确认）
  • 绑定后可以在集成详情中查看绑定的云函数名称

解绑云函数​

如需解绑云函数，可以编辑 cloudbaserc.json 配置文件，删除对应集成的 demoCodeFunctionName 字段，然后执行：

# 推送配置到云端
tcb config update integration <keyId>

提示：也可以通过控制台操作解绑。

相关文档​