---
title: "ay functions"
source: "https://ayoune.com/de/docs/cli/befehls-referenz/folder-based-commands/ay-functions"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "de"
retrieved: "2026-08-27T21:23:38.646Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay functions` (Alias: `fns`)

Lokale Entwicklung, Deployment und Verwaltung von Custom Functions (FaaS). Sandbox via `isolated-vm`, 5 Trigger-Types.

## Subcommands

| Subcommand | Zweck |
|---|---|
| `list` | Deployed Functions mit Version, Status, letzter Aufruf |
| `get <name>` | Function-Details + Code + Config |
| `create <name>` | Scaffold lokal + Remote-Stub anlegen |
| `deploy <name>` | Code + Config hochladen, neue Version aktivieren |
| `invoke <name>` | Ad-hoc-Aufruf mit `--data '<json>'` |
| `delete <name>` | Function entfernen |
| `rollback <name> <version>` | Auf frühere Version zurück |
| `versions <name>` | Version-History |
| `logs <name>` | Letzte N Execution-Logs streamen |

## Beispiel: Neue Function

```bash
ay functions create welcome-mail
# ➜ tooling/functions/welcome-mail/{index.ts, config.yaml}

# Code editieren, dann:
ay functions deploy welcome-mail
ay functions invoke welcome-mail --data '{"consumerId":"..."}'
ay functions logs welcome-mail --follow
```

## Function-Config

```yaml
# config.yaml
name: welcome-mail
description: Sendet Willkommens-Email an neuen Consumer
trigger:
  type: event           # oder: cron, webhook, manual, scheduled
  topic: consumers.created
runtime: node20
timeout: 10s
memory: 128MB
secrets:
  - SMTP_PASSWORD       # Credentials-Vault-Key
allowedEntities:
  - Consumers
  - Emails
```

## Trigger-Types

| Type | Auslöser |
|---|---|
| `event` | Platform-Event (z.B. `orders.paid`) |
| `cron` | Repeatable-Schedule (Cron-Expression) |
| `webhook` | Externer HTTP-Aufruf |
| `manual` | Per `ay functions invoke` |
| `scheduled` | Einmaliger Zeitpunkt |

## Platform-SDK

Inside einer Function steht `ay.*` zur Verfügung:

```ts
export default async function({ event, ay }) {
  const consumer = await ay.db('Consumers').findById(event.consumerId);
  await ay.email.send({ to: consumer.email, template: 'welcome' });
}
```

Der SDK ist opt-in-scoped: nur Entities in `allowedEntities` + mit `availableInSDK=true` in `modelsAndRights.ts` sind erreichbar (Stand 2026-04: 26 kuratierte Entries).

## Siehe auch

- [credentials](wiki:cli/misc/credentials) — Secrets verwalten
- [jobs](wiki:cli/misc/jobs) — Function-Queues beobachten

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com