函数计算通过API调用如何传入参数？

函数计算通过API调用传入参数的方式主要依赖于请求的结构和内容。以下是详细的参数传递方式及注意事项：

1. 通过InvokeFunction API传递参数

在调用函数计算的InvokeFunction API时，可以通过event参数将数据传递给函数。event参数的内容会被直接映射为函数的输入参数。

• 请求格式
  InvokeFunction API的请求体中，event字段用于传递参数。例如：

  {
  "key1": "value1",
  "key2": "value2"
  }
  

  这个JSON对象会被函数计算解析并作为函数的输入参数。

• 转换规则
  函数计算会将InvokeFunction请求转换为HTTP请求（如果使用HTTP触发器），具体规则如下：

  • event参数被转换为HTTP请求的消息体。
  • HTTP请求的path固定为/invoke。
  • 请求方法固定为POST。
  • Content-Type消息头默认为application/octet-stream。

  示例：

  POST /invoke HTTP/1.1
  Host: <函数计算服务地址>
  Content-Length: 11
  Content-Type: application/octet-stream
  
  {"key":"value"}
  

2. 通过API网关传递参数

当函数计算作为API网关的后端服务时，API网关会将请求的相关信息以固定的Map结构传递给函数计算。函数计算通过解析event参数获取这些信息。

• API网关传入参数的格式
  API网关会将请求的路径、方法、头部、查询参数、路径参数以及请求体等内容封装为一个JSON对象，传递给函数计算。示例如下：

  {
  "path": "api request path",
  "httpMethod": "request method name",
  "headers": { "headerKey1": "headerValue1", "headerKey2": "headerValue2" },
  "queryParameters": { "queryKey1": "queryValue1", "queryKey2": "queryValue2" },
  "pathParameters": { "pathKey1": "pathValue1" },
  "body": "string of request payload",
  "isBase64Encoded": "true|false"
  }
  

• 重要说明

  • 如果isBase64Encoded的值为true，表示body内容已进行Base64编码，函数计算需要先对body内容进行解码后再处理。
  • 如果isBase64Encoded的值为false，则可以直接使用body内容。

3. 通过HTTP触发器或自定义域名传递参数

如果函数计算配置了HTTP触发器或自定义域名，可以通过HTTP请求直接传递参数。请求的头部、路径、查询参数和消息体都可以作为输入参数传递给函数。

• 请求头控制行为
  在HTTP请求中，可以通过特定的请求头控制函数的行为。例如：

  • X-Fc-Invocation-Type：指定调用类型，取值为Sync（同步调用）或Async（异步调用）。
  • X-Fc-Log-Type：指定是否返回日志，取值为Tail（返回最后4 KB日志）或None（不返回日志）。

• 请求体传递参数
  HTTP请求的消息体可以直接作为函数的输入参数。例如：

  POST / HTTP/1.1
  Host: <函数计算服务地址>
  Content-Type: application/json
  
  {
  "param1": "value1",
  "param2": "value2"
  }
  

4. 通过SDK传递参数

使用函数计算的SDK调用函数时，可以通过InvokeFunction方法传递参数。SDK会将参数封装为请求体并发送到函数计算服务。

• 示例代码（Python SDK）

  from aliyunsdkcore.client import AcsClient
  from aliyunsdkfc.request.v20210406 import InvokeFunctionRequest
  
  client = AcsClient('<accessKeyId>', '<accessSecret>', '<regionId>')
  request = InvokeFunctionRequest.InvokeFunctionRequest()
  request.set_ServiceName('<serviceName>')
  request.set_FunctionName('<functionName>')
  request.set_Event('{"key1": "value1", "key2": "value2"}')
  
  response = client.do_action_with_exception(request)
  print(response)
  

5. 特殊场景下的参数处理

• 随机数替换
  如果某些字段需要动态生成（如随机数），可以在函数内部进行处理。例如，当seed字段为-1时，可以将其替换为随机数：

  if (event.seed === -1) {
  event.seed = Math.random();
  }
  

• 清理资源
  在测试或调试完成后，建议及时清理不再使用的资源，避免产生额外费用。

总结

函数计算通过API调用传入参数的方式主要包括以下几种： 1. 使用InvokeFunction API直接传递event参数。 2. 通过API网关传递固定的Map结构参数。 3. 使用HTTP触发器或自定义域名传递请求头、路径、查询参数和消息体。 4. 使用SDK封装参数并通过InvokeFunction方法调用。

请根据实际需求选择合适的参数传递方式，并注意处理特殊情况（如Base64编码、随机数替换等）。