跳到主要内容

HTTP 网关

已废弃（v3.0.0+）

tcb service 命令自 v3.0.0 起已废弃，相关能力已由以下命令取代：

旧能力新命令文档
安全域名白名单tcb cors add/list/rm安全域名管理
绑定/解绑自定义域名tcb domains add/ls/rm自定义域名管理
创建/管理路由规则tcb routes add/list/edit/deleteHTTP 网关路由管理

旧命令保留向后兼容，但不再维护，建议尽快迁移。

HTTP 网关支持通过 HTTP 链接访问云开发资源。

可以通过 CLI 工具、控制台管理访问域名和云函数访问路径。

创建​

您可以使用下面的命令，通过 CLI 命令行交互的方式创建 HTTP 网关地址

tcb service create -e envId

您也可以指定指定云函数名称 functionName 和触发路径 servicePath 创建 HTTP 网关地址

tcb service create -p servicePath -f functionName

删除 HTTP 网关链接​

您可以使用下面的命令，通过 CLI 命令行交互的方式删除云函数 HTTP 网关链接

tcb service delete -e envId

您也可以通过参数指定需要删除的 HTTP 网关信息：

# 指定 HTTP 网关绑定的路径
tcb service delete -p servicePath

# 指定 HTTP 网关 Id
tcb service delete -i serviceId

# 通过函数名删除该函数的所有 HTTP 网关
tcb service delete --name functionName
参数说明

使用 --name 或 -n 参数时，确保格式正确：--name value 或 -n value。错误格式 -name value 会被解析成 -n ame。

开关 HTTP 网关​

您可以通过下面的命令开启或关闭 HTTP 网关：

tcb service switch -e envId

鉴权开关​

您可以通过下面的命令开启或关闭 HTTP 网关鉴权：

tcb service auth switch -e envId

查询 HTTP 网关信息​

您可以通过下面的命令列出所有的 HTTP 网关链接，查看它们的基本信息：

tcb service list

您会得到类似下面的输出：

| 服务 ID                              | 触发路径     | 关联资源          | 触发类型 | 创建时间            |
|--------------------------------------|--------------|-------------------|----------|---------------------|
| ab2c6749-b6ef-45ca-893e-c7bd2adb5ea2 | /http-test   | simple-event-func | 云函数   | 2026-03-13 14:45:10 |
| 94eb95da-2a91-456c-b6f2-5bdd10833a79 | /image-test  | image-http-fun    | 云托管   | 2026-03-16 21:33:39 |
| 341f0a9f-7b5e-4505-b111-7c73f678a353 | /test        | httpTest          | 云托管   | 2026-03-13 14:39:08 |

设置更多的查询约束条件​

-d domain       指定域名
-p servicePath  指定 HTTP 网关路径
-i serviceId    指定 HTTP 网关 Id

绑定 HTTP 网关自定义域名​

注意事项

绑定自定义域名之前，请先设置您的域名的 CNAME 记录值为默认域名，CNAME 记录不存在时会导致域名绑定失败！

您可以通过下面的命令绑定 HTTP 网关域名：

tcb service domain bind domain

解绑 HTTP 网关自定义域名​

您可以通过下面的命令解绑 HTTP 网关域名：

tcb service domain unbind domain

查询 HTTP 网关自定义域名​

您可以通过下面的命令列出所有的 HTTP 网关域名，查看它们的基本信息：

tcb service domain list

您会得到类似下面的输出：

设置更多的查询约束条件​

-d domain       指定域名