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¶

Create zip
```
make create_package
```

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_stop_ecs
Enterprise Project: default
Runtime: Python 3.10
Agency: specify an agency with ecs start/stop permission
(e.g. Permission ECS User)

In Code tab, section Code Source click Upload -> Local Zip and upload dist/code.zip from previous step on the code page.

Configure function:

Basic Settings
- Handler: src/index.handler for sending signed requests using AK/SK/ST from agency
or
- Handler: src/index_token.handler for sending requests using Token from agency
Environment variables
- INSTANCE_ID = instance id of ECS instance to start
- REGION = your region
- ECS_ENDPOINT = 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-09-30 08:01:05 UTC - commit: 9655e588c27eff2dd2f5891bc87fe541f6458b7d