Source code for this sample can be found on GitHub.

Event-sdk-ecs¶

Sample on how to start/stop an ECS instance using FunctionGraph with Timer Event and Cron expression (start every day at 8:00, stop every day at 17:00 in timezone Europe/Berlin).

For reference see:

ECS API reference for Batch Operations in API reference.
Using a Timer Trigger in user manual.
Cron Expressions for a Function Timer Trigger in user manual.

Deploy to T Cloud Public FunctionGraph¶

Prepare deployment¶

Install modules
```
npm i
```
(make sure .npmrc file is configured)
Create the deployment ZIP from the project root:
```
npm pack
```

Deploy to FunctionGraph¶

Create following FunctionGraph function using FunctionGraph console:

Create function:

Create with: Create from scratch
Function Type: Event Function
Region: your region
FunctionName: start_ecs_nodejs
Enterprise Project: default
Runtime: Node.js 20.15
Agency: specify an agency with ecs start permission
(e.g. Permission ECS User)

In Code tab, section Code Source click Upload -> Local Zip and upload event-sdk-ecs-1.0.0.zip from previous step on the code page.

Configure function:

Environment variables
- INSTANCE_ID = instance id of ECS instance to start
- REGION = your region
- ECS_ENDPOINT = https://ecs.eu-de.otc.t-systems.com
Triggers - create stop trigger to stop instance every day at 17:00:
- Click Create Trigger:
- Trigger Type: Timer
- Timer Name: stop
- Rule: Cron expression,
  Value: CRON_TZ=Europe/Berlin 0 0 17 * * *
- Enable Trigger enable
- Additional Information: stop
Triggers - create start trigger to start instance every day at 08:00:
- Click Create Trigger:
- Trigger Type: Timer
- Timer Name: start
- Rule: Cron expression,
  Value: CRON_TZ=Europe/Berlin 0 0 8 * * *
- Enable Trigger enable
- Additional Information: start

To test the function create Test events:

Name: Start

{
    "version": "v1.0",
    "time": "2026-04-01T08:00:00+02:00",
    "trigger_type": "TIMER",
    "trigger_name": "TEST_START",
    "user_event": "start"
}

using this event will start the configured ECS instance.

Name: Stop

{
    "version": "v1.0",
    "time": "2026-04-01T17:00:00+02:00",
    "trigger_type": "TIMER",
    "trigger_name": "TEST_STOP",
    "user_event": "stop"
}

using this event will stop the configured ECS instance.

last updated: 2026-05-07 12:49:22 UTC - commit: b33b3f65aa4809f3bbb42c38e0f31e3067f81d22