調用InvokeFunction接口執行函數。

請求頭

該接口無特殊請求頭，關于公共請求頭信息，請參見公共參數。

名稱 類型 是否必選 示例 描述
X-Fc-Invocation-Type String 否 Sync

調用方式。取值說明如下：

  • Sync：同步調用。
  • Async：異步調用。
X-Fc-Log-Type String 否 None

請求返回日志。

  • Tail：返回當前請求產生的最后4 KB日志。
  • None：默認值，不返回請求日志。
X-Fc-Stateful-Async-Invocation-Id String 否 g6u*****iyvhd3jk8s6bhj0hh

異步任務ID。您需要事先開啟異步任務。

說明 建議您在使用SDK調用時設置與業務相關的ID，方便對相關執行進行后續操作。例如，一個視頻處理函數可以使用視頻文件名作為調用ID，通過該ID可以查看視頻是否處理完成或終止視頻的處理。該ID的命名規則只能以英文大小寫字母或下劃線（_）開頭，由英文大小寫字母、數字（0-9）、下劃線（_）及短劃線（-）組成，不超過128個字符。如果您未設置異步調用的ID，系統則會自動生成一個ID。

請求語法

POST /services/{serviceName.qualifier}/functions/{functionName} HTTP/1.1

請求參數

名稱 類型 位置 是否必選 示例值 描述
serviceName String Path 是 service_name

服務的名稱。
qualifier String Path 否 LATEST

服務的版本或別名。
functionName String Path 是 function_name

函數的名稱。
String Body 是 {"key1": "value1"}

函數的事件，類型為二進制Byte數組。函數計算將Event傳遞給用戶函數處理。

返回數據

名稱 類型 示例值 描述
X-Fc-Error-Type String UnhandledInvocationError

調用函數的錯誤類型。

  • HandledInvocationError：只有在Node.js中通過callback返回的錯誤是HandledInvocationError。更多信息，請參見錯誤處理。
  • UnhandledInvocationError：除了HandledInvocationError，其余的錯誤都是UnhandledInvocationError。更多信息，請參見錯誤處理。
X-Fc-Log-Result String demo log result

返回日志結果。
X-Fc-Code-Checksum String 5697641582914695457

函數代碼包的CRC-64值。
X-Fc-Stateful-Async-Invocation-Id String g6u*****iyvhd3jk8s6bhj0hh

異步任務ID。您需要事先開啟異步任務。

說明 建議您在使用SDK調用時設置與業務相關的ID，方便對相關執行進行后續操作。例如，一個視頻處理函數可以使用視頻文件名作為調用ID，通過該ID可以查看視頻是否處理完成或終止視頻的處理。該ID的命名規則只能以英文大小寫字母或下劃線（_）開頭，由英文大小寫字母、數字（0-9）、下劃線（_）及短劃線（-）組成，不超過128個字符。如果您未設置異步調用的ID時，系統則會自動生成一個ID。
X-Fc-Instance-Id String 7c43576b-48b1-4c3a-86e5-dcb01872****

函數實例的ID。
X-Fc-Request-Id String dab25e58-9356-4e3f-97d6-f044c4****

函數調用的請求ID。
X-Fc-Max-Memory-Usage String 9.2

函數執行消耗的內存，單位MB。
X-Fc-Invocation-Duration String 10

函數執行消耗的時長，單位毫秒。
X-Fc-Invocation-Service-Version String LATEST

調用函數的版本或者別名。
String hello world

調取函數返回的結果，函數具體的返回內容由您定義。

示例

請求示例

POST /services/{serviceName.qualifier}/functions/function_name HTTP/1.1
Host:fc-ram.aliyuncs.com
X-Fc-Invocation-Type:Sync
X-Fc-Log-Type:None
X-Fc-Stateful-Async-Invocation-Id:g6u*****iyvhd3jk8s6bhj0hh
Content-Type:application/json

{"key1": "value1"}

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "result" : "hello world"
}