NOVOPublication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2Veja o changelog →

Edge Functions

Código do servidor, próximo aos seus dados.

Escreva funções Deno, chame-as do SDK com erros de digitação e tempos limite e execute-as sob demanda, em segundo plano ou de acordo com uma programação.

Deno
tempo de execução
3
maneiras de executar: sob demanda, trabalho, 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

O que está incluído

Tudo para executar seu código. Sem gerenciar servidores.

Tempo de execução

Funções Deno

Escreva manipuladores de solicitação e resposta padrão com Deno.serve e TypeScript.

Invocação

Invocar a partir do SDK

Chame uma função pelo nome com método, caminho, cabeçalhos e corpo.

Roteamento

Subrotas dentro de uma função

Uma função pode servir vários caminhos e métodos.

Controle

Tempos limite e cancelamento

Defina um tempo limite ou passe um AbortSignal. Ambos relatam o mesmo erro de tempo limite.

Erros

Erros digitados

Informe um erro que sua função retornou de uma falha de relé, para que você saiba se ela foi executada antes de tentar novamente.

Respostas

JSON, texto, Blob ou ArrayBuffer

Escolha como o corpo da resposta é decodificado.

Plano de fundo

Trabalhos assíncronos

Liste os trabalhos por status e siga um por seu ID.

Horários

Cron jobs

Execute uma função em uma programação cron, com uma carga útil.

Implantar

Implantar a partir da CLI ou do Studio

Envie uma função com a CLI do aura, do Studio ou por meio da API HTTP.

Como funciona

De um manipulador a uma chamada.

  1. 1

    Escreva

    Crie um manipulador Deno.serve que leia uma solicitação e retorne uma resposta.

  2. 2

    Implantar

    Envie-o com a implantação de funções do aura ou do Studio.

  3. 3

    Invocar

    Chame-o pelo nome com aura.functions.invoke.

  4. 4

    Cronograma

    Opcionalmente, execute-o em uma programação cron.

API REST

Prefere HTTP simples? Está tudo aqui.

O SDK é uma camada fina sobre essas rotas. Envie a chave API do seu projeto com cada solicitação.

MétodoPonto finalDescrição
GET/v1/functionsListe as funções do projeto.
GET/v1/functions/{name}Leia os detalhes de uma função.
POST/v1/functions/{name}/invokeExecute uma função com método, caminho, cabeçalhos e corpo.
GET/v1/functions/jobsLista trabalhos assíncronos, filtrados por status.
GET/v1/functions/jobs/{id}Leia um trabalho.
GET/v1/functions/cronListar trabalhos agendados.
POST/v1/functions/cronAgende uma função com uma expressão cron.
DELETE/v1/functions/cron/{name}Exclua um trabalho agendado.

Perguntas

É bom saber.

Qual tempo de execução as funções usam?+
Deno. Sua função é um manipulador Deno.serve escrito em TypeScript ou JavaScript.
Como faço para implantar uma função?+
Execute aura funções implantar <nome> com a CLI ou use o Studio ou a API HTTP. O SDK invoca funções, mas não as implanta.
Uma função pode transmitir sua resposta?+
Não. O SDK aguarda a resposta completa antes de ser resolvido, independentemente do tipo de resposta escolhido.
É seguro tentar novamente uma chamada com falha?+
Após um 503, a função não foi executada, portanto, tentar novamente é seguro. Depois de um 504, ele foi iniciado e pode ter tido efeitos colaterais, portanto, tente novamente apenas operações que sejam idempotentes.
Posso agendar uma função?+
Sim. Crie um cron job com um nome, uma expressão cron e a função a ser chamada. Você pode listar e excluir trabalhos do SDK.
Posso escolher a região em que uma função é executada?+
Não no momento. A seleção de região para funções não está disponível.

Pronto para executar o código?

Envie sua primeira função hoje.

Funções estão incluídas em cada projeto. Não é necessário cartão de crédito.