跳到主要内容

HTTP 访问服务

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