InvokeFunction - : Central de Documentação do Alibaba Cloud

Invoca uma função do Function Compute de forma síncrona ou assíncrona. Passe um payload de evento no corpo da requisição; o Function Compute o encaminha ao handler da função e retorna o resultado ou um ID de invocação.

Para chamar esta operação interativamente e gerar código de exemplo do SDK, use o OpenAPI Explorer .

Sintaxe da requisição

POST /services/{serviceName.qualifier}/functions/{functionName} HTTP/1.1

Cabeçalhos da requisição

Esta operação utiliza os cabeçalhos de requisição comuns, além dos cabeçalhos específicos listados a seguir.

Cabeçalho	Tipo	Obrigatório	Exemplo	Descrição
X-Fc-Invocation-Type	String	Não	Sync	Modo de invocação. Valores válidos: Sync (invocação síncrona) e Async (invocação assíncrona).
X-Fc-Log-Type	String	Não	None	Controla se os logs são retornados. Valores válidos: Tail (retorna os últimos 4 KB de logs da requisição) e None (nenhum log retornado). Padrão: None.
X-Fc-Stateful-Async-Invocation-Id	String	Não	g6u*iyvhd3jk8s6bhj0hh	ID a ser atribuído a uma tarefa assíncrona. Requer que o recurso de tarefas assíncronas esteja ativado previamente. O ID deve começar com letra ou sublinhado (`_`) e pode conter letras, dígitos, sublinhados (`_`) e hifens (`-`). Comprimento máximo: 128 caracteres. Se não especificado, o Function Compute gera um ID automaticamente. Defina um ID significativo para o negócio (por exemplo, o nome do arquivo de vídeo em uma função de processamento de vídeo) para facilitar a verificação do status ou o cancelamento posterior da tarefa.

Parâmetros da requisição

Parâmetro	Tipo	Localização	Obrigatório	Exemplo	Descrição
serviceName	String	Path	Sim	service_name	Nome do serviço.
qualifier	String	Path	Não	LATEST	Versão ou alias do serviço.
functionName	String	Path	Sim	function_name	Nome da função.
(body)	String	Body	Sim	{"key1": "value1"}	Payload do evento. O Function Compute passa este array binário ao handler da função para processamento.

Elementos da resposta

Cabeçalho	Tipo	Exemplo	Descrição
X-Fc-Error-Type	String	UnhandledInvocationError	Tipo de erro retornado após a invocação. Valores válidos: HandledInvocationError (erros retornados por callback Node.js) e UnhandledInvocationError (todos os outros erros). Para mais detalhes, consulte Tratamento de erros.
X-Fc-Log-Result	String	demo log result	Saída de log da invocação, retornada quando `X-Fc-Log-Type` está definido como `Tail`.
X-Fc-Code-Checksum	String	5697641582914695457	Checksum CRC-64 do pacote de código da função.
X-Fc-Stateful-Async-Invocation-Id	String	g6u*iyvhd3jk8s6bhj0hh	ID da tarefa assíncrona. Comprimento máximo: 128 caracteres. O Function Compute gera um ID caso nenhum tenha sido especificado na requisição.
X-Fc-Instance-Id	String	7c43576b-48b1-4c3a-86e5-dcb01872****	ID da instância da função que processou a invocação.
X-Fc-Request-Id	String	dab25e58-9356-4e3f-97d6-f044c4****	ID da requisição desta invocação.
X-Fc-Max-Memory-Usage	String	9,2	Pico de memória consumida durante a execução da função, em MB.
X-Fc-Invocation-Duration	String	10	Duração da execução da função, em milissegundos.
X-Fc-Invocation-Service-Version	String	LATEST	Versão ou alias da função invocada.
(body)	String	hello world	Valor de retorno da função. Você pode especificar o resultado retornado.

Exemplos

Requisição

POST /services/{serviceName.qualifier}/functions/function_name HTTP/1.1
Host: fc-ram.aliyuncs.com
X-Fc-Invocation-Type: Sync
X-Fc-Log-Type: None
X-Fc-Stateful-Async-Invocation-Id: g6u*****iyvhd3jk8s6bhj0hh
Content-Type: application/json

{"key1": "value1"}

Resposta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "result": "hello world"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.