NUEVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Ver el registro de cambios →

Edge Functions

Código del servidor, al lado de sus datos.

Escriba funciones de Deno, llámelas desde el SDK con errores escritos y tiempos de espera, y ejecútelas bajo demanda, en segundo plano o según una programación.

Deno
tiempo de ejecución
3
formas de ejecutar: bajo demanda, trabajo, 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

¿Qué está incluido?

Todo para ejecutar su código. Sin gestionar servidores.

Tiempo de ejecución

funciones deno

Escriba controladores de solicitudes y respuestas estándar con Deno.serve y TypeScript.

Invocación

Invocar desde el SDK

Llame a una función por su nombre con un método, ruta, encabezados y cuerpo.

Enrutamiento

Subrutas dentro de una función

Una función puede servir para varios caminos y métodos.

controlar

Tiempos de espera y cancelación

Establezca un tiempo de espera o pase una AbortSignal. Ambos informan el mismo error de tiempo de espera.

Errores

Errores escritos

Indique un error que su función devolvió debido a una falla del relé, para saber si se ejecutó antes de volver a intentarlo.

Respuestas

JSON, texto, Blob o ArrayBuffer

Elija cómo se decodifica el cuerpo de la respuesta.

Antecedentes

Trabajos asincrónicos

Enumere los trabajos por estado y siga uno por su ID.

Horarios

Trabajos cron

Ejecute una función en una programación cron, con una carga útil.

Implementar

Implementación desde CLI o Studio

Envíe una función con aura CLI, desde Studio o mediante la API HTTP.

como funciona

De un manejador a una llamada.

  1. 1

    escribir

    Cree un controlador Deno.serve que lea una solicitud y devuelva una respuesta.

  2. 2

    Implementar

    Envíelo con funciones de aura implementadas o desde Studio.

  3. 3

    Invocar

    Llámalo por su nombre con aura.functions.invoke.

  4. 4

    Horario

    Opcionalmente, ejecútelo en una programación cron.

API REST

¿Prefieres HTTP simple? Está todo aquí.

El SDK es una fina capa sobre estas rutas. Envíe la clave API de su proyecto con cada solicitud.

MétodoPunto finalDescripción
GET/v1/functionsEnumere las funciones del proyecto.
GET/v1/functions/{name}Lea los detalles de una función.
POST/v1/functions/{name}/invokeEjecute una función con un método, ruta, encabezados y cuerpo.
GET/v1/functions/jobsEnumere trabajos asincrónicos, filtrados por estado.
GET/v1/functions/jobs/{id}Leer un trabajo.
GET/v1/functions/cronListar trabajos programados.
POST/v1/functions/cronPrograme una función con una expresión cron.
DELETE/v1/functions/cron/{name}Eliminar un trabajo programado.

Preguntas

Es bueno saberlo.

¿Qué tiempo de ejecución utilizan las funciones?+
Deno. Su función es un controlador Deno.serve escrito en TypeScript o JavaScript.
¿Cómo implemento una función?+
Ejecute las funciones de aura implementan <nombre> con la CLI o use Studio o la API HTTP. El SDK invoca funciones pero no las implementa.
¿Puede una función transmitir su respuesta?+
No. El SDK espera la respuesta completa antes de resolverse, independientemente del tipo de respuesta que elija.
¿Es seguro volver a intentar una llamada fallida?+
Después de un 503, la función no se ejecutó, por lo que volver a intentarlo es seguro. Después de un 504, comenzó y puede haber tenido efectos secundarios, por lo que solo reintente las operaciones que sean idempotentes.
¿Puedo programar una función?+
Sí. Cree un trabajo cron con un nombre, una expresión cron y la función a llamar. Puede enumerar y eliminar trabajos del SDK.
¿Puedo elegir la región en la que se ejecuta una función?+
No por el momento. La selección de región para funciones no está disponible.

¿Listo para ejecutar código?

Envíe su primera función hoy.

Las funciones están incluidas en cada proyecto. No se requiere tarjeta de crédito.