NIEUWPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Zie de changelog →

Edge Functions

Servercode, naast uw gegevens.

Schrijf Deno-functies, roep ze aan vanuit de SDK met getypte fouten en time-outs, en voer ze op aanvraag, op de achtergrond of volgens een schema uit.

Deno
looptijd
3
manieren om te draaien: 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

Wat is inbegrepen

Alles om uw code uit te voeren. Zonder servers te beheren.

Looptijd

Deno-functies

Schrijf standaard Request- en Response-handlers met Deno.serve en TypeScript.

Aanroep

Aanroepen vanuit de SDK

Roep een functie op naam aan met een methode, pad, headers en body.

Routering

Subroutes binnen een functie

Eén functie kan meerdere paden en methoden dienen.

Controle

Time-outs en annulering

Stel een time-out in of geef een AbortSignaal door. Beide rapporteren dezelfde time-outfout.

Fouten

Typefouten

Vertel een fout die uw functie heeft geretourneerd na een relaisfout, zodat u weet of deze is uitgevoerd voordat u het opnieuw probeert.

Reacties

JSON, tekst, Blob of ArrayBuffer

Kies hoe de antwoordtekst wordt gedecodeerd.

Achtergrond

Asynchrone taken

Geef vacatures weer op status en volg er een op basis van de ID.

Schema's

Cron-banen

Voer een functie uit volgens een cron-schema, met een payload.

Implementeren

Implementeren vanuit de CLI of Studio

Verzend een functie met de aura CLI, vanuit Studio of via de HTTP API.

Hoe het werkt

Van handler tot beller.

  1. 1

    Schrijf

    Maak een Deno.serve-handler die een verzoek leest en een antwoord retourneert.

  2. 2

    Implementeren

    Verzend het met aura-functies of vanuit Studio.

  3. 3

    Aanroepen

    Noem het bij naam met aura.functions.invoke.

  4. 4

    Schema

    Voer het eventueel uit volgens een cron-schema.

REST-API

Liever gewone HTTP? Het is allemaal hier.

De SDK is een dunne laag over deze routes. Stuur bij elk verzoek de API-sleutel van uw project mee.

MethodeEindpuntBeschrijving
GET/v1/functionsNoem de functies van het project.
GET/v1/functions/{name}Lees de details van één functie.
POST/v1/functions/{name}/invokeVoer een functie uit met een methode, pad, headers en body.
GET/v1/functions/jobsLijst met asynchrone taken, gefilterd op status.
GET/v1/functions/jobs/{id}Lees één baan.
GET/v1/functions/cronGeef geplande taken weer.
POST/v1/functions/cronPlan een functie met een cron-expressie.
DELETE/v1/functions/cron/{name}Een geplande taak verwijderen.

Vragen

Goed om te weten.

Welke runtime gebruiken functies?+
Deno. Uw functie is een Deno.serve-handler geschreven in TypeScript of JavaScript.
Hoe implementeer ik een functie?+
Voer aura-functies uit, implementeer <naam> met de CLI, of gebruik Studio of de HTTP API. De SDK roept functies aan, maar implementeert deze niet.
Kan een functie zijn reactie streamen?+
Nee. De SDK wacht op het hele antwoord voordat het wordt opgelost, welk antwoordtype u ook kiest.
Is het veilig om een mislukt gesprek opnieuw te proberen?+
Na een 503 werd de functie niet uitgevoerd, dus opnieuw proberen is veilig. Na een 504 begon het en kan het bijwerkingen hebben gehad, dus probeer alleen operaties opnieuw die idempotent zijn.
Kan ik een functie plannen?+
Ja. Maak een cronjob met een naam, een cron-expressie en de functie die moet worden aangeroepen. U kunt taken uit de SDK weergeven en verwijderen.
Kan ik de regio kiezen waarin een functie wordt uitgevoerd?+
Op dit moment niet. Regioselectie voor functies is niet beschikbaar.

Klaar om code uit te voeren?

Verstuur vandaag nog uw eerste functie.

In elk project zijn functies opgenomen. Geen creditcard vereist.