Execução síncrona de uma função
Função
Esta API é usada para executar uma função de forma síncrona. Os clientes devem esperar por respostas explícitas às suas solicitações da função. As respostas são retornadas somente após a conclusão da invocação da função.
URI
POST /v2/{project_id}/fgs/functions/{function_urn}/invocations
| 
        Parâmetro  | 
      
        Obrigatório  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        Sim  | 
      
        String  | 
      
        ID do projeto.  | 
     
| 
        function_urn  | 
      
        Sim  | 
      
        String  | 
      
        o URN da função. Para obter detalhes, consulte as descrições do modelo de função.  | 
     
Parâmetros de solicitação
| 
        Parâmetro  | 
      
        Obrigatório  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|---|
| 
        X-Auth-Token  | 
      
        Sim  | 
      
        String  | 
      
        Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token.  | 
     
| 
        X-Cff-Log-Type  | 
      
        Não  | 
      
        String  | 
      
        Opções: tail (4 KB logs serão retornados) e null (nenhum log será retornado).  | 
     
| 
        X-CFF-Request-Version  | 
      
        Não  | 
      
        String  | 
      
        Formato do corpo de resposta. Opções: v0 e v1. 
  | 
     
| 
        Parâmetro  | 
      
        Obrigatório  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|---|
| 
        {User defined key}  | 
      
        Sim  | 
      
        Object  | 
      
        Corpo de solicitação para execução de uma função.  | 
     
Parâmetros de resposta
Código de estado: 200
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        X-Cff-Invoke-Summary  | 
      
        String  | 
      
        -  | 
     
| 
        X-Cff-Request-Id  | 
      
        String  | 
      
        -  | 
     
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        request_id  | 
      
        String  | 
      
        ID de solicitação.  | 
     
| 
        result  | 
      
        String  | 
      
        Resultado da execução da função.  | 
     
| 
        log  | 
      
        String  | 
      
        Log de execução da função.  | 
     
| 
        status  | 
      
        Integer  | 
      
        Status de execução da função.  | 
     
Código de estado: 400
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de erro.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensagem de erro.  | 
     
Código de estado: 401
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de erro.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensagem de erro.  | 
     
Código de estado: 403
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de erro.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensagem de erro.  | 
     
Código de estado: 404
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de erro.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensagem de erro.  | 
     
Código de estado: 500
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de erro.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensagem de erro.  | 
     
Código de estado: 503
| 
        Parâmetro  | 
      
        Tipo  | 
      
        Descrição  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Código de erro.  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Mensagem de erro.  | 
     
Exemplos de solicitações
Executar uma função de forma síncrona.
POST /v2/{project_id}/fgs/functions/{function_urn}/invocations { "k" : "v" }
 Exemplo de respostas
Código de estado: 200
OK
{ "result" : "{\"statusCode\": 200, \"isBase64Encoded\": false, \"body\": \"{\\\"key\\\": \\\"value\\\"}\", \"headers\": {\"Content-Type\": \"application/json\"}}", "log" : "2022-09-20T11:43:57Z Start invoke request '1cbe80f3-3c65-475e-ad88-76ac518d386a', version: v1\nHello, World!\n\n2022-09-20T11:43:58Z Finish invoke request '1cbe80f3-3c65-475e-ad88-76ac518d386a', duration: 65.828ms, billing duration: 66ms, memory used: 21.473MB, billing memory: 128MB", "status" : 200, "request_id" : "1cbe80f3-3c65-475e-ad88-76ac518d386x", "error_code" : "" }
 Códigos de status
| 
        Código de status  | 
      
        Descrição  | 
     
|---|---|
| 
        200  | 
      
        OK  | 
     
| 
        400  | 
      
        Solicitação inválida.  | 
     
| 
        401  | 
      
        Não autorizado.  | 
     
| 
        403  | 
      
        Proibido.  | 
     
| 
        404  | 
      
        Não encontrado.  | 
     
| 
        500  | 
      
        Erro de servidor interno.  | 
     
| 
        503  | 
      
        Serviço indisponível.  | 
     
Códigos de erro
Consulte Códigos de erro.