ファンクションの呼出し

OCIファンクションにデプロイされたファンクションを呼び出す様々な方法を確認します。

OCIファンクションにデプロイしたファンクションは、様々な方法で呼び出できます:

Fn ProjectのCLIを使用する。
Oracle Cloud InfrastructureのCLIを使用する。
Oracle Cloud Infrastructure SDKを使用する。
ファンクションの呼出しエンドポイントに対して署名付きHTTPリクエストを発行する。すべてのファンクションに呼出しエンドポイントがあります。

前述の各ファンクションは、APIへのリクエストを介してファンクションを呼び出します。APIへのリクエストは、ファンクションが属しているコンパートメントの署名およびOCIDをリクエスト・ヘッダーに含めることによって認証される必要があります。このようなリクエストは、「署名済」リクエストと呼ばれます。署名には、暗号化された形式のOracle Cloud Infrastructure資格証明が含まれます。

Fn ProjectのCLIまたはOracle Cloud InfrastructureのCLIを使用してファンクションを呼び出す場合は、認証が自動的に処理されます。Fn ProjectのCLIを使用したファンクションの呼出しおよびOracle Cloud InfrastructureのCLIを使用したファンクションの呼出しを参照してください。

Oracle Cloud Infrastructure SDKを使用してファンクションを呼び出す場合、SDKを使用して認証を処理できます。SDKを使用したファンクションの呼び出しを参照してください。

ファンクションの呼出しエンドポイントに対して署名付きHTTPリクエストを行う場合は、ファンクションが属するコンパートメントの署名およびOCIDをリクエスト・ヘッダーに含めて、自分で認証を処理する必要があります。これは、様々な方法で実行できます:

Oracle Cloud Infrastructure CLIのraw-requestコマンドを使用します。ファンクションの呼出しエンドポイントへの署名付きリクエストの送信(Oracle Cloud Infrastructure CLIのraw-requestコマンドを使用)を参照してください。
リクエストにプログラムで署名するコードを記述します。必要な資格証明とリクエストの署名方法の詳細は、リクエストの署名を参照してください。

ヒント

このトピックのいずれかのステップを正常に完了できない場合は、一般的な問題の解決策を確認してください(OCIファンクションのトラブルシューティングを参照)。

Fn ProjectのCLIを使用したファンクションの呼出し

Fn ProjectのCLIを使用してOCIファンクションにデプロイされているファンクションを呼び出すには:

ファンクション開発者として開発環境にログインします。
ターミナル・ウィンドウで入力します:
```
fn invoke <app-name> <function-name>
```
ここでは:
- <app-name>は、呼び出すファンクションを含むアプリケーションの名前です
- <function-name>は呼び出す必要があるファンクションの名前です
例:
```
fn invoke helloworld-app helloworld-func
```
出力:
```
Hello World !
```
ヒント

引数と値をファンクションに渡す場合は、fn invokeコマンドにecho -n '<argument>=<value>'|を接頭辞として付加します

ファンクションで引数と値がJSONと予想される場合は、有効なJSON形式を使用します。例:
```
echo -n '{"name":"John"}' | fn invoke helloworld-app helloworld-func
```
出力:
```
Hello John !
```

Oracle Cloud InfrastructureのCLIを使用したファンクションの呼出し

Oracle Cloud Infrastructure CLIをインストールした場合、これを使用してファンクションを呼び出すAPIリクエストを送信できます。特に、Oracle Cloud InfrastructureのCLIを使用するとOracle Cloud Infrastructure認証が容易になります。Oracle Cloud Infrastructure CLIの使用方法の詳細は、コマンドライン・インタフェース(CLI)を参照してください。

これらの手順では、次のことを前提にしています:

Oracle Cloud Infrastructure CLIをすでにインストールおよび構成している
開発環境用に構成されたファンクション開発者としてファンクションを呼び出す場合

Oracle Cloud Infrastructure CLIを使用してファンクションを呼び出すには:

ファンクション開発者として開発環境にログインします。
ターミナル・ウィンドウで入力します:
```
oci fn function invoke --function-id <function-ocid> --file "<output-filepath>" --body "<request-parameters>"
```
ここでは:
- <function-ocid>は、呼び出すファンクションのOCIDです。ファンクションのOCIDを確認するには、fn inspectコマンドを使用してファンクションのidプロパティの値を確認します(ファンクションのリストを参照)。
- <output-filepath>は、レスポンスを書き込むファイルのパスと名前です。レスポンスをstdoutに書き込むには、--file "-"を指定します
- <request-parameters>は、オプションでファンクションに渡す引数と値を指定します。ファンクションで引数と値がJSONと予想される場合は、有効なJSON形式を使用します。たとえば、--body '{"name":"John"}'です。渡すリクエスト・パラメータがない場合でも、リクエストに--body ""を含める必要があります。
例:
- ```
oci fn function invoke --function-id ocid1.fnfunc.oc1.phx.aaaa____uxoa --file "-" --body ""
```
  出力:
```
Hello World !
```
- ```
oci fn function invoke --function-id ocid1.fnfunc.oc1.phx.aaaa____uxoa --file "-" --body '{"name":"John"}'
```
  出力:
```
Hello John !
```

ファンクションを呼び出すためのSDKの使用

Oracle Cloud Infrastructure SDKが存在する言語でファンクションを呼び出すプログラムを作成する場合は、そのSDKを使用してファンクションを呼び出すAPIリクエストを送信することをお薦めします。特に、SDKを使用するとOracle Cloud Infrastructure認証が容易になります。

SDKを使用してファンクションを呼び出す場合、Oracle Cloud Infrastructure CLIのraw-requestコマンドの使用時に指定する起動エンドポイント全体を指定しないことに注意してください(ファンクションの呼出しエンドポイントの取得を参照)。かわりに、関数の起動エンドポイントの最初の部分のみを指定します。たとえば、SDKを使用する場合は、関数の起動エンドポイントをhttps://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.com/20181201/functions/ocid1.fnfunc.oc1.phx.aaaa____uxoa/actions/invokeとして指定しないでください。かわりに、関数の呼出しエンドポイントをhttps://fht7ns4mn2q.us-phoenix-1.functions.oci.oraclecloud.comとして指定します。

APIの使用およびリクエストの署名の詳細は、REST APIのドキュメントおよびセキュリティ資格証明を参照してください。SDKの詳細は、SDKおよびCLIを参照してください。

InvokeFunction API操作を使用してファンクションを呼び出します。