函数计算：HTTP触发器概述

触发器限制

• 每个版本或别名下最多创建一个 HTTP 类型触发器。详细信息，请参见版本管理和别名管理。

• 内置域名仅用于测试，请勿用于线上对外服务，以免受内置域名稳定性影响。

  说明

  对外提供网站类服务需使用已备案的自定义域名，将域名与函数绑定后对外提供服务。更多信息，请参见配置自定义域名。

HTTP/HTTPS协议使用限制

• HTTP Request限制

  • Request Headers不支持以x-fc-开头的自定义字段和以下自定义字段。

    • connection

    • keep-alive

  • 如果Request超过以下限制，会返回400状态码和InvalidArgument错误码。

    • Headers大小：Headers中的所有Key和Value的总大小不得超过8 KB。

    • Path大小：包括所有的Query Params，Path的总大小不得超过4 KB。

    • Body大小：同步调用请求的Body的总大小不得超过32 MB，关于异步调用请求的Body的大小，请以函数运行资源限制为准。

• HTTP Response限制

  • Response Headers不支持以x-fc-开头的自定义字段和以下自定义字段。

    • connection

    • content-length

    • date

    • keep-alive

    • server

    • upgrade

    • content-disposition:attachment

      说明

      从安全角度考虑，使用函数计算默认的aliyuncs.com域名，服务端会在Response Headers中强制添加content-disposition: attachment字段，此字段会使得返回结果在浏览器中以附件的方式下载。如果要解除该限制，需设置自定义域名。更多信息，请参见配置自定义域名。

  • 如果Response超过以下限制，会返回502状态码和BadResponse错误码。

    • Headers大小：Headers中的所有Key和Value的总大小不得超过8 KB。

同步调用

同步调用指事件被函数处理后直接返回结果。HTTP触发器默认的函数调用方式为同步调用。更多信息，请参见同步调用。

异步调用

异步调用指函数计算收到请求后，将请求持久化保存，然后立即返回响应，而不是等待请求执行完成后，再返回执行结果。

• 异步调用：使用HTTP触发器调用函数时，您可以通过增加请求头"X-Fc-Invocation-Type":"Async"的方式实现请求级别的异步调用。

• 异步任务：HTTP函数配置了异步任务后，您可以通过增加请求头"X-Fc-Async-Task-Id":"g6u*****iyvhd3jk8s6bhj0hh"完成异步任务调用Invocation ID的配置。

关于请求头的更多信息，请参见调用函数。

异步调用成功后，函数计算会返回状态码202，表示请求接收成功。同时会通过请求头返回Request ID，格式如"X-Fc-Request-Id": "80bf7****281713e1"。

简单请求

简单请求不会发送预检请求，您可以直接在函数代码中设置Access-Control-Allow-*开头的Header，完成简单的访问控制。对于简单请求，函数计算支持自定义的Headers包括：Access-Control-Allow-Origin、Access-Control-Allow-Headers、和Access-Control-Max-Age。

如果您没有自定义Headers，函数计算的Response Headers会默认设置为Request请求中相应的字段：

• Access-Control-Allow-Origin：Request请求的Origin Header。

• Access-Control-Allow-Credentials：默认取值为true。

• Access-Control-Expose-Headers：函数计算自定义的一些Header。

非简单请求

非简单请求在发送正式请求前会发送预检请求，即一次非简单请求包含一次OPTIONS方法的函数调用请求和一次实际的函数调用请求。正式请求的规则与上文的简单请求相同。如果您需要自定义预检请求的返回，则需要为HTTP触发器添加OPTIONS方法，然后在函数代码中处理OPTIONS请求，即设置Access-Control-Allow-*开头的Header以控制函数的跨域行为。

对于预检请求，函数计算支持用户自定义的Headers包括Access-Control-Allow-Origin、Access-Control-Allow-Headers、Access-Control-Allow-Methods和Access-Control-Max-Age。

以Node.js内置运行时为例，函数代码中处理预检请求的示例如下所示：

exports.handler =  (event, context,callback) => {
      console.log('hello world');
      const method = JSON.parse(event).requestContext.http.method;
      if (method === 'OPTIONS') {
          // 设置响应头以处理预检请求
          const fcResponse = {
            'statusCode': 204,
            'headers': {
              'Access-Control-Allow-Origin': 'http://www.fc.com',
              'Access-Control-Allow-Methods': 'POST',
              'Access-Control-Allow-Headers': 'Content-Type, Authorization',
              'Access-Control-Max-Age':'3600'
            },
            'body': 'hello world'
        };
        callback(null, fcResponse);
      } else {
        callback(null, {
            'statusCode': 500,
            'body': 'hello world'
        });
      }
    };

API Configured CORS

API Configured CORS 当前为邀测功能。如需开通，请联系我们并提供阿里云账号 ID（UID）。