Consulta de funções
Função
Esta API é usada para consultar todas as funções.
URI
GET /v2/{project_id}/fgs/functions
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
marker |
Não |
String |
Registro final consultado da última vez. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
maxitems |
Não |
String |
Número máximo de funções que podem ser consultadas a cada vez. Valor máximo: 400. Se este parâmetro não estiver definido ou for 0 ou maior que 400, o valor padrão 400 será usado. Se este parâmetro for menor que 0, é devolvida uma mensagem indicando erro de parâmetro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
package_name |
Não |
String |
Nome do aplicativo. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. |
Parâmetros de resposta
Código de estado: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
Características |
Array of ListFunctionResult objects |
Lista de funções. |
next_marker |
Integer |
Próxima leitura localização. |
count |
Long |
Número total de funções que correspondem às condições de consulta. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
func_urn |
String |
o URN da função. |
func_name |
String |
Nome da função. |
domain_id |
String |
ID do domínio. |
namespace |
String |
ID do projeto. |
project_name |
String |
Nome do projeto. |
package |
String |
Grupo ao qual a função pertence. Este campo é definido para agrupar funções. |
runtime |
String |
Ambiente para execução de uma função. Opções:
Valores de enumeração:
|
timeout |
Integer |
Duração máxima que a função pode ser executada. Faixa de valor: 3s–900s. O valor pode ser de até 12 horas para usuários na lista de permissões. Para obter detalhes, entre em contato com o pessoal do FunctionGraph. |
handler |
String |
Manipulador de uma função no formato "xx.xx". Deve conter um ponto (.). Por exemplo, para a função myfunction.handler do Node.js, o nome do arquivo é myfunction.js, e a função do manipulador é handler. |
memory_size |
Integer |
Memória consumida por uma função. Unidade: MB. O valor pode ser 128, 256, 512, 768, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584 ou 4096. O valor varia de 128 a 4096. |
cpu |
Integer |
Recursos de CPU de uma função. Unidade: millicore (1 núcleo = 1000 millicores). O valor deste campo é proporcional ao de MemorySize. Por padrão, são necessários 100 millicores de CPU para 128 MB de memória. O valor é calculado da seguinte forma: Memória/128 x 100 + 200 (millicores básicos da CPU) |
code_type |
String |
Tipo de código da função. Opções:
Valores de enumeração:
|
code_url |
String |
Se CodeType estiver definido como obs, insira a URL OBS do pacote de código de função. Se CodeType não estiver definido como obs, deixe este parâmetro em branco. |
code_filename |
String |
Nome de um arquivo de função. Este parâmetro é obrigatório somente quando CodeType é definido como jar ou zip. |
code_size |
Long |
Tamanho do código em bytes. |
user_data |
String |
Informações de nome/valor definidas para a função. Estes são parâmetros usados em uma função. Por exemplo, se uma função precisa acessar um host, defina Host={host_ip}. Você pode definir um máximo de 20 desses parâmetros, e seu comprimento total não pode exceder 4 KB. |
encrypted_user_data |
String |
Nome/valor definido pelo usuário a ser criptografado. |
digest |
String |
O valor de hash SHA512 do código da função, que é usado para determinar se a função foi alterada. |
version |
String |
Versão da função, que é gerada automaticamente pelo sistema. O nome da versão está no formato "vAAAAMMDD-HHMMSS" (v+ano/mês/dia-hora/minuto/segundo). |
image_name |
String |
Identificador interno de uma versão de função. |
xrole |
String |
Agência utilizada pela função. Você precisa criar uma agência no console do IAM. Este campo é obrigatório quando uma função precisa acessar outros serviços. |
app_xrole |
String |
Agência usada pelo aplicativo da função. Você precisa criar uma agência no console do IAM. Este campo é obrigatório quando uma função precisa acessar outros serviços. |
description |
String |
Descrição da Função. |
last_modified |
String |
Hora em que a função foi atualizada pela última vez. |
func_vpc_id |
String |
ID correspondente à tabela tbl_func_vpc. |
strategy_config |
StrategyConfig object |
Configuração da política de função. |
extend_config |
String |
Configuração estendida. |
initializer_handler |
String |
Inicializador da função. Está no formato "xx.xx" e deve conter um ponto (.). Por exemplo, para a função myfunction.initializer do Node.js, o nome do arquivo é myfunction.js, e a função de inicialização é inicializador. |
initializer_timeout |
Integer |
Duração máxima que a função pode ser inicializada. Faixa de valor: 1s–300s. |
enterprise_project_id |
String |
ID do projeto empresarial. Este parâmetro é obrigatório se você criar uma função como um usuário enterprise. |
long_time |
Boolean |
Se permitir um tempo limite longo. |
log_group_id |
String |
ID do grupo de log. |
log_stream_id |
String |
ID do fluxo de log. |
type |
String |
v2 indica a versão OBT e v1 indica a versão original. Valores de enumeração:
|
fail_count |
Integer |
Número de vezes que uma função falhou em ser executada no último dia. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
concurrency |
Integer |
Número máximo de instâncias para uma única função. Para v1, o valor pode ser 0 ou –1; para v2, varia de –1 a 1000. |
concurrent_num |
Integer |
Número máximo de solicitações simultâneas para uma única instância. Este parâmetro é suportado apenas pela v2. O valor varia de –1 a 200.000. |
Código de estado: 401
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
error_msg |
String |
Mensagem de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
Código de estado: 403
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
error_msg |
String |
Mensagem de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
Código de estado: 404
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
error_msg |
String |
Mensagem de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
Código de estado: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
error_msg |
String |
Mensagem de erro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0 |
Exemplos de solicitações
Funções de consulta do inquilino atual.
GET https://{Endpoint}/v2/{project_id}/fgs/functions?marker=0&maxitems=400
Exemplo de respostas
Código de estado: 200
ok
{ "functions" : [ { "func_urn" : "urn:fss:xxxxxxxxx:7aad83af3e8d42e99ac194e8419e2c9b:function:default:test", "func_name" : "test", "domain_id" : "cff01_hk", "namespace" : "7aad83af3e8d42e99ac194e8419e2c9b", "project_name" : "xxxxxxxx", "package" : "default", "runtime" : "Node.js6.10", "timeout" : 3, "handler" : "test.handler", "memory_size" : 128, "cpu" : 300, "code_type" : "inline", "code_filename" : "index.js", "code_size" : 272, "digest" : "decbce6939297b0b5ec6d1a23bf9c725870f5e69fc338a89a6a4029264688dc26338f56d08b6535de47f15ad538e22ca66613b9a46f807d50b687bb53fded1c6", "version" : "latest", "xrole" : "cff", "image_name" : "latest-191025153727@zehht", "last_modified" : "2019-10-25T15:37:27+08:00", "strategy_config" : { "concurrency" : 0 }, "initializer_handler" : "index.initializer", "initializer_timeout" : 3, "fail_count" : 12 } ], "next_marker" : 4 }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
ok |
401 |
Não autorizado. |
403 |
Proibido. |
404 |
Não encontrado. |
500 |
Erro de servidor interno. |
Códigos de erro
Consulte Códigos de erro.