--- title: "Put Action" slug: "compute-cloudfunctions-v2-putaction" updated: 2026-09-17T09:57:45Z published: 2026-09-17T09:57:45Z canonical: "api.ncloud-docs.com/compute-cloudfunctions-v2-putaction" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Put Action Classic/VPC環境で利用できます。 Cloud Functionsアクションを作成したり、変更したりします。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | PUT | /ncf/api/v2/packages/{packageName}/actions/{actionName} | 参考 シンガポールリージョンと日本リージョンは、VPC環境でのみ利用できます。 ### リクエストヘッダ Cloud Funtions APIで共通して使用されるヘッダの詳細は、[Cloud Functionsのリクエストヘッダ](/docs/ja/compute-cloudfunctions#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `packageName` | String | Required | パッケージ名 - 英数字、記号の「-」、「_」を組み合わせて1~50文字以内で入力 - 先頭文字に「-」は使用不可 - 他のリソース(パッケージ、アクション、トリガー)名と重複不可 - パッケージに属しないアクションの場合、記号の「-」を入力 | | `actionName` | String | Required | アクション名 - 英数字、記号の「-」、「_」を組み合わせて1~50文字以内で入力 - 先頭文字に「-」は使用不可 - 他のリソース(パッケージ、アクション、トリガー)名と重複不可 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `platform` | String | Optional | プラットフォーム区分 - `vpc`(デフォルト) \| `classic` | | `type` | String | Optional | アクションタイプ - `basic`(デフォルト) \| `web` \| `sequence` \| `sequence-web` - 他のタイプに変更不可 | ### リクエストボディ リクエストボディの説明は次の通りです。 #### Basic/Webアクション Basic/Webアクションの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `description` | String | Optional | アクションの説明(Byte) - 0~3,000 | | `parameters` | Object | Optional | アクションのデフォルトパラメータ - `{"key" : "value"}`形式の JSON - アクション実行時、パラメータ適用の優先順位 - 1番目: 実行時に渡されるランタイムパラメータ - 2番目: 関連付けられているトリガーのデフォルトパラメータ - 3番目: アクションのデフォルトパラメータ - 4番目: 含まれているパッケージのデフォルトパラメータ | | `limits.timeout` | Integer | Required | アクションの最大実行時間(ミリ秒) - 500~300,000 - タイムアウト超過時はアクションを強制終了 | | `limits.memory` | Integer | Required | アクションの最大メモリ容量(MB) - `128` \| `256` \| `512` \| `1024` | | `exec.kind` | String | Required | アクションランタイム - オプションは[Cloud Functionsランタイム情報](https://guide.ncloud-docs.com/docs/ja/cloudfunctions-spec-runtime) | | `exec.imageUri` | String | Conditional | ユーザー画像のパス - Custom Imageランタイムのみ対象 - `{registryName}/{imageName}:{tag}`形式 - `tag`が入力されなかった場合、デフォルトは`latest` | | `exec.binary` | Boolean | Required | アクションコードファイルはバイナリかどうか - `true` \| `false` - `true`: `exec.code`にアクションコードファイルの Base64エンコードされた値を入力 - `false`: `exec.code`にアクションコードを入力 | | `exec.code` | String | Required | アクションのソースコード - ソースコード: コード内容をそのまま入力 - ファイル添付: アクションコードファイルのバイナリデータを Base64エンコードして入力 - コードを直接入力する場合、エスケープ(escape)処理が必要 - Javaまたは.netランタイムはファイルバイナリのみ許可 - Javaは圧縮された*.jarファイル形式のみ登録可能 - .net(dotnet)の場合、*.zipファイル(圧縮ファイル)形式のみアップロード可能 | | `exec.main` | String | Required | 実行関数 | | `vpc` | Array | Required | 接続する VPC情報: [vpc](/docs/ja/compute-cloudfunctions-v2-putaction#vpc) - VPCプラットフォームのみ対象 | | `raw-http` | Boolean | Optional | 未加工 HTTPの使用有無 - ウェブアクションタイプのみサポート | | `custom-options` | Boolean | Optional | HTTPヘッダオプションの設定 - ウェブアクションタイプのみサポート | #### `vpc` `vpc`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `vpcNo` | Integer | Required | 接続する VPC ID | | `subnetNo` | Integer | Required | 接続する Subnet ID | #### Sequence/Sequence-webアクション Sequence/Sequence-webアクションの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `description` | String | Optional | アクションの説明(Byte) - 0~3,000 | | `exec.kind` | String | Required | アクションの種類 - `sequence`(固定値) | | `exec.components` | String[] | Required | シーケンスアクションに関連付けるアクションリスト - `{packageName}/{actionName}`形式 - リスト順に実行 - パッケージに属しないアクションを関連付ける場合、`packageName`に記号の「-」を入力 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl -X PUT 'https://cloudfunctions.apigw.ntruss.com/ncf/api/v2/packages/{packageName}/actions/{actionName}' \ --header 'Content-Type: application/json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Sub Account Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' --data '{ "description" : "My action", "parameters": { "name": "Cloud Functions", "place": "NCloud" }, "limits": { "timeout": 60000, "memory": 128 }, "exec": { "kind": "nodejs:16", "code": "function main(params) { \nlet name = params.name || \"World\";\nlet place = params.place || \"Naver\"; \n return {payload: \"abc\"};\n}", "binary": false, "main": "main" }, "vpc": [ { "vpcNo" : ******, "subnetNo" : ***** } ] }' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 #### 共通フィールド 共通フィールドの詳細は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `content` | Object | - | アクションの作成、変更情報 | | `content.name` | String | - | アクションの名前 | | `content.resourceId` | String | - | アクションのリソース ID | | `content.path` | String | - | アクションのパス | | `content.description` | String | - | アクションの説明 | | `content.type` | String | - | アクションタイプ | #### Basic/Webアクション Basic/Webアクションの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `content.parameters` | Object | - | アクションの基本パラメータ | | `content.raw-http` | Boolean | - | 未加工 HTTPの使用有無 - ウェブアクションタイプのみサポート | | `content.custom-options` | Boolean | - | ヘッダオプションの設定 - ウェブアクションタイプのみサポート | | `content.exec.binary` | Boolean | - | アクションコードのファイルはバイナリかどうか | | `content.exec.code` | String | - | アクションのソースコードまたは Base64-encodedコードファイルのバイナリ | | `content.exec.imageUri` | String | - | ユーザー画像パス - ランタイムが Custom Imageの場合にのみ表示される | | `content.exec.kind` | String | - | アクションのランタイム | | `content.exec.main` | String | - | 実行関数 | | `content.limits.memory` | Integer | - | アクションコンテナに割り当てられるメモリの容量 | | `content.limits.timeout` | Integer | - | アクションが実行される最大時間 | | `content.vpc` | Array | - | 接続された VPC情報: [vpc](/docs/ja/compute-cloudfunctions-v2-putaction#vpc) - プラットフォームが VPCの場合にのみ表示 | #### `vpc` `vpc`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `vpcNo` | Integer | - | 接続された VPC ID | | `subnetNo` | Integer | - | 接続された Subnet ID | #### Sequence/Web-sequenceアクション Sequence/Sequence-webアクションの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `content.exec.kind` | String | - | アクションの種類 - `sequence`(固定値) | | `content.exec.components` | String[] | - | 関連付けられたアクションリスト | ### レスポンスステータスコード Cloud Functions APIで共通して使用されるレスポンスステータスコードの詳細は、[Cloud Functionsのレスポンスステータスコード](/docs/ja/compute-cloudfunctions#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "content": { "description": "My action", "exec": { "binary": false, "code": "function main(params) { \nlet name = params.name || \"World\";\nlet place = params.place || \"Naver\"; \n return {payload: \"abc\"};\n}", "kind": "nodejs:16", "main": "main" }, "limits": { "memory": 128, "timeout": 60000 }, "name": "myaction", "parameters": { "name": "Cloud Functions", "place": "NCloud" }, "path": "***QK06kFG8C/mypackage", "resourceId": "*****", "type": "basic", "vpc": [ { "subnetNo": ******, "vpcNo": ***** } ] } } ```