ファンクションに渡すカスタム構成パラメータの指定
OCI Functionsで実行中のファンクションに渡すカスタム構成パラメータを指定する方法をご紹介します。
前提条件および詳細は、ファンクションへのカスタム構成パラメータの渡しを参照してください。
- 「アプリケーション」リスト・ページで、カスタム構成パラメータを渡すファンクションを含むアプリケーションを選択します。リストページまたはアプリケーションの検索に関するヘルプが必要な場合は、Listing Applicationsを参照してください。
- 次のいずれかを行います。
-
1つ以上のカスタム構成パラメータをアプリケーション内のすべてのファンクションに渡すには、「構成」を選択して、アプリケーションの「構成」ページを表示します。
-
1つ以上のカスタム構成パラメータを特定のファンクションに渡すには、ファンクションの名前を選択し、「構成」を選択して、ファンクションの「構成」ページを表示します。
-
-
「構成」ページで、最初のカスタム構成パラメータについて次の詳細を指定します。
- キー:カスタム構成パラメータの名前。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。たとえば、
username
です - 値: カスタム構成パラメータの値。値には印刷可能なUnicode文字のみを使用する必要があります。たとえば、
jdoe
です
- キー:カスタム構成パラメータの名前。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。たとえば、
-
プラスのボタンを選択して、新しいカスタム構成パラメータを保存します。
OCI関数は、アプリケーション内のすべてのカスタム構成パラメータ(アプリケーション全体およびファンクション固有の両方)のキーと値のペアを、シリアルにエンコードされた単一の構成オブジェクトに結合し、最大許容サイズは4 Kbです。シリアルにエンコードされた構成オブジェクトのサイズが4 Kbを超える場合は、新しいカスタム構成パラメータを保存できません。
- (オプション)必要に応じて他のカスタム構成パラメータを入力します。
- ヒント
時々、Fn ProjectCLIの新しいバージョンがリリースされます。最新バージョンがインストールされていることを定期的に確認することをお勧めします。詳細は、Fn ProjectのCLIをアップグレードするステップを参照してください。Fn ProjectのCLIを使用してファンクションに渡すカスタム構成パラメータを指定するには:
-
開発環境にファンクション開発者としてログインし、ターミナル・ウィンドウを開きます。
-
既存のアプリケーション内のすべてのファンクションに渡す1つ以上のカスタム構成パラメータを指定するには、次のように入力します:
fn config app <app-name> <key> <value>
ここでは:
<app-name>
は、カスタム構成パラメータを渡すファンクションが含まれているアプリケーションの名前です。<key>
は、カスタム構成パラメータの名前です。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。<value>
は、カスタム構成パラメータに指定する値です。値には印刷可能なUnicode文字のみを使用する必要があります。
例:
fn config app acmeapp username jdoe
次に注意してください:
fn create app
コマンドを使用して新しいアプリケーションを作成する際、アプリケーション全体のカスタム構成パラメータを定義することもできます。- OCI関数は、アプリケーション内のすべてのカスタム構成パラメータ(アプリケーション全体およびファンクション固有の両方)のキーと値のペアを、シリアルにエンコードされた単一の構成オブジェクトに結合し、最大許容サイズは4Kbです。
-
特定のファンクションに渡す1つ以上のカスタム構成パラメータを指定するには、次のように入力します:
fn config function <app-name> <function-name> <key> <value>
ここでは:
<app-name>
は、カスタム構成パラメータを渡すファンクションが含まれるアプリケーションの名前です。<function-name>
は、カスタム構成パラメータを渡すファンクションの名前です。<key>
は、カスタム構成パラメータの名前です。名前に使用できるのは、英数字とアンダースコアのみで、先頭を数字にすることはできません。<value>
は、カスタム構成パラメータに指定する値です。値には印刷可能なUnicode文字のみを使用する必要があります。
例:
fn config function acmeapp acme-func username jdoe
次に注意してください:
fn create function
コマンドを使用して新しいファンクションを作成する際に、ファンクション固有のカスタム構成パラメータを定義することもできます。- OCI関数は、アプリケーション内のすべてのカスタム構成パラメータ(アプリケーション全体およびファンクション固有の両方)のキーと値のペアを、シリアルにエンコードされた単一の構成オブジェクトに結合し、最大許容サイズは4Kbです。
-
次のAPI操作を実行して、カスタム構成パラメータを定義します: