使用InvokeFunction API調用函數-Function Compute-阿里雲

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

fc:InvokeFunction

none

*全部資源

*

無

請求文法

POST /2021-04-06/services/{serviceName}/functions/{functionName}/invocations HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
serviceName	string	是	服務名稱。	demoService
functionName	string	是	函數名稱。	demoFunction

請求參數

名稱	類型	必填	描述	樣本值
X-Fc-Invocation-Type	string	否	調用方式。取值說明如下： Sync：同步調用。 Async：非同步呼叫。預設值：同步調用。	Sync
X-Fc-Log-Type	string	否	請求返回日誌。 Tail：返回當前請求產生的最後 4 KB 日誌。 None：預設值，不返回請求日誌。	None
qualifier	string	否	服務的版本 ID 或者別名。	demoQualifier
body	string	否	事件（event），類型為 binary。Function Compute服務將事件傳遞給使用者的函數來處理。	{"key":"value"}
X-Fc-Stateful-Async-Invocation-Id	string	否	非同步任務 ID。您需要事先開啟非同步任務。說明建議您在使用 SDK 調用時設定與業務相關的 ID，方便對相關執行進行後續操作。例如，一個視頻處理函數可以使用視頻檔案名稱作為調用 ID，通過該 ID 可以查看視頻是否處理完成或終止視頻的處理。該 ID 的命名規則只能以英文大小寫字母或底線（_）開頭，由英文大小寫字母、數字（0-9）、底線（_）及短劃線（-）組成，不超過 128 個字元。如果您未設定非同步呼叫的 ID，系統則會自動產生一個 ID。	test-invoke-id
X-Fc-Stateful-Async-Invocation-Enable	string	否	請求層級非同步任務開關。取值說明如下： true：開啟本次非同步呼叫為非同步任務。 false：預設值。說明本參數僅面向非同步呼叫，對非同步呼叫生效，同步調用不生效。	true
X-Fc-Account-Id	string	否	您的阿里雲帳號（主帳號）ID。	188077086902****
X-Fc-Date	string	否	函數的調用開始日期，格式為EEE,d MMM yyyy HH:mm:ss GMT。	Wed, 11 May 2022 09:00:00 GMT
X-Fc-Trace-Id	string	否	調用函數的 ID，與返回參數 requestId 對應。	test-trace-id

返回參數

名稱	類型	描述	樣本值
	string	請求傳回值。	hello world

樣本

正常返回樣本

JSON格式

"hello world"

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。