ncloud_functions_create_trigger
Create or update a Cloud Functions trigger to invoke functions on cron schedules, GitHub events, object storage changes, SourceCommit, Insight, or Secret Manager events.
Instructions
Create or update a Cloud Functions trigger (PUT /ncf/api/v2, API v2.1 — idempotent). type is a query parameter and cannot change after creation. Body fields are FLAT (no wrapper) and depend on type: cron → cronOption (required). cronOption is a 5-field UNIX cron expression: 'minute hour day-of-month month day-of-week' (e.g. '0 8 * * ' = 08:00 daily, '/5 * * * *' = every 5 minutes). The expression is evaluated in KST (Asia/Seoul, UTC+9) — live-verified on 2026-09-15 in the KR region: a trigger set to '41 22 * * *' fired at 22:41:00 KST. The official guide (guide.ncloud-docs.com/docs/cloudfunctions-cron-vpc) does not document the time zone, so re-verify with a probe trigger before relying on it in another region. github → credential {username, accessToken, repository} + events [...] (required); link {productName, apiName, stageName} is required on first creation (API Gateway must be subscribed). insight → insightLink [{prodKey, ruleGrpId, reminderTime?, enableNotiWhenEventClose?}] (optional). object_storage → objectStorageLink [{bucketName, eventRuleName}] (required). Beware of recursion if the linked action writes to the same bucket. source_commit → sourceCommitLink [{repositoryName, webhookName, enable?}] (required; KR VPC only). secret_manager → secretManagerLink [{secretName}] (required; KR VPC only; one secret can be linked to one trigger). Link actions afterwards with ncloud_functions_link_trigger_action. Use dryRun=true to preview.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | No | github only: API Gateway endpoint to create the webhook on (required when creating; ignored on update) | |
| type | Yes | Trigger type (query parameter; immutable after creation) | |
| dryRun | No | Preview the request without calling the API | |
| events | No | github only: events to trigger on, e.g. ['push'] or ['*'] | |
| platform | No | Platform (default: vpc). Singapore/Japan regions support vpc only. | vpc |
| credential | No | github only: GitHub credentials | |
| cronOption | No | cron only. 5-field UNIX cron 'min hour dom mon dow', e.g. '0 8 * * *'. Evaluated in KST (UTC+9) — live-verified 2026-09-15 on KR; the time zone is not documented by Ncloud. | |
| parameters | No | Default parameters as a {key: value} JSON object, merged into every invocation (precedence: runtime > trigger > action > package) | |
| description | No | Description (0-3000 bytes) | |
| insightLink | No | insight only: Cloud Insight event rules to link | |
| triggerName | Yes | Trigger name: 1-50 chars of letters, digits, '-' and '_'; must not start with '-'; unique across packages/actions/triggers | |
| sourceCommitLink | No | source_commit only: repository webhooks to link | |
| objectStorageLink | No | object_storage only: bucket event rules to link | |
| secretManagerLink | No | secret_manager only: secrets to link |