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.