新Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2查看变更日志 →

Edge Functions

服务器代码,位于您的数据旁边。

编写 Deno 函数,从 SDK 中调用它们并输入错误和超时,并在后台或按计划按需运行它们。

Deno
运行时
3
运行方式:按需、作业、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

包含什么

运行代码的一切。 无需管理服务器。

运行时

德诺函数

使用 Deno.serve 和 TypeScript 编写标准请求和响应处理程序。

祈求

从SDK调用

通过名称、方法、路径、标头和主体来调用函数。

路由

函数内的子路由

一个函数可以服务于多种路径和方法。

控制

超时和取消

设置超时或传递 AbortSignal。两者都报告相同的超时错误。

错误

输入错误

告诉您的函数从中继失败返回的错误,以便您在重试之前知道它是否运行。

回应

JSON、文本、Blob 或 ArrayBuffer

选择响应正文的解码方式。

背景

异步作业

按状态列出作业,并在其后面添加其 ID。

时间表

计划任务职位

按 cron 计划运行带有有效负载的函数。

部署

从 CLI 或 Studio 部署

使用 aura CLI、Studio 或通过 HTTP API 传送函数。

它是如何运作的

从处理程序到调用。

  1. 1

    写

    创建一个 Deno.serve 处理程序来读取请求并返回响应。

  2. 2

    部署

    随 aura 功能部署或从 Studio 一起交付。

  3. 3

    调用

    使用 aura.functions.invoke 通过名称来调用它。

  4. 4

    时间表

    可以选择按 cron 计划运行它。

REST API

更喜欢纯 HTTP? 一切都在这里。

SDK 是这些路由之上的一个薄层。在每个请求中发送您项目的 API 密钥。

方法端点描述
GET/v1/functions列出项目的功能。
GET/v1/functions/{name}阅读一个函数的详细信息。
POST/v1/functions/{name}/invoke运行带有方法、路径、标头和主体的函数。
GET/v1/functions/jobs列出异步作业,按状态过滤。
GET/v1/functions/jobs/{id}读一份工作。
GET/v1/functions/cron列出预定的作业。
POST/v1/functions/cron使用 cron 表达式安排函数。
DELETE/v1/functions/cron/{name}删除预定作业。

问题

很高兴知道。

函数使用哪个运行时?+
德诺。您的函数是用 TypeScript 或 JavaScript 编写的 Deno.serve 处理程序。
如何部署功能?+
使用 CLI 运行 aura 函数部署 <名称> ,或者使用 Studio 或 HTTP API。 SDK调用函数但不部署它们。
函数可以流式传输其响应吗?+
不会。无论您选择哪种响应类型,SDK 都会在解析之前等待整个响应。
重试失败的呼叫是否安全?+
出现 503 错误后,该函数未运行,因此重试是安全的。发生 504 错误后,它确实启动了,并且可能会产生副作用,因此仅重试幂等操作。
我可以安排活动吗?+
是的。创建一个带有名称、cron 表达式和要调用的函数的 cron 作业。您可以从 SDK 中列出和删除作业。
我可以选择函数运行的区域吗?+
目前还没有。功能的区域选择不可用。

准备好运行代码了吗?

今天发布您的第一个函数。

每个项目都包含功能。无需信用卡。