GetStatefulAsyncInvocation による非同期タスクレコードの取得 - FC

操作説明

StatefulAsyncInvocation は非同期タスクを表します。非同期タスク（StatefulAsyncInvocation）を使用すると、非同期呼び出しの状態を管理できます。この非同期タスク機能は、タスク指向のシナリオに特に適しています。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

fc:GetStatefulAsyncInvocation

get

*All Resource

*

なし

リクエスト構文

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 は英字またはアンダースコア（_）で始まり、英字、数字（0–9）、アンダースコア（_）、ハイフン（-）を含むことができます。最大長は 128 文字です。非同期呼び出しの ID を指定しない場合、Function Compute が自動的に ID を生成します。	e026ae92-61e5-472f-b32d-1c9e3c4e****

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
qualifier	string	任意	非同期タスクが属するサービスのバージョンまたはエイリアスです。	LATEST
X-Fc-Account-Id	string	任意	ご利用の Alibaba Cloud アカウントの ID です。	188077086902****
X-Fc-Code-Checksum	string	任意	関数コードパッケージの CRC-64 値です。データ整合性の検証に使用されます。この値はツールによって自動的に計算されます。	1506052139770049xxxx
X-Fc-Log-Type	string	任意	ログを返す方法です。デフォルト値：None。有効な値は以下のとおりです。 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 API のリクエストに対するトレース ID です。	asdf****

レスポンスフィールド

フィールド	型	説明	例
	StatefulAsyncInvocation	非同期タスクに関する情報です。returnPayload パラメーターはベータ版です。このパラメーターをご利用になりたい場合は、お問い合わせください。	Alibaba Cloud CLI

例

成功レスポンス

JSONJSON

{
  "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"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。