すべてのプロダクト
Search

このプロダクト

    Function Compute:InvokeFunction

    ドキュメントセンター

    Function Compute:InvokeFunction

    最終更新日:Sep 11, 2024

    関数を呼び出します。Invokes a function.

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。 利便性を考慮して、この操作は OpenAPI Explorer で呼び出すことが推奨されます。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

    リクエストヘッダー

    この操作では、共通のリクエストヘッダーのみが使用されます。 詳細は、共通パラメータを参照してください。

    パラメーター

    データ型

    必須

    例

    説明

    X-Fc-呼び出しタイプ

    String

    なし

    同期

    呼び出しメソッド。 有効な値：

    • 同期: 同期呼び出し

    • Async: 非同期呼び出し

    X-Fc-ログタイプ

    String

    ✕

    なし

    ログを返すために使用されるメソッド。 有効な値：

    • Tail: 現在のリクエストに対して生成された最後の4 KBのログを返します。

    • なし: 現在のリクエストに対してログが返されません。 デフォルト値 : なし。

    X-Fc-Stateful-Async-Invocation-Id

    String

    なし

    g6u ***** iyvhd3jk8s6bhj0hh

    非同期タスクのID。 事前に非同期タスク機能を有効にする必要があります。

    説明

    SDKを使用して関数を呼び出す場合、その後の操作を容易にするためにビジネス関連のIDを指定することを推奨します。 たとえば、ビデオ処理関数の呼び出しIDとしてビデオ名を使用できます。 その後、IDを使用して、ビデオが処理されているかどうかを確認したり、ビデオの処理を終了したりできます。 IDは英字またはアンダースコア (_) で始まる必要があり、英字、数字、アンダースコア (_) 、およびハイフン (-) を使用できます。 IDの長さは最大128文字です。 非同期呼び出しのIDを指定しない場合、Function Computeは自動的にIDを生成します。

    リクエスト構文

    POST /services/{serviceName.qualifier}/functions/{functionName} HTTP/1.1

    リクエストパラメーター

    パラメーター

    データ型

    場所

    必須

    例

    説明

    serviceName

    String

    パス

    あり

    service_name

    サービスの名前です。

    修飾子

    String

    パス

    なし

    LATEST

    サービスのバージョンまたはエイリアス。

    functionName

    String

    パス

    あり

    function_name

    関数の名前。

    String

    本文

    あり

    {"key1": "value1"}

    関数のイベント。 このパラメーターの値はバイナリ配列です。 Function Computeは、処理のためにイベントを関数に渡します。

    レスポンスパラメーター

    パラメーター

    データ型

    例

    説明

    X-Fc-エラータイプ

    String

    UnhandledInvocationError

    関数が呼び出された後に返されるエラーのタイプ。 有効な値：

    • HandledInvocationError: Node.jsでコールバック関数が実行されたときに返されるエラー。 詳細については、「エラー処理」をご参照ください。

    • UnhandledInvocationError: HandledInvocationErrorタイプのものを除くすべてのエラー。 詳細については、「エラー処理」をご参照ください。

    X-Fc-ログ-結果

    String

    デモログ結果

    返されたログ結果。

    X-Fc-コード-チェックサム

    String

    5697641582914695457

    関数コードパッケージのCRC-64値。

    X-Fc-Stateful-Async-Invocation-Id

    String

    g6u ***** iyvhd3jk8s6bhj0hh

    非同期タスクのID。 事前に非同期タスク機能を有効にする必要があります。

    説明

    SDKを使用して関数を呼び出す場合、その後の操作を容易にするためにビジネス関連のIDを指定することを推奨します。 たとえば、ビデオ処理関数の呼び出しIDとしてビデオ名を使用できます。 その後、IDを使用して、ビデオが処理されているかどうかを確認したり、ビデオの処理を終了したりできます。 IDは英字またはアンダースコア (_) で始まる必要があり、英字、数字、アンダースコア (_) 、およびハイフン (-) を使用できます。 IDの長さは最大128文字です。 Function Computeは、指定されていない場合、非同期タスクのIDを生成します。

    X-Fc-インスタンスId

    String

    7c43576b-48b1-4c3a-86e5-dcb01872 ****

    関数インスタンスのID。

    X-Fc-リクエストId

    String

    dab25e58-9356-4e3f-97d6-f044c4 ****

    関数呼び出しのリクエストID。

    X-Fc-Max-メモリ-使用法

    String

    9.2

    関数の実行によって消費されるメモリ。 単位：MB。

    X-Fc-呼び出し-期間

    String

    10

    関数の実行によって消費された時間 (ミリ秒単位) 。

    X-Fc-呼び出し-サービスバージョン

    String

    LATEST

    呼び出された関数のバージョンまたはエイリアス。

    String

    Hello World

    関数が呼び出された後に返される結果。 返される結果を指定できます。

    例

    リクエストの例

    POST /services/{serviceName.qualifier}/functions/function_name HTTP/1.1
Host:fc-ram.aliyuncs.com
X-Fc-Invocation-Type:Sync
X-Fc-Log-Type:None
X-Fc-Stateful-Async-Invocation-Id:g6u*****iyvhd3jk8s6bhj0hh
Content-Type:application/json

{"key1": "value1"}

    正常に処理された場合のレスポンス例

    JSON 形式

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

{
  "result" : "hello world"
}

    エラーコード

    エラーコードの一覧については、「サービスエラーコード」をご参照ください。