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.