Como instanciar functions em sua aplicação

Aprenda como instanciar e configurar Functions na Azion para otimizar sua application usando o Console ou Real-Time Manager.

Ver como Markdown

Instancie funções serverless diretamente dentro de sua application.

Este guia descreve como você pode instanciar a função Azion - Hello World, pré-configurada em sua conta. Você pode repetir este processo usando qualquer função já disponível no Azion Marketplace ou desenvolver sua própria função.

Atenção — Você deve ativar o módulo Functions para implementar funções em sua aplicação. Se Functions estiver ativado, o tempo de computação e as invocações podem gerar custos relacionados ao uso. Consulte a página de preços para mais informações.

Acesse o Azion Console > Applications.
Clique na application que você deseja configurar.
Ative o módulo Functions para habilitar funções.
Clique no botão Save.
Vá para a aba Functions Instances.
Clique em + Function Instance.
Nomeie sua instância de função. Por exemplo: Hello World function.
Selecione a função Azion - Hello World.
Clique no botão Save.

A página de funções agora lista a nova instância criada. No entanto, esta nova função ainda não está ativa em sua aplicação. Você precisa definir o que acionará a função em sua aplicação. Para invocar a função instanciada no URI xxxxxxxxxx.map.azionedge.net/hello-world:

Ainda na página do Applications, navegue até a aba Rules Engine.
Clique no botão + Rule.
Dê um nome para sua regra.
Selecione Request Phase.
Na seção Criteria, selecione a variável ${uri}.

A variável ${uri} pode já estar selecionada por padrão se você não ativou o módulo Application Accelerator.

Como operador de comparação, selecione is equal.
Como argumento, adicione /hello-world.
Na seção Behaviors, selecione Run Function da lista de comportamentos.
Selecione a função Hello World.
Clique no botão Save.

Para ver sua função em execução, acesse sua aplicação usando seu domínio e o URI definido na regra, que está no formato xxxxxxxxx.map.azionedge.net/hello-world.

Execute a seguinte requisição PATCH em seu terminal, substituindo [TOKEN VALUE] por seu personal token e a variável <application_id> por seu ID de application para ativar o módulo Functions:

curl --request PATCH --url https://api.azion.com/v4/edge_application/applications/<application_id> --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"modules": {

"edge_functions": {

"enabled": true

}

Você receberá uma resposta com o valor atualizado.
Execute a seguinte requisição GET para recuperar o edge_function_id da função Hello World:

curl --request GET --url https://api.azion.com/v4/edge_functions/functions --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]'

Você receberá uma resposta semelhante a esta:

{

"count": 1,

"results": [

{

"id": <function_id>,

"name": "Minha Função",

"last_editor": "your-email@example.com",

"last_modified": "2025-08-14T16:37:54.966088Z",

"product_version": "2.0",

"active": true,

"runtime": "azion_js",

"execution_environment": "application",

"code": "",

"default_args": {},

"reference_count": 0,

"version": "-",

"vendor": null

}

]

}

Copie o valor <function_id>.
Execute a seguinte requisição POST, substituindo o valor do ID da function pelo valor que você recebeu na resposta anterior:

curl --request POST --url https://api.azion.com/v4/edge_application/applications/<application_id>/functions --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"name": "Nome da Minha Instância",

"edge_function": <function_id>,

"active": true

}

Você receberá uma resposta semelhante a esta:

{

"state": "pending",

"data": {

"id": <edge_function_instance_id>,

"name": "Minha Instância de Função",

"args": {},

"edge_function": 123456,

"active": true,

"last_editor": "your-email@example.com",

"last_modified": "2025-08-14T16:41:56.699896Z"

}

Chave	Descrição
`edge_function`	O ID da function. Este não é o mesmo que o ID da função instanciada, que é único para cada instância de função da aplicação.
`name`	Nome da função instanciada.
`args`	Definição dos argumentos necessários para a função. Algumas funções não necessitam de argumentos.
`id`	ID da função instanciada.

Execute a seguinte requisição POST em seu terminal, substituindo [TOKEN VALUE] por seu personal token, a variável <application_id> por seu ID de application, e a variável <edge_function_instance_id> pelo ID da instância da função recebida na resposta anterior:

curl --request POST --url https://api.azion.com/v4/edge_application/applications/<application_id>/request_rules --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data {

"name": "Executar Hello World",

"active": true,

"criteria": [

[

{

"conditional": "if",

"variable": "${uri}",

"operator": "is_equal",

"argument": "/hello-world"

}

]

],

"behaviors": [

{

"type": "run_function",

"attributes": { "value": <edge_function_instance_id> }

}

],

"description": "Executar função em /hello-world"

}

Para mais informações sobre o endpoint de regras, veja o guia sobre como trabalhar com regras.

Você receberá uma resposta semelhante a esta, confirmando que sua função foi criada com sucesso:

{

"state": "pending",

"data": {

"id": <rule_id>,

"name": "Executar Hello World",

"active": true,

"criteria": [

[

{

"conditional": "if",

"variable": "${uri}",

"operator": "is_equal",

"argument": "/hello-world"

}

]

],

"behaviors": [

{

"type": "run_function",

"attributes": {

"value": <edge_function_instance_id>

}

],

"description": "Executar função em /hello-world",

"order": 0,

"last_editor": "your-email@example.com",

"last_modified": "2025-08-14T17:04:44.222534Z"

}

Aguarde alguns minutos para que as alterações se propaguem.

Para ver sua função sendo executada, acesse sua aplicação usando seu domínio e o URI definido na regra, que está no formato xxxxxxxxx.map.azionedge.net/hello-world.

Confira a documentação da API da Azion e a especificação OpenAPI para saber mais sobre o que a API Azion pode oferecer.