すべてのプロダクト
Search

このプロダクト

    :ListStatefulAsyncInvocations

    ドキュメントセンター

    :ListStatefulAsyncInvocations

    最終更新日:Feb 26, 2026

    指定された条件を満たす非同期タスク内のすべての非同期呼び出しを照会します。

    操作説明

    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:ListStatefulAsyncInvocations

    get

    *All Resource

    *

    		 なし なし

    リクエスト構文

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

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    serviceName

    string

    必須

    非同期タスクが属するサービスの名前です。

    demo-service
    functionName

    string

    必須

    非同期タスクが属する関数の名前です。

    demo-function

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    qualifier

    string

    任意

    非同期タスクが属するサービスのバージョンまたはエイリアスです。

    LATEST
    status

    string

    任意

    非同期タスクの状態です。

    • Enqueued：非同期タスクがキューに登録され、実行待ちの状態です。

    • Succeeded：呼び出しが正常に完了しました。

    • Failed：呼び出しが失敗しました。

    • Running：呼び出しが実行中です。

    • Stopped：呼び出しが終了しました。

    • Stopping：呼び出しが終了処理中です。

    • Invalid：特定の理由により無効と判定され、実行されなかった呼び出しです（例：関数が削除済み）。

    • Expired：非同期呼び出しに対してメッセージの最大有効期間が設定されています。この最大有効期間が経過したため、呼び出しは破棄され、実行されませんでした。

    • Retrying：実行エラーにより、非同期タスクが再試行中です。

    Running
    nextToken

    string

    任意

    追加の結果を取得するために必要なトークンです。初回呼び出しではこのパラメーターを指定する必要はありません。直前の呼び出しで NextToken の値が返された場合、さらに結果が存在します。

    caeba0****be03f84eb48b699f0a4883
    limit

    integer

    任意

    返される非同期タスクの最大数です。デフォルト値は 20 です。有効範囲：[1, 100]。

    20
    startedTimeBegin

    integer

    任意

    非同期タスクの開始時刻です。

    1640966400000
    startedTimeEnd

    integer

    任意

    非同期タスクの終了時刻です。

    1640966400000
    sortOrderByTime

    string

    任意

    返される非同期タスクを並べ替える方法です。

    • asc：昇順

    • desc：降順

    desc
    invocationIdPrefix

    string

    任意

    非同期タスクの名前のプレフィックスです。このパラメーターを使用して、返される非同期タスクの名前を制限します。たとえば、invocationIdPrefix パラメーターを job に設定した場合、返される呼び出しの名前は必ず job で始まる必要があります。

    abcxxx
    includePayload

    boolean

    任意

    • 応答に invocationPayload パラメーターを含めるかどうかを指定します。true：応答に invocationPayload パラメーターを含めます。

    • false：応答に invocationPayload パラメーターを含めません。

    説明

    invocationPayload パラメーターは、非同期タスクの入力パラメーターを示します。

    true
    X-Fc-Account-Id

    string

    任意

    ご利用の Alibaba Cloud アカウントの 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 API のリクエストに対するトレース ID です。

    abcxxx

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    返されるデータ構造です。

    nextToken

    string

    追加の結果を取得するために使用するトークンです。このパラメーターが空の場合、すべての結果が返されます。

    8bj81uI8n****
    invocations

    array

    非同期タスクのリストです。

    StatefulAsyncInvocation

    非同期タスクに関する情報です。

    [{"functionName": "demo-function","serviceName": "demo-service","qualifier": "LATEST","invocationId": "id","status": "Succeeded","startedTime": 1640966400000,"endTime": 1640966500000,"destinationStatus": "Succeeded","invocationErrorMessage": "","invocationPayload": "","requestId": "id","alreadyRetriedTimes": 0,}]

    例

    成功レスポンス

    JSONJSON

    {
  "nextToken": "8bj81uI8n****",
  "invocations": [
    {
      "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"
    }
  ]
}

    エラーコード

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

    変更履歴

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