NEUPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Siehe Changelog →

Edge Functions

Servercode, neben Ihren Daten.

Schreiben Sie Deno-Funktionen, rufen Sie sie mit eingegebenen Fehlern und Zeitüberschreitungen aus dem SDK auf und führen Sie sie bei Bedarf, im Hintergrund oder nach einem Zeitplan aus.

Deno
Laufzeit
3
Ausführungsmöglichkeiten: On Demand, Job, Cron
functions.tsTS
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(
'https://my-project.aurabase.cloud',
'aura_anon_xxx',
)
const { data, error } = await aura.functions.invoke<{ ok: boolean }>(
'hello-world',
{ body: { name: 'Ada' } },
)
if (error) throw error

Was ist enthalten?

Alles, um Ihren Code auszuführen. Ohne Serververwaltung.

Laufzeit

Deno-Funktionen

Schreiben Sie Standard-Request- und Response-Handler mit Deno.serve und TypeScript.

Anrufung

Aufruf über das SDK

Rufen Sie eine Funktion nach Namen mit Methode, Pfad, Headern und Text auf.

Routenführung

Unterrouten innerhalb einer Funktion

Eine Funktion kann mehrere Pfade und Methoden bedienen.

Kontrolle

Auszeiten und Stornierung

Legen Sie ein Timeout fest oder übergeben Sie ein AbortSignal. Beide melden den gleichen Timeout-Fehler.

Fehler

Tippfehler

Teilen Sie einen Fehler mit, den Ihre Funktion aufgrund eines Relay-Fehlers zurückgegeben hat, damit Sie wissen, ob sie ausgeführt wurde, bevor Sie es erneut versuchen.

Antworten

JSON, Text, Blob oder ArrayBuffer

Wählen Sie aus, wie der Antworttext dekodiert wird.

Hintergrund

Asynchrone Jobs

Listen Sie Jobs nach Status auf und folgen Sie einem Job nach seiner ID.

Zeitpläne

Cron-Jobs

Führen Sie eine Funktion nach einem Cron-Zeitplan mit einer Nutzlast aus.

Bereitstellen

Bereitstellung über die CLI oder Studio

Versenden Sie eine Funktion mit der Aura-CLI, aus Studio oder über die HTTP-API.

Wie es funktioniert

Vom Handler zum Anruf.

  1. 1

    Schreiben

    Erstellen Sie einen Deno.serve-Handler, der eine Anfrage liest und eine Antwort zurückgibt.

  2. 2

    Bereitstellen

    Versenden Sie es mit der Bereitstellung von Aura-Funktionen oder über Studio.

  3. 3

    Aufruf

    Nennen Sie es mit aura.functions.invoke beim Namen.

  4. 4

    Zeitplan

    Führen Sie es optional nach einem Cron-Zeitplan aus.

REST-API

Bevorzugen Sie einfaches HTTP? Es ist alles hier.

Das SDK ist eine dünne Schicht über diesen Routen. Senden Sie bei jeder Anfrage den API-Schlüssel Ihres Projekts.

MethodeEndpunktBeschreibung
GET/v1/functionsListen Sie die Funktionen des Projekts auf.
GET/v1/functions/{name}Lesen Sie die Details einer Funktion.
POST/v1/functions/{name}/invokeFühren Sie eine Funktion mit einer Methode, einem Pfad, Headern und einem Textkörper aus.
GET/v1/functions/jobsListen Sie asynchrone Jobs auf, gefiltert nach Status.
GET/v1/functions/jobs/{id}Lesen Sie einen Job.
GET/v1/functions/cronGeplante Jobs auflisten.
POST/v1/functions/cronPlanen Sie eine Funktion mit einem Cron-Ausdruck.
DELETE/v1/functions/cron/{name}Löschen Sie einen geplanten Job.

Fragen

Gut zu wissen.

Welche Laufzeit nutzen Funktionen?+
Deno. Ihre Funktion ist ein Deno.serve-Handler, der in TypeScript oder JavaScript geschrieben ist.
Wie stelle ich eine Funktion bereit?+
Führen Sie die Aura-Funktionen „“ „Deploy <Name> “ mit der CLI aus oder verwenden Sie Studio oder die HTTP-API. Das SDK ruft Funktionen auf, stellt sie jedoch nicht bereit.
Kann eine Funktion ihre Antwort streamen?+
Nein. Das SDK wartet auf die gesamte Antwort, bevor es aufgelöst wird, unabhängig davon, welchen Antworttyp Sie auswählen.
Ist es sicher, einen fehlgeschlagenen Anruf erneut zu versuchen?+
Nach einem 503 wurde die Funktion nicht ausgeführt, daher ist ein erneuter Versuch sicher. Nach einem 504-Fehler startete es tatsächlich und hatte möglicherweise Nebenwirkungen. Versuchen Sie daher nur Vorgänge, die idempotent sind.
Kann ich eine Veranstaltung planen?+
Ja. Erstellen Sie einen Cron-Job mit einem Namen, einem Cron-Ausdruck und der aufzurufenden Funktion. Sie können Jobs im SDK auflisten und löschen.
Kann ich die Region auswählen, in der eine Funktion ausgeführt wird?+
Im Moment nicht. Die Regionsauswahl für Funktionen ist nicht verfügbar.

Bereit, Code auszuführen?

Versenden Sie noch heute Ihre erste Funktion.

Funktionen sind in jedem Projekt enthalten. Keine Kreditkarte erforderlich.