調用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 | 非同步任務的執行狀態。
|
| 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
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。