上云无忧 > 文档中心 > 腾讯云云函数使用教程 - 函数 URL 概述
云函数 SCF
腾讯云云函数使用教程 - 函数 URL 概述

文档简介:
简介: 函数 URL 是函数的专用 HTTP(S) 端点。为函数配置函数 URL 后,可以通过 Web 浏览器、curl、Postman 或任何 HTTP 客户端通过其 HTTP(S) 端点调用函数。
*此产品及展示信息均由腾讯云官方提供。免费试用 咨询热线:400-826-7010,为您提供专业的售前咨询,让您快速了解云产品,助您轻松上云! 微信咨询
  免费试用、价格特惠

简介

函数 URL 是函数的专用 HTTP(S) 端点。为函数配置函数 URL 后,可以通过 Web 浏览器、curl、Postman 或任何 HTTP 客户端通过其 HTTP(S) 端点调用函数。
您可以通过 SCF 控制台或 SCF API/CLI 创建和配置函数 URL。创建函数 URL 后,其 URL 端点将永久不变。函数 URL 的端点格式如下:
		
公网: https://<app-id>-<url-id>-<region>.scf.tencentcs.com
内网: https://<app-id>-<url-id>-<region>-in.scf.tencentcs.com
函数 URL 和触发器同级存在,适用于事件函数和 Web 函数。您可以在启用函数 URL 的同时配置 API 网关等触发器。
函数 URL 和函数的版本、别名一对一绑定,您需要手动为每个版本和别名开启或关闭函数 URL。默认情况下,函数 URL 是关闭的。
说明:
如需生成 WSS 地址,请在函数配置中启用 WebSocket 支持。

调用参数

事件函数

请求参数

URL 在接受到请求后,函数将会被触发运行,同时 URL 会将请求的相关信息以 event 入参的形式发送给被触发的函数。请求的相关信息包含了例如具体接受到请求的服务和 API 规则、请求的实际路径、方法、请求的 path、headers、query 等内容:
		
// Event 详细信息示例【兼容apigw协议,去掉headerParameters、isBase64Encoded、pathParameters、queryStringParameters、requestContext 相关字段】:
{
"body":"{\"test\":\"hello world\"}",
"headers":{
"accept":"*/*",
"accept-encoding":"gzip, deflate, br",
"cache-control":"no-cache",
"connection":"keep-alive",
"content-length":"17"
},
"httpMethod":"POST",
"path":"/",
"queryString":{
"a":"1",
"b":"2"
}
}

响应参数

当函数返回响应时,函数会解析响应并将其转换为 HTTP 响应,标准响应负载:
		
{
"statusCode": 201,
"headers": {
"Content-Type": "application/json",
"My-Custom-Header": "Custom Value"
},
"body": "{ \"message\": \"Hello, world!\" }"
}
函数会为您推断响应格式。如果您的函数返回有效的 JSON 并且没有返回 statusCode,函数会假设 statusCode 为200,content-type 为 application/json,body 是函数响应。
函数响应标准响应参数格式如下:
函数输出
HTTP 响应(客户端看到的内容)
								
"Hello, world!"
								
HTTP/2 200
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 15
"Hello, world!"
								
{
"message": "Hello, world!"
}
								
HTTP/2 200
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 34
{
"message": "Hello, world!"
}
								
{
"statusCode": 201,
"headers": {
"Content-Type": "application/json",
"My-Custom-Header": "Custom Value"
},
"body": JSON.stringify({
"message": "Hello, world!"
})
}
								
HTTP/2 201
date: Wed, 08 Sep 2021 18:02:24 GMT
content-type: application/json
content-length: 27
my-custom-header: Custom Value
{
"message": "Hello, world!"
}

Web 函数

URL 在接受到 HTTP 请求后,该函数将会被触发运行,此时 URL 会将 HTTP 请求直接透转,不再做 event 类型格式转换,同时请求响应也直接透转。
相似文档
  • 本文向您介绍如何使用控制台和使用 API 创建函数 URL。 使用控制台创建函数 URL: 1. 登录 Serverless 控制台,单击左侧导航栏的函数服务。 2. 在函数服务页面,单击函数名,进入该函数详情页面。 3. 选择左侧导航中的函数 URL,单击创建函数 URL。
  • 简介: 您可以通过配置认证鉴权策略来控制对函数 URL 的访问。 在配置函数 URL 时,必须指定以下认证选项之一: CAM 鉴权:需要对函数 CAM 鉴权验证,用户可以基于函数 InvokeFunctionUrl 接口进行资源管理和使用权限配置。您可以通过配置 InvokeFunctionUrl 策略权限来开放或限制接口的访问。 开放:不需要对函数请求进行身份验证,支持匿名访问,任何人都可以发起 HTTP 请求调用您的函数。
  • 简介: 云函数(Serverless Cloud Function,SCF)的版本包含了函数的代码及配置。在实际的开发过程中,可通过发布版本固定函数代码及配置内容,减少影响业务系统的问题因素。
  • 操作场景: 当您需要查看某个函数的版本配置、代码等信息时,可参考本文档进行操作。
  • 操作场景: 在完成云函数的配置、提交代码并通过在线测试后,您可以通过发布版本的方式,固化云函数的版本,避免后续因修改代码和测试引起在线业务错误或执行失败。您可以随时发布版本,云函数任何一次的版本发布都将 $LATEST 版本发布为最新版本。
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部