Execute uma função em uma aplicação

Adicione a regra do Rules Engine que executa uma instância de função em uma aplicação pelo Azion Console ou pela Azion API e verifique a resposta.

Última atualização

Ver como Markdown Configurar agente

Uma instância de função é executada apenas quando uma regra do Rules Engine a seleciona com o comportamento Run Function. Você adiciona essa regra pelo Azion Console ou pela Azion API. Para uma primeira execução guiada que cria a função, a instância e a regra em uma só passagem, consulte Primeiros passos com Functions.

Pré-requisitos

dica — Uma função pré-configurada do Azion Marketplace substitui uma função que você escreve. A função Azion - Hello World está vinculada à sua conta e pronta para ser instanciada.

Adicione a regra que executa a função

A regra define a fase de execução, os critérios que a acionam e a instância que ela executa. A regra então executa essa instância em toda requisição que corresponde aos critérios. Azion Console e Azion API criam a mesma regra.

Adicione a regra pelo Azion Console

Para adicionar a regra pelo Azion Console:

Abra a aplicação

Acesse Azion Console > Applications > sua aplicação.

Na aba Rules Engine, selecione + Rule
Nomeie a regra

Digite um nome para a regra. Por exemplo: Run hello-world.

Selecione Request Phase
Na seção Criteria, selecione a variável de URI

Selecione a variável ${uri}.

Selecione is equal como operador de comparação
Digite a URI que executa a função

Digite a URI como argumento. Por exemplo: /hello-world.

Na seção Behaviors, selecione Run Function
Selecione a instância de função
Selecione Save

A regra aparece na aba Rules Engine da aplicação. Novas regras podem levar alguns minutos para propagar.

nota — Se Run Function não estiver na lista de Behaviors, a aplicação também precisa do módulo Application Accelerator. Consulte Run Function não aparece na lista de comportamentos para a correção.

Adicione a regra pela Azion API

Envie uma requisição POST para o endpoint de request rules da aplicação. Substitua [TOKEN VALUE] pelo seu personal token, <application_id> pelo ID da sua aplicação e <edge_function_instance_id> pelo ID da instância de função:

Shell
01curl --request POST \
02 --url https://api.azion.com/v4/workspace/applications/<application_id>/request_rules \
03 --header 'Accept: application/json' \
04 --header 'Authorization: Token [TOKEN VALUE]' \
05 --header 'Content-Type: application/json' \
06 --data {
07 "name": "Run Hello World",
08 "active": true,
09 "criteria": [
10 [
11 {
12 "conditional": "if",
13 "variable": "${uri}",
14 "operator": "is_equal",
15 "argument": "/hello-world"
16 }
17 ]
18 ],
19 "behaviors": [
20 {
21 "type": "run_function",
22 "attributes": { "value": <edge_function_instance_id> }
23 }
24 ],
25 "description": "Run function on /hello-world"
26}

A resposta retorna a regra que a aplicação agora carrega:

JSON
01{
02 "state": "pending",
03 "data": {
04 "id": <rule_id>,
05 "name": "Run Hello World",
06 "active": true,
07 "criteria": [
08 [
09 {
10 "conditional": "if",
11 "variable": "${uri}",
12 "operator": "is_equal",
13 "argument": "/hello-world"
14 }
15 ]
16 ],
17 "behaviors": [
18 {
19 "type": "run_function",
20 "attributes": {
21 "value": <edge_function_instance_id>
22 }
23 }
24 ],
25 "description": "Run function on /hello-world",
26 "order": 0,
27 "last_editor": "your-email@example.com",
28 "last_modified": "2026-01-01T12:00:00.000000Z"
29 }
30}

O valor "state": "pending" significa que a regra leva alguns minutos para propagar. Para todos os campos do endpoint de rules, consulte Crie uma regra de aplicação.

Verifique a resposta

Sua aplicação responde em um domínio no formato xxxxxxxxx.map.azionedge.net. Para definir o domínio da sua aplicação, consulte Adicione um domínio a um workload.

Aguarde a propagação da regra e requisite a URI definida nos critérios:

curl https://<your-azion-domain>/hello-world

O corpo da resposta é a string que a função retorna. A função hello-world de Primeiros passos com Functions responde:

Hello World!

Uma resposta que não vem da função significa que a regra não correspondeu à requisição ou que a alteração ainda não propagou.

Próximos passos

Primeiros passos com FunctionsO caminho completo, de uma conta vazia até uma função que responde a uma requisição.Instancie uma função em uma aplicaçãoCrie a instância que esta regra seleciona e passe seus Args em JSON.Crie uma regra de aplicaçãoOs critérios e comportamentos que uma regra carrega, além de Run Function.Solução de problemas de execução e logs de funçõesO que verificar quando uma função não roda ou retorna um erro.