NUOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Vedi il registro delle modifiche →

Edge Functions

Codice del server, accanto ai tuoi dati.

Scrivi funzioni Deno, chiamale dall'SDK con errori digitati e timeout ed eseguile su richiesta, in background o secondo una pianificazione.

Deno
tempo di esecuzione
3
modalità di esecuzione: 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

Cosa è incluso

Tutto per eseguire il tuo codice. Senza gestire i server.

Durata

Funzioni deno

Scrivi gestori di richiesta e risposta standard con Deno.serve e TypeScript.

Invocazione

Richiama dall'SDK

Chiama una funzione per nome con un metodo, percorso, intestazioni e corpo.

Instradamento

Sottopercorsi all'interno di una funzione

Una funzione può servire diversi percorsi e metodi.

Controllo

Timeout e cancellazione

Imposta un timeout o passa un segnale di interruzione. Entrambi segnalano lo stesso errore di timeout.

Errori

Errori digitati

Indica un errore restituito dalla tua funzione da un errore di inoltro, in modo da sapere se è stata eseguita prima di riprovare.

Risposte

JSON, testo, BLOB o ArrayBuffer

Scegli come viene decodificato il corpo della risposta.

Sfondo

Lavori asincroni

Elenca i lavori in base allo stato e seguine uno in base al suo ID.

Orari

Lavori Cron

Esegui una funzione secondo una pianificazione cron, con un carico utile.

Distribuire

Distribuisci dalla CLI o da Studio

Spedisci una funzione con la CLI aura, da Studio o tramite l'API HTTP.

Come funziona

Da handler a chiamata.

  1. 1

    Scrivi

    Crea un gestore Deno.serve che legge una richiesta e restituisce una risposta.

  2. 2

    Distribuire

    Spediscilo con la distribuzione delle funzioni aura o da Studio.

  3. 3

    Invocare

    Chiamalo per nome con aura.functions.invoke.

  4. 4

    Programma

    Facoltativamente eseguirlo secondo una pianificazione cron.

API REST

Preferisci il semplice HTTP? È tutto qui.

L'SDK è uno strato sottile su questi percorsi. Invia la chiave API del tuo progetto con ogni richiesta.

MetodoPunto finaleDescrizione
GET/v1/functionsElenca le funzioni del progetto.
GET/v1/functions/{name}Leggi i dettagli di una funzione.
POST/v1/functions/{name}/invokeEsegui una funzione con un metodo, percorso, intestazioni e corpo.
GET/v1/functions/jobsElenca i lavori asincroni, filtrati per stato.
GET/v1/functions/jobs/{id}Leggi un lavoro.
GET/v1/functions/cronElenca i lavori pianificati.
POST/v1/functions/cronPianifica una funzione con un'espressione cron.
DELETE/v1/functions/cron/{name}Elimina un lavoro pianificato.

Domande

Buono a sapersi.

Quale runtime utilizzano le funzioni?+
Deno. La tua funzione è un gestore Deno.serve scritto in TypeScript o JavaScript.
Come distribuisco una funzione?+
Esegui funzioni aura distribuisci <nome> con la CLI oppure utilizza Studio o l'API HTTP. L'SDK richiama le funzioni ma non le distribuisce.
Una funzione può trasmettere in streaming la sua risposta?+
No. L'SDK attende l'intera risposta prima di risolversi, qualunque sia il tipo di risposta scelto.
È sicuro riprovare una chiamata fallita?+
Dopo un 503 la funzione non è stata eseguita, quindi riprovare è sicuro. Dopo un 504 si è avviato e potrebbe aver avuto effetti collaterali, quindi riprovare solo le operazioni idempotenti.
Posso programmare una funzione?+
Sì. Crea un lavoro cron con un nome, un'espressione cron e la funzione da chiamare. Puoi elencare ed eliminare lavori dall'SDK.
Posso scegliere la regione in cui viene eseguita una funzione?+
Non al momento. La selezione della regione per le funzioni non è disponibile.

Pronto per eseguire il codice?

Spedisci la tua prima funzione oggi stesso.

Le funzioni sono incluse in ogni progetto. Nessuna carta di credito richiesta.