---
title: "Put Trigger"
slug: "compute-cloudfunctions-v2-puttrigger"
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
canonical: "api.ncloud-docs.com/compute-cloudfunctions-v2-puttrigger"
---

> ## 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 Trigger

Classic/VPC環境で利用できます。

Cloud Functionsトリガーを作成したり、変更したりします。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| PUT | /ncf/api/v2/triggers/{triggerName} |

              参考

              

シンガポールリージョンと日本リージョンは、VPC環境でのみ利用できます。

### リクエストヘッダ

Cloud Funtions APIで共通して使用されるヘッダの詳細は、[Cloud Functionsのリクエストヘッダ](/docs/ja/compute-cloudfunctions#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `triggerName` | String | Required | トリガー名 - 英数字、記号の「-」、「_」のみ使用して1~50文字以内で入力 - 先頭文字に「-」は使用不可 - 他のリソース(パッケージ、アクション、トリガー)名と重複不可 |

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `platform` | String | Optional | プラットフォーム区分 - `vpc`(デフォルト) \| `classic` |
| `type` | String | Required | トリガータイプ - `cron` \| `github` \| `insight` \| `object_storage` \| `source_commit` \| `secret_manager` - 作成後は変更不可 |

### リクエストボディ

リクエストボディの説明は次の通りです。リクエストボディにフィールドがない場合、`{}`空の JSON Object形式でリクエストします。

#### 共通

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `description` | String | Optional | トリガーの説明(Byte) - 0~3,000 |
| `parameters` | Object | Optional | トリガーの基本パラメータ - `{"key": "value"}`形式の JSON - アクション実行時、パラメータ適用の優先順位 - 1番目: 実行時に渡されるランタイムパラメータ - 2番目: 関連付けられているトリガーの基本パラメータ - 3番目: アクションの基本パラメータ - 4番目: 含まれているパッケージの基本パラメータ |

#### cronトリガー

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `cronOption` | String | Required | cronの実行オプション - [cronトリガー(VPC)](https://guide.ncloud-docs.com/docs/ja/cloudfunctions-cron-vpc)、[cronトリガー(Classic)](https://guide.ncloud-docs.com/docs/ja/cloudfunctions-cron-classic)を参照 |

#### GitHubトリガー

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `credential` | Object | Required | GitHub情報 |
| `credential.username` | String | Required | GitHubユーザー名 |
| `credential.accessToken` | String | Required | GitHubアクセストークン |
| `credential.repository` | String | Required | GitHubリポジトリ - リポジトリ名または`Organization/リポジトリ名`形式で入力 |
| `events` | String[] | Required | トリガーするイベント - `*` \| `check_run` \| `check_suite` \| `commit_comment` \| `create` \| `delete` \| `deployment` \| `deployment_status` \| `fork` \| `gollum` \| `issue_comment` \| `issues` \| `label` \| `member` \| `milestone` \| `page_build` \| `project_card` \| `project_column` \| `project` \| `public` \| `pull_request_review_comment` \| `pull_request_review_thread` \| `pull_request_review` \| `pull_request` \| `push` \| `repository` \| `repository_import` \| `repository_vulnerability_alert` \| `release` \| `status` \| `team_add` \| `watch` \| `branch_protection_rule` \| `code_scanning_alert` \| `deploy_key` \| `discussion_comment` \| `discussion` \| `meta` \| `package` \| `registry_package` \| `secret_scanning_alert_location` \| `secret_scanning_alert` \| `security_and_analysis` \| `star` \| `workflow_job` \| `workflow_run` |
| `link` | Object | Conditional | API Gateway情報 - トリガー作成時にのみ有効で、必ず入力 |
| `link.productName` | String | Conditional | API Gatewayのサービス名 |
| `link.apiName` | String | Conditional | API Gateway API名 |
| `link.stageName` | String | Conditional | API Gatewayのステージ名 |

#### Cloud Insightトリガー

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `insightLink` | Array | Optional | 関連付ける Cloud Insightイベントルール情報: [insightLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#insightLink) |

#### `insightLink`

`insightLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `prodKey` | String | Conditional | Cloud Insightイベントルールの prodKey - `insightLink`入力時、必須 |
| `ruleGrpId` | String | Conditional | Cloud Insightイベントルールの ruleGrpId - `insightLink`入力時、必須 |
| `reminderTime` | Integer | Optional | Cloud Insightイベントルールのリマインダー周期(分) - 5~720 |
| `enableNotiWhenEventClose` | Boolean | Optional | イベント終了時に Cloud Insightイベントルールを呼び出すかどうか - `true` \| `false`(デフォルト) |

#### Object Storageトリガー

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

              注意

              

Object Storageトリガーに関連付けられたアクションが Object Storageイベントルールと同じバケットを使用する場合、再帰呼び出しによる使用量の増加や多額の費用が発生する可能性があります。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `objectStorageLink` | Array | Required | 関連付ける Object Storageイベントルール情報: [objectStorageLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#objectStorageLink) |

#### `objectStorageLink`

`objectStorageLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `bucketName` | String | Required | Object Storageのバケット名 |
| `eventRuleName` | String | Required | Object Storageのイベントルール名 |

#### SourceCommitトリガー

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

              参考

              

SourceCommitトリガーは韓国リージョンの VPCプラットフォームでのみサポートしています。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `sourceCommitLink` | Array | Required | 関連付ける SourceCommitリポジトリの Webフック情報: [sourceCommitLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#sourceCommitLink) |

#### `sourceCommitLink`

`sourceCommitLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `enable` | Boolean | Optional | SourceCommit Webフックを有効化するかどうか - `true` (デフォルト) \| `false` |
| `repositoryName` | String | Required | SourceCommitリポジトリ名 |
| `webhookName` | String | Required | SourceCommit Webフック名 |

#### Secret Managerトリガー

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `secretManagerLink` | Array | Required | 関連付ける Secret Managerのシークレット情報: [secretManagerLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#secretManagerLink) |

#### `sourceCommitLink`

`sourceCommitLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `secretName` | String | Required | Secret Managerのシークレット名 |

              参考

              

- Secret Managerトリガーは韓国リージョンの VPCプラットフォームでのみサポートしています。
- 1つのトリガーには複数のシークレットを関連付けることができますが、1つのシークレットには1つのトリガーのみ関連付けることができます。

### リクエスト例

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

```
curl --location --request PUT 'https://cloudfunctions.apigw.ntruss.com/ncf/api/v2/triggers/trigger001?platform=vpc&type=cron' \
--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": "Cron Trigger",
    "parameters": {
        "period": "daily"
    },
    "cronOption": "30 1 * * *"
}'
```

## レスポンス

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

### レスポンスボディ

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

#### 共通

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content` | Object | - | トリガーの作成、変更情報 |
| `content.name` | String | - | トリガー名 |
| `content.resourceId` | String | - | トリガーのリソース ID |
| `content.triggerType` | String | - | トリガーのタイプ |
| `content.namespace` | String | - | ユーザーのネームスペース |
| `content.description` | String | - | トリガーの説明 |
| `content.parameters` | Object | - | トリガーの基本パラメータ |
| `content.rules` | Object | - | トリガーアクションの関連付け情報 |

#### cronトリガー

cronトリガーのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content.cronOption` | String | - | Cron実行オプション |

#### GitHubトリガー

GitHubトリガーのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content.credential` | Object | - | GitHub情報 |
| `content.credential.username` | String | - | GitHubユーザー名 |
| `content.credential.accessToken` | String | - | トリガーのタイプ |
| `content.namespace` | String | - | GitHubアクセストークン |
| `content.credential.repository` | String | - | GitHubリポジトリ |
| `content.events` | String[] | - | トリガーするイベントの種類 |

#### Cloud Insightトリガー

Cloud Insightトリガーのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content.insightLink` | Array | - | 関連付けられた Cloud Insightイベントルール情報: [insightLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#insightLink1) |

#### `insightLink`

`insightLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `prodKey` | String | - | Cloud Insightイベントルールの prodKey |
| `ruleGrpId` | String | - | Cloud Insightイベントの ruleGrpId |
| `reminderTime` | Integer | - | Cloud Insightイベントのリマインダー周期(分) |
| `enableNotiWhenEventClose` | Boolean | - | イベント終了時に Cloud Insightイベントルールを呼び出すかどうか |

#### Object Storageトリガー

Object Storageトリガーのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content.objectStorageLink` | Array | - | 関連付けられた Object Storageイベントルール情報: [objectStorageLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#objectStorageLink1) |

#### `objectStorageLink`

`objectStorageLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `bucketName` | String | - | Object Storageのバケット名 |
| `eventRuleName` | String | - | Object Storageのイベントルール名 |

#### SourceCommitトリガー

SourceCommitトリガーのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content.sourceCommitLink` | Array | - | 関連付けられた SourceCommitリポジトリの Webフック情報: [sourceCommitLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#sourceCommitLink1) |

#### `sourceCommitLink`

`sourceCommitLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `enable` | Boolean | - | SourceCommit Webフックを有効化するかどうか |
| `repositoryName` | String | - | SourceCommitリポジトリ名 |
| `webhookName` | String | - | SourceCommit Webフック名 |

#### Secret Managerトリガー

Secret Managerトリガーのレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `content.secretManagerLink` | Array | - | 関連付けられた Secret Managerのシークレット情報: [secretManagerLink](/docs/ja/compute-cloudfunctions-v2-puttrigger#secretManagerLink1) |

#### `secretManagerLink`

`secretManagerLink`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `secretId` | String | - | Secret Managerのシークレット ID |

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

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": "",
        "name": "trigger001",
        "namespace": "****YBNz****",
        "parameters": {
            "period": "daily"
        },
        "resourceId": "4ci**",
        "rules": {
            "****YBNz****/qr98**: {
                "action": {
                    "name": "action001",
                    "path": "****YBNz****"
                },
                "status": "active"
        },
        "triggerType": "cron"
    }
}
```