配置HTTP触发器并使用HTTP触发

步骤一：创建触发器

1. 登录函数计算控制台，在左侧导航栏，单击函数。

2. 在顶部菜单栏，选择地域，然后在函数页面，单击目标函数。

3. 在函数详情页面，选择配置页签，在左侧导航栏，单击触发器，然后单击创建触发器。

4. 在创建触发器面板，填写相关信息，然后单击确定。

   配置项	操作	本文示例
   触发器类型	选择HTTP 触发器。	HTTP 触发器
   名称	填写自定义的触发器名称。	http-trigger
   版本或别名	默认值为LATEST，如果您需要创建其他版本或别名的触发器，需先在函数详情页的版本或别名下拉列表选择该版本。关于版本和别名的简介，请参见管理版本和管理别名。	LATEST
   请求方法	指定可以通过哪些方法触发器该HTTP触发器。	GET, POST, PUT, DELETE
   禁用公网访问 URL	默认选择否，即允许公网域名访问该触发器。 如果选择是，创建的HTTP触发器将不提供默认的公网域名。此时，如果通过公网域名来调用函数，将会提示错误access denied due to function internet URL is disable。通过自定义域名的访问，则不受影响。	否
   认证方式	选择函数计算对HTTP请求的认证方式。取值说明如下： 无需认证：无需对HTTP请求进行身份认证，支持匿名访问，任何人可发起HTTP请求调用您的函数。 签名认证：需要对HTTP请求进行身份认证。关于签名认证的示例代码，请参见通过签名访问HTTP触发器地址。 JWT 认证：需要对HTTP请求进行JWT认证。更多信息，请参见为HTTP触发器配置JWT认证鉴权。	无需认证

   创建完成后，您可以根据情况对HTTP触发器的配置项进行修改，包括版本或别名、请求方法、禁用公网访问 URL和认证方式。

步骤二：编写并部署代码

完成创建HTTP触发器后，您可以开始编写函数代码。

步骤三：测试函数

方式一：使用控制台测试函数

方式二：使用cURL测试函数

• 同步调用

  在命令行执行如下命令，执行完成后会返回执行结果。

  curl -v https://http-***.cn-shenzhen.fcapp.run/$path

• 异步调用

  在命令行执行如下命令，执行完成后会返回函数计算接收请求的结果。其中状态码202表示请求成功，其余表示请求出现错误，关于错误码的解释，请参见常见问题（错误排查）。

  curl -v -H "X-Fc-Invocation-Type: Async" https://http-***.cn-shenzhen.fcapp.run/$path

（可选）使用API网关保护函数

默认情况下，函数计算不会对HTTP请求进行身份验证，支持匿名访问函数，即任何人都可以发送HTTP请求调用您的函数。为防止非法用户访问您的函数，引起不必要的资源浪费或安全隐患，您可以开启身份认证的同时将HTTP函数与API网关进行对接，利用API网关的IP访问控制插件、JWT认证插件或BasicAuth插件等保护您的HTTP函数。

1. 在函数计算控制台找到目标函数，在函数详情页面单击配置页签，在左侧导航栏选择触发器，然后单击编辑。

2. 在编辑触发器面板，禁用公网访问 URL选择为是。

3. 登录API网关控制台，切换至HTTP函数所在地域。

4. 创建分组。具体操作，请参见创建分组。

5. 将您的域名通过CNAME方式解析到API网关提供的二级域名上。具体操作，请参见CNAME绑定域名。

6. 创建API。

   主要配置项设置如下，其余配置项下的设置选择默认值或者根据实际情况填写即可。更多信息，请参见创建 API。

   • 安全认证：选择无认证，后续会使用插件进行认证。

   • 请求Path：填写根目录/，然后选中匹配所有子路径。

   • HTTP Method：选择ANY。

   • 入参请求模式：选择入参透传。

   • 后端服务类型：选择函数计算。

   • 产品版本：选择函数计算3.0。

   • 函数类型：选择HTTP函数。

   • 触发器路径：填写函数计算的HTTP触发器的内网访问地址。

   • ContentType：选择透传客户端ContentType头。

7. 发布API。单击已创建的API右侧操作列的发布，选择线上环境，然后单击发布。

8. 创建一个类型为后端签名的插件，key和secret分别配置为您的阿里云账号的AccessKey ID和AccessKey Secret。然后绑定您刚才创建的API。具体操作，请参见插件概述。

错误排查

如果问题还未能解决，请加入钉钉用户群（钉钉群号：11721331），联系函数计算工程师及时沟通处理。。