使用GetStatefulAsyncInvocation擷取非同步任務資訊-Function Compute-阿里雲

介面說明

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

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

fc:GetStatefulAsyncInvocation

get

*全部資源

*

無

請求文法

GET /2021-04-06/services/{serviceName}/functions/{functionName}/stateful-async-invocations/{invocationId} HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
serviceName	string	是	非同步任務所屬的服務名稱。	demo-service
functionName	string	是	非同步任務所屬的函數名稱。	demo-function
invocationId	string	是	非同步任務的 ID。說明建議您在使用 SDK 調用時設定與業務相關的 ID，方便對相關執行進行後續操作。例如，一個視頻處理函數可以使用視頻檔案名稱作為調用 ID，通過該 ID 可以查看視頻是否處理完成或終止視頻的處理。該 ID 的命名規則只能以英文大小寫字母或底線（_）開頭，由英文大小寫字母、數字（0-9）、底線（_）及短劃線（-）組成，不超過 128 個字元。如果您未設定非同步呼叫的 ID 時，系統則會自動產生一個 ID。	e026ae92-61e5-472f-b32d-1c9e3c4e****

請求參數

名稱	類型	必填	描述	樣本值
qualifier	string	否	非同步任務所屬服務的別名或版本。	LATEST
X-Fc-Account-Id	string	否	您的阿里雲帳號（主帳號）ID。	188077086902****
X-Fc-Code-Checksum	string	否	函數程式碼封裝的 CRC-64 值，用於校正完整性。應當由工具自動計算。	1506052139770049xxxx
X-Fc-Log-Type	string	否	請求返回日誌。 Tail：返回當前請求產生的最後 4 KB 日誌。 None：預設值，不返回請求日誌。	Tail
X-Fc-Invocation-Type	string	否	調用方式。 Sync：同步調用。 Async：非同步呼叫。	Async
X-Fc-Date	string	否	函數的調用開始日期，格式為EEE,d MMM yyyy HH:mm:ss GMT。	Sat, 14 Jul 2017 07:02:38 GMT
X-Fc-Trace-Id	string	否	Function Compute調用請求的調用鏈 ID。	asdf****

返回參數

名稱	類型	描述	樣本值
	StatefulAsyncInvocation	非同步任務調用資料。該參數下的 returnPayload 欄位當前處於內測階段，如您需要使用，請聯絡我們為您開通。	[{"functionName": "demo-function","serviceName": "demo-service","qualifier": "LATEST","invocationId": "id","status": "Succeeded","startedTime": 1640966400000,"endTime": 1640966500000,"destinationStatus": "Succeeded","invocationErrorMessage": "","invocationPayload": "","requestId": "id","alreadyRetriedTimes": 0}]

樣本

正常返回樣本

JSON格式

{
  "functionName": "functionName",
  "serviceName": "serviceName",
  "qualifier": "LATEST",
  "invocationId": "demo-id",
  "status": "Running",
  "startedTime": 1633449590000,
  "endTime": 1633449599000,
  "destinationStatus": "Succeeded",
  "invocationErrorMessage": "UnhandledInvocationError",
  "invocationPayload": "{\"key1\":\"value1\",\"key2\":\"value2\"}",
  "alreadyRetriedTimes": 3,
  "requestId": "ABA740D4-********-882707EADC37",
  "instanceId": "D4-*******9FD1-882707E",
  "events": [
    {
      "eventId": 1,
      "status": "Enqueued",
      "timestamp": 1647420449721,
      "eventDetail": "{\"Error\":\"UnhandledInvocationError\"}"
    }
  ],
  "durationMs": 100,
  "returnPayload": "my-result"
}

錯誤碼

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

變更歷史

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