НОВЫЙ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

Выберите способ декодирования тела ответа.

Фон

Асинхронные задания

Перечислите задания по статусу и следуйте за одним из них по его идентификатору.

Расписания

Крон вакансии

Запустите функцию по расписанию cron с полезной нагрузкой.

Развертывать

Развертывание из CLI или Studio

Отправьте функцию с помощью CLI aura, из 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}Удалить запланированное задание.

Вопросы

Приятно знать.

Какую среду выполнения используют функции?+
Дено. Ваша функция — это обработчик Deno.serve, написанный на TypeScript или JavaScript.
Как развернуть функцию?+
Запустите функции aura , разверните <name> с помощью CLI или используйте Studio или HTTP API. SDK вызывает функции, но не развертывает их.
Может ли функция передавать свой ответ в потоковом режиме?+
Нет. SDK ожидает ответа целиком, прежде чем его разрешить, независимо от того, какой тип ответа вы выберете.
Безопасно ли повторить неудачный вызов?+
После ошибки 503 функция не запустилась, поэтому повторная попытка безопасна. После 504 он все же запустился и мог иметь побочные эффекты, поэтому повторяйте только те операции, которые являются идемпотентными.
Могу ли я запланировать мероприятие?+
Да. Создайте задание cron с именем, выражением cron и вызываемой функцией. Вы можете перечислять и удалять задания из SDK.
Могу ли я выбрать регион, в котором работает функция?+
Не сейчас. Выбор региона для функций недоступен.

Готовы запустить код?

Выпустите свою первую функцию сегодня.

Функции включены в каждый проект. Кредитная карта не требуется.