基本アクション

Classic環境で利用できます。

NAVERクラウドプラットフォームコンソールの Cloud Functions > Action でデフォルトタイプのアクションを作成して修正・削除できます。作成したアクションを実行してモニタリングする方法は、Action/Triggerの実行と Actionをご参照ください。

アクション作成

アクションを作成します。アクションの作成時にトリガーを関連付けるか、トリガーがない場合はトリガーを追加して関連付けることができます。トリガーを関連付けなくても動作可能なアクションを作成することもできます。アクションを作成する方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールの Region メニューで、利用中のリージョンをクリックして選択します。
2. Platform メニューで Classic をクリックして選択します。
3. Services > Compute > Cloud Functions メニューを順にクリックします。
4. Action メニューをクリックします。
5. [Action作成] ボタンをクリックします。
6. トリガー選択 のトリガー種類 で、アクションに関連付けるトリガーをクリックして選択します。

• トリガーを設定せずにアクションを作成する: トリガーを関連付けずに作成したい場合

7. 名前 で関連付けるトリガーをクリックして選択し、[追加] ボタンをクリックします。

• 新しいトリガーを作成する: 関連付けるトリガーがないか、新しいトリガーを作成して関連付ける場合。詳しい使用方法は、Triggerを参照

8. 関連付けのトリガーリストが表示されたら、情報を確認して [次へ] ボタンをクリックします。
9. 作成するアクションの内容を設定します。
   • 基本情報: アクションのタイプ、名前、説明、所属パッケージを設定
   • ソースコード: コンソールでコードを選択した言語で直接作成するか、コードファイルをアップロード
   • デフォルトパラメータ: アクションに使用するデフォルトパラメータコードを作成
   • オプション設定: アクションのメイン関数名、メモリ、タイムアウト、ウェブアクションを設定
10. [作成] ボタンをクリックします。

基本情報

アクションを作成するために基本的に必要な情報を設定します。 基本情報 の各項目に関する説明は次の通りです。

• パッケージ: アクションが属するパッケージをクリックして選択。新しいパッケージを作成して含めるには、 [作成] ボタンをクリック
• タイプ: アクションの種類の中から デフォルト をクリックして選択
  • デフォルト: 1つのアクションを実行
  • シーケンス: 複数のアクションを関連付けて順次実行
• 名前: アクション名を英字の大小文字、数字、記号「-」「_」を組み合わせて入力。ただし、先頭の文字に記号「-」は使用できず、他のリソース(パッケージ、アクション、トリガー)名と重複不可
  • パッケージ名が package nameで、アクション名が action nameの場合、パッケージに属するアクション名の形式: {package name}/{action name}
• 説明: 作成するアクションについての説明を入力

ソースコード

アクションコードは、希望する言語でコンソールで直接作成するか、コードファイルをアップロードします。コードの作成時に実行時点のランタイムパラメータを設定しないと、パッケージや関連付けられたトリガー、アクションのデフォルトパラメータが使用されます。ランタイムパラメータの他にも、追加設定に対するコードを別途作成しない場合は、関連設定はデフォルト値が適用されます。作成後に変更できない値もあることに注意して作成してください。 ソースコード の各項目に関する説明は次の通りです。

• 言語: ソースコードの作成言語をクリックして選択
• タイプ: ソースコードを作成する方法をクリックして選択
  • コード: コンソールで直接作成
  • ファイル: 作成したソースコードファイルを Drop files here or click to upload. をクリックしてアップロード

作成のユースケース

パラメータの Paramsを取得して Paramsに Nameと Placeが存在する場合はその文字列を返し、存在しない場合は Worldと Ncloudを返すアクションのソースコードの言語別作成のユースケースです。ソースコードの作成時にご参照ください。

• Node.js

  function main(params) {
      var name = params.name || 'World';
      var place = params.place || 'Ncloud';
      return {payload:  'Hello, ' + name + ' in ' + place + '!'};
  }
  

• Python 3

  def main(args):
      name = args.get("name", "World")
      place  = args.get("place", "Ncloud")
      return {"payload": "Hello, " + name + " in " + place + "!"}
  

• Swift 3.1.1

  func main(args: [String:Any]) -> [String:Any] {
      let name = args["name"] ?? "World"
      let place = args["place"] ?? "Ncloud"
      return  [ "payload" : "Hello, \(name) in \(place)"]
  }
  

• PHP 7

  <?php
  function main(array $args) : array
  {
      $name = $args["name"] ?? "World";
      $place = $args["place"] ?? "Ncloud";
      return ["greeting" => "Hello, $name in $place!"];
  }
  ?>
  

• Java 8

  import com.google.gson.JsonObject;
  
  public class Hello {
      public static JsonObject main(JsonObject args) {
          String name = "World";
          String place = "Ncloud";
          if (args.has("name"))
              name = args.getAsJsonPrimitive("name").getAsString();
          if (args.has("place"))
              place = args.getAsJsonPrimitive("place").getAsString();
  
          JsonObject response = new JsonObject();
          response.addProperty("payload", "Hello, " + name + " in " + place + "!");
          return response;
      }
  }
  

デフォルトパラメータ

アクションを実行するたびにパラメータを転送する代わりに、アクションにデフォルトで適用可能なデフォルトパラメータを入力できます。アクションのデフォルトパラメータは、パッケージパラメータより適用の優先順位が高く、トリガーパラメータとアクションの実行時点に転送されるランタイムパラメータよりは優先順位が低いです。 デフォルトパラメータ の各項目に関する説明は、次の通りです。

• 入力ボックス: json形式で入力

以下は json形式のデフォルトパラメータのサンプルコードです。

{
  "name": "Ncloud",
  "place": "Cloud Functions"
}

オプション設定

アクションのメイン関数名、メモリ、タイムアウトを設定したり、別途のユーザー認証なしで呼び出し可能な URLを提供するウェブアクションを設定できます。ウェブアクションの場合は、様々な REST APIタイプのすべてのリクエスト(GET、POST、PUT、DELETEなど)をサポートします。
オプション設定 の各項目に関する説明は次の通りです。

• Main関数: アクションのメイン関数やクラス名として使用する文字列を入力
• アクションメモリ: 希望するメモリ容量をクリックして選択
• アクション Timeout: アクションの実行可能な最大時間を ms単位で入力。入力した時間の超過時は、実行結果失敗で終了
• ウェブアクションの設定: ウェブプロパティのアクションの作成有無をクリックして選択(True: 作成、False: 作成しない)
  • HTTPソース使用: HTTPソースをそのままウェブアクションに渡し、ウェブアクションでの解釈・処理有無をクリックして選択(True: HTTPソース使用、False: JSONオブジェクト使用)
  • ヘッダオプション設定: コード内でヘッダの修正可否をクリックして選択(True: 修正可能、False: CORSヘッダをレスポンスヘッダに自動追加)

アクション修正

アクションの名前と種類を除く残りの内容は修正できます。修正する方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールの Region メニューで、利用中のリージョンをクリックして選択します。
2. Platform メニューで Classic をクリックして選択します。
3. Services > Compute > Cloud Functions メニューを順にクリックします。
4. Action メニューをクリックします。
5. Packages/Actions で修正するアクションをクリックします。
6. 基本情報 タブメニューをクリックし、[修正] ボタンをクリックします。
7. 必要な情報を修正します。
8. [保存] ボタンをクリックします。

アクション削除

アクションを削除できます。アクションを削除すると、アクションに関連付けられた外部接続アドレスのリソースとステージ情報が一緒に削除され、そのアクションが含まれたシーケンスアクションが修正または削除されることがあります。また、削除したアクションは復旧できないことにご注意ください。アクションを削除する方法は次の通りです。

1. NAVERクラウドプラットフォームコンソールの Region メニューで、利用中のリージョンをクリックして選択します。
2. Platform メニューで Classic をクリックして選択します。
3. Services > Compute > Cloud Functions メニューを順にクリックします。
4. Action メニューをクリックします。
5. Packages/Actions で削除するアクションをクリックします。
6. 基本情報 タブメニューをクリックし、[削除] ボタンをクリックします。
7. [削除] ボタンをクリックします。