Todos os produtos
Search
Central de documentação

Function Compute:Criar uma função acionada por eventos

Última atualização: Jun 29, 2026

Funções acionadas por eventos executam seu código em resposta a eventos de gatilhos, como os do Function Compute, do Object Storage Service (OSS) e do RocketMQ. Cada função roda isoladamente; a execução de uma não afeta as demais. Este tópico explica como criar, editar e excluir uma função acionada por eventos, além de obter o Aliyun Resource Name (ARN) dela no console do Function Compute.

Pré-requisitos

Antes de começar, verifique se você tem:

Criar uma função

Siga os passos abaixo para criar uma função acionada por eventos com um runtime integrado e código de exemplo. Depois da criação, substitua o código de exemplo pela sua própria lógica.

  1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Function.

  2. Na barra de menus superior, selecione uma região. Na página Function, clique em Create Function.

  3. Na caixa de diálogo, selecione Event Function como tipo de função e clique em Create.

  4. Na página Create Function, configure os parâmetros a seguir e clique em Create.

Configurações básicas

Parâmetro

Descrição

Exemplo

Function name

Identificador exclusivo da função na mesma conta e região. Deve seguir as convenções de nomenclatura.

myFunction

vCPU

Número de núcleos de CPU virtual alocados à função. A proporção entre vCPU e memória deve variar de 1:1 a 1:4.

0.35 vCPU

Memory

Memória alocada à função.

512 MB

Disk

Espaço temporário em disco para a instância da função. Todos os diretórios permitem gravação e o espaço é compartilhado. Os dados são perdidos quando a instância é recuperada. Monte um sistema de arquivos NAS ou um bucket do OSS para persistir arquivos. O Function Compute oferece uma camada gratuita de 10 GB de espaço em disco.

512 MB

O faturamento de cada invocação é calculado multiplicando-se as especificações de recursos pela duração de uso. Para mais detalhes, consulte Visão geral do faturamento .

Política de dimensionamento

Parâmetro

Descrição

Exemplo

Minimum instances

Número mínimo de instâncias mantidas em execução. Defina como 1 ou mais para pré-aquecer instâncias e reduzir a latência de cold start em cargas de trabalho sensíveis a atrasos. Se nenhuma política elástica estiver configurada ou vigente, o mínimo efetivo será o valor definido aqui. Caso haja múltiplas políticas elásticas ativas, o Function Compute adotará o maior valor entre elas como mínimo efetivo. Para detalhes, veja Regras de dimensionamento de instâncias.

1

Código

Configure o ambiente de runtime e a source do código.

Parâmetro

Descrição

Exemplo

Runtime

Linguagem e versão para executar o código da função. Selecione Built-in Runtimes e escolha uma linguagem como Python, Java, PHP ou Node.js. Para criar uma função web, selecione Custom Runtime. Para funções aceleradas por gpu, escolha Custom Container. Consulte os runtimes disponíveis em Runtimes do Function Compute.

Built-in Runtimes

Code upload method

Método para fornecer o código da função. Opções: Use Sample Code (iniciador Hello World, editável posteriormente no console), Upload ZIP (pacote ZIP ou JAR apenas para runtime Java), Upload Folder ou OSS (especifique um bucket e um objeto).

Use Sample Code

Handler

Ponto de entrada que o Function Compute chama para processar requisições. Ao usar Use Sample Code, mantenha o padrão. Se fizer upload de código próprio, atualize este campo para corresponder à sua função handler. Um handler incorreto gera erros de execução.

index.handler

Execution timeout period

Tempo máximo permitido para uma única invocação. O padrão é 60 segundos; o limite máximo é 86.400 segundos.

60

Permissões, rede e armazenamento

Parâmetro

Descrição

Exemplo

Function role

Função do RAM que o Function Compute usa para gerar credenciais temporárias de acesso a outros serviços da Alibaba Cloud. Para instruções de configuração, consulte Conceder permissões ao Function Compute para acessar outros serviços da Alibaba Cloud.

mytestrole

Access to VPC

Ative esta opção para permitir que a função acesse recursos dentro de uma Virtual Private Cloud (VPC). Para detalhes de configuração, veja Configurar uma rede.

Enabled

VPC

Obrigatório quando Access to VPC está ativado. Selecione uma VPC existente ou crie uma nova.

fc.auto.create.vpc.1632317****

vSwitch

Necessário se Access to VPC estiver habilitado. Escolha um vSwitch existente ou crie um novo.

fc.auto.create.vswitch.vpc-bp1p8248****

Security group

Requerido ao ativar Access to VPC. Selecione um grupo de segurança existente ou crie um novo.

fc.auto.create.SecurityGroup.vsw-bp15ftbbbbd****

Allow default NIC to access internet

Controla se a função pode acessar a internet pela interface de rede padrão (NIC).

Enabled

Mount a NAS file system

Monte um sistema de arquivos NAS para compartilhar dados persistentemente entre funções, como arquivos de modelo usados por várias funções de inferência. Com a configuração automática, o sistema utiliza ou cria um sistema de arquivos NAS de uso geral chamado Alibaba-Fc-V3-Component-Generated. Para mais informações, consulte Configurar um sistema de arquivos NAS.

Enabled

Mount OSS

Monte um bucket do OSS para armazenar logs, arquivos de negócios e outros dados de forma persistente. Para detalhes, veja Configurar o object storage service (OSS).

Enabled

Importante

Ao utilizar um endereço ip público estático, desative a opção Allow default NIC to access internet. Caso contrário, o endereço ip público estático não entrará em vigor. Para mais detalhes, consulte Configurar um endereço ip público estático.

Logs e rastreamento

Parâmetro

Descrição

Exemplo

Logging

Persista logs de execução da função no Simple Log Service para depuração, análise de falhas e analytics de dados. A Automatic Configuration utiliza ou cria um projeto de log chamado serverless-<region_id> (um por região). A Custom Configuration permite especificar o Log Service Project e o Logstore. Para detalhes, consulte Configurar o recurso de logging.

Enabled

Mais configurações

Parâmetro

Descrição

Exemplo

Time zone

Fuso horário da função. Definir este parâmetro adiciona uma variável de ambiente TZ com o valor selecionado.

UTC

Tag

Tags para agrupar e gerenciar funções. Cada tag exige uma chave e um valor. Para mais informações, consulte Tags de função.

key : value

Resource group

Grupo de recursos ao qual a função pertence. Para detalhes, veja Grupos de recursos.

Default Resource Group

Environment variables

Pares chave-valor injetados no ambiente de execução da função, permitindo alterar seu comportamento sem modificar o código. Para detalhes, consulte Configurar variáveis de ambiente.

{"BUCKET_NAME": "MY_BUCKET", "TABLE_NAME": "MY_TABLE"}

Editar uma função

Na página Function Details, use a aba Code para modificar o código da função diretamente no console. Você também pode exportar o código como backup ou fazer upload de um novo código.

Se o painel esquerdo exibir alterações não confirmadas (indicadas por ①), clique em Deploy antes de clicar em Test Function para aplicar suas mudanças.

image

Para exportar ou fazer upload de código:

image

image

Para outras alterações de configuração, como especificações de instância e dimensionamento, consulte Especificações de instância de função e configurações elásticas.

Excluir uma função

  1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Function.

  2. Localize a função desejada e clique em Delete na coluna Actions.

  3. Na caixa de diálogo de confirmação, verifique se a função não possui recursos associados (como gatilhos ou políticas elásticas de instância mínima) e confirme a exclusão.

Obter o ARN de uma função

O Aliyun Resource Name (ARN) identifica exclusivamente um recurso da Alibaba Cloud e permite referenciar funções em códigos ou outros serviços.

  1. Faça login no console do Function Compute. No painel de navegação à esquerda, escolha Function Management > Function.

  2. Na barra de menus superior, selecione uma região. Clique na função de destino.

  3. Na página Function Details, clique em Copy ARN no lado direito.

image

Próximos passos

Referências