跳到主要内容

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       指定域名