全部產品
Search
文件中心

Function Compute:GetStatefulAsyncInvocation

更新時間:Aug 20, 2025

調用GetStatefulAsyncInvocation介面擷取合格非同步任務記錄。

StatefulAsyncInvocation:非同步任務。非同步任務在普通的非同步呼叫基礎上增加了狀態管理的功能,更適用於各類任務情境。

調試

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

要求標頭

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

請求文法

GET /services/{serviceName[.qualifier]}/functions/{functionName}/stateful-async-invocations/{statefulAsyncInvocationId} HTTP/1.1

請求參數

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

非同步任務所屬的服務的名稱。

functionName String Path function_name

非同步任務所屬的函數的名稱。

qualifier String Path alias

非同步任務所屬的服務的別名或版本。

statefulAsyncInvocationId String Path e026ae92-61e5-472f-b32d-1c9e3c4e****

非同步任務的ID。

說明 建議您在使用SDK調用時設定與業務相關的ID,方便對相關執行進行後續操作。例如,一個視頻處理函數可以使用視頻檔案名稱作為調用ID,通過該ID可以查看視頻是否處理完成或終止視頻的處理。該ID的命名規則只能以英文大小寫字母或底線(_)開頭,由英文大小寫字母、數字(0-9)、底線(_)及短劃線(-)組成,不超過128個字元。如果您未設定非同步呼叫的ID時,系統則會自動產生一個ID。

返回資料

名稱 類型 樣本值 描述
startedTime Long 2020-08-20T02:28:21Z

非同步任務的開始時間。

endTime Long 2020-08-20T02:38:21Z

非同步任務的結束時間。

functionName String function_name

非同步任務所屬的函數名稱。

qualifier String alias

非同步任務所屬的服務的別名或版本。

serviceName String service_name

非同步任務所屬的服務名稱。

invocationId String e026ae92-61e5-472f-b32d-1c9e3c4e****

非同步任務的任務ID。

requestId String 403fcbd6-ec41-401f-9fa7-386f3d3d****

非同步任務的請求ID。

status String Succeeded

非同步任務的執行狀態。

  • Enqueued:非同步訊息已入隊,等待處理。
  • Dequeued:非同步訊息已出隊,等待觸發。
  • Running:調用執行中。
  • Succeeded:調用執行成功。
  • Failed:調用執行失敗。
  • Stopped:調用執行終止。
  • Stopping:執行停止中。
  • Expired:您給非同步訊息配置了存活有效期間,該訊息因到期已被丟棄(未觸發)。
  • Invalid:您的執行因函數被刪除等原因處於無效狀態(未觸發)。
  • Retrying:非同步呼叫因執行錯誤重試中。
destinationStatus String Succeeded

本次非同步任務的目的狀態。

invocationErrorMessage String UnhandledException

非同步任務調用失敗的錯誤訊息。

InvocationPayload String hello world

非同步任務調用的輸入。

alreadyRetriedTimes Long 3

本次非同步任務失敗後的最大重試次數,預設值為3。取值範圍[0,8]。

樣本

請求樣本

GET /2016-08-15/services/{serviceName[.qualifier]}/functions/function_name/stateful-async-invocations/e026ae92-61e5-472f-b32d-1c9e3c4e**** HTTP/1.1
公用要求標頭

正常返回樣本

JSON格式

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

{
  "functionName" : "function_name",
  "qualifier" : "alias",
  "serviceName" : "service_name",
  "invocationId" : "e026ae92-61e5-472f-b32d-1c9e3c4e****",
  "requestId" : "403fcbd6-ec41-401f-9fa7-386f3d3d****",
  "status" : "Succeeded",
  "destinationStatus" : "Succeeded",
  "invocationErrorMessage" : "UnhandledException",
  "InvocationPayload" : "function_name",
  "alreadyRetriedTimes" : 3
}

錯誤碼

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