---
title: "Put Action"
slug: "compute-cloudfunctions-putaction"
tags: ["Cloud Functions"]
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
canonical: "api.ncloud-docs.com/compute-cloudfunctions-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 | /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文字以内で入力 - 先頭文字に「-」は使用不可 - 他のリソース(パッケージ、アクション、トリガー)名と重複不可 - パッケージに属しないアクションを作成するには、記号の「-」を入力 - <例> `/packages/-/actions/myaction` |
| `actionName` | String | Required | アクション名 - 英数字、記号の「-」、「_」を組み合わせて1~50文字以内で入力 - 先頭文字に「-」は使用不可 - 他のリソース(パッケージ、アクション、トリガー)名と重複不可 |

### リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `platform` | String | Optional | プラットフォーム区分 - `vpc` \| `classic`(デフォルト) |

### リクエストボディ

リクエストボディの説明は次の通りです。

#### Basicアクション

Basicアクションのリクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `description` | String | Optional | アクションの説明(Byte) - 0~3,000 |
| `web` | Boolean | Optional | ウェブアクションの設定 - `true` \| `false` - `true`: ウェブアクション - `false`: 一般のアクション - デフォルト - 新規アクションの作成時: `false` - 既存のアクションの変更時: `true` - 既存のアクションのタイプは変更不可 |
| `raw-http` | Boolean | Optional | 未加工 HTTPの使用有無 - `true` \| `false`(デフォルト) - `web`が`false`の場合、`false`のみ入力可能 - ウェブアクションのみサポート |
| `custom-options` | Boolean | Optional | ヘッダオプションの設定 - `true` \| `false`(デフォルト) - `web`が`false`の場合は`false`のみ入力可能 - ウェブアクションのみサポート |
| `parameters` | Object | Optional | アクションのデフォルトパラメータ - `{&quot;key&quot;: &quot;value&quot;}`形式の 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) - Custom Imageランタイムは v2.1のみサポート |
| `exec.binary` | Boolean | Required | アクションコードファイルはバイナリかどうか - `true` \| `false` - `true`: `exec.code`にアクションコードファイルの Base64エンコードされた値を入力 - `false`: `exec.code`にアクションコードを入力 - `exec.kind`が`java`または`dotnet:2.2`の場合は`true`と入力 |
| `exec.code` | String | Required | アクションのソースコード - ソースコード: コード内容をそのまま入力 - ファイル添付: アクションコードファイルのバイナリデータを Base64エンコードして入力 - コードを直接入力する場合、エスケープ(escape)処理が必要 - Javaまたは.netランタイムはファイルバイナリのみ許可 - Javaは圧縮された*.jarファイル形式のみアップロード可能 - .net(dotnet)の場合、*.zipファイル(圧縮ファイル)形式のみアップロード可能 |
| `exec.main` | String | Required | 実行関数 |
| `vpc` | Object | Optional | 接続対象の VPC情報 - `platform`が`vpc`の場合にのみ入力 |
| `vpc.vpcNo` | Integer | Optional | 接続対象の VPC番号 - [getVPCList](/docs/ja/networking-vpc-vpcmanagement-getvpclist)を参照 |
| `vpc.subnetNo` | Integer | Optional | 接続対象の Subnet番号 - [getSubnetList](/docs/ja/networking-vpc-subnetmanagement-getsubnetlist)を参照 |

#### Sequenceアクション

Sequenceアクションのリクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `description` | String | Optional | アクションの説明(Byte) - 0~3,000 |
| `web` | Boolean | Optional | ウェブアクションの設定 - `true` \| `false` - `true`: ウェブアクション - `false`: 一般のアクション - デフォルト - 新規アクションの作成時: `false` - 既存のアクションの変更時: `true` - 既存のアクションのタイプは変更不可 |
| `exec.kind` | String | Required | アクションの種類 - `sequence`(固定値) |
| `exec.components` | String[] | Required | シーケンスアクションに関連付けるアクションリスト - `{packageName}/{actionName}`形式 - アクションを実行する順に入力 - パッケージに属しないアクションを関連付ける場合、`packageName`に記号の「-」を入力 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request PUT 'https://cloudfunctions.apigw.ntruss.com/api/v2/packages/package003/actions/action001?platform=classic' \
--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" : "Create Action",
    "web": false,
    "raw-http": false,
    "custom-options" : false,
    "parameters": {
            "name": "action000"
    },
    "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"
    }
}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

レスポンスボディの説明は次の通りです。

#### Basicアクション

Basicアクションのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content` | Object | - | アクションの作成、変更情報 |
| `content.name` | String | - | アクションの名前 |
| `content.path` | String | - | アクションのパス |
| `content.description` | String | - | アクションの説明 |
| `content.parameters` | Object | - | アクションの基本パラメータ |
| `content.resourceId` | String | - | アクションのリソース ID |
| `content.web` | Boolean | - | ウェブアクションの設定 |
| `content.raw-http` | Boolean | - | 未加工 HTTPの使用有無 - ウェブアクションのみサポート |
| `content.custom-options` | Boolean | - | ヘッダオプションの設定 - ウェブアクションのみサポート |
| `content.exec.binary` | Boolean | - | アクションコードのファイルはバイナリかどうか |
| `content.exec.code` | String | - | アクションのソースコードまたは Base64-encodedコードファイルのバイナリ |
| `content.exec.kind` | String | - | 使用言語 |
| `content.exec.main` | String | - | 実行関数 |
| `content.limits.memory` | Integer | - | アクションコンテナに割り当てられるメモリの容量 |
| `content.limits.timeout` | Integer | - | アクションが実行される最大時間 |
| `content.vpc` | Object | - | 接続された VPC情報 - `platform`が`vpc`の場合にのみ表示 |
| `content.vpc.vpcNo` | Integer | - | 接続された VPC番号 |
| `content.vpc.subnetNo` | Integer | - | 接続された Subnet番号 |

#### Sequenceアクション

Sequenceアクションのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content` | Object | - | アクションの作成、変更情報 |
| `content.name` | String | - | アクションの名前 |
| `content.path` | String | - | アクションのパス |
| `content.description` | String | - | アクションの説明 |
| `content.resourceId` | String | - | アクションのリソース ID |
| `content.web` | Boolean | - | ウェブアクションの設定 |
| `content.exec.kind` | String | - | アクションの種類 - `sequence`(固定値) |
| `content.exec.components` | String[] | - | 関連付けられたアクションリスト |

### レスポンスステータスコード

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
{
    "content": {
        "custom-options": false,
        "description": "Create 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": "action001",
        "parameters": {
            "name": "action000"
        },
        "path": "otojYBN*****/package003",
        "raw-http": false,
        "resourceId": "Hb***",
        "web": false
    }
}
```