InvokeFunction - Function Compute

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

要求標頭

該介面無特殊要求標頭，關於公用要求標頭資訊，請參見公用參數。

名稱	類型	是否必選	樣本	描述
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數組。Function Compute將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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。