Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ FunctionGraph/ Referencia de la API/ Las API/ Gestión del ciclo de vida de la función/ Consulta de funciones

Actualización más reciente 2022-11-07 GMT+08:00

Ver PDF

Consulta de funciones

Función

Esta API se utiliza para consultar todas las funciones.

URI

GET /v2/{project_id}/fgs/functions

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
marker	No	String	Registro final consultado la última vez. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
maxitems	No	String	Número máximo de funciones que se pueden consultar cada vez. Valor máximo: 400. Si este parámetro no se establece o es 0 o mayor que 400, se usa el valor por defecto 400. Si este parámetro es menor que 0, se devuelve un mensaje que indica un error de parámetro. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
package_name	No	String	Nombre de la aplicación. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Parámetros de solicitud

No hay

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
Funciones	Array of ListFunctionResult objects	Lista de funciones.
next_marker	Integer	Ubicación de la lectura siguiente.
count	Long	Número total de funciones que coinciden con las condiciones de consulta.

**Tabla 4** ListFunctionResult
Parámetro	Tipo	Descripción
func_urn	String	Función URN.
func_name	String	Nombre de la función.
domain_id	String	ID de dominio.
namespace	String	ID del proyecto
project_name	String	Nombre del proyecto.
package	String	Grupo al que pertenece la función. Este campo se define para agrupar las funciones.
runtime	String	Entorno para ejecutar una función. Opciones: Python2.7 Python3.6 Python3.9 Go1.8 Go1.x Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) Custom PHP7.3 Valores de enumeración: Java8 Java11 Node.js6.10 Node.js8.10 Node.js10.16 Node.js12.13 Node.js14.18 Python2.7 Python3.6 Go1.8 Go1.x C#(.NET Core 2.0) C#(.NET Core 2.1) C#(.NET Core 3.1) PHP7.3 Python3.9
timeout	Integer	Duración máxima de la función puede ser ejecutada. Rango de valores: 3s–900s. El valor puede ser de hasta 12 horas para los usuarios de la lista blanca. Para obtener más información, comuníquese con el personal de FunctionGraph.
handler	String	Manejador de una función en el formato de "xx.xx". Debe contener un período (.). Por ejemplo, para la función de Node.js myfunction.handler, el nombre del archivo es myfunction.js, y la función de manejador es manejador.
memory_size	Integer	Memoria consumida por una función. Unidad: MB. El valor puede ser 128, 256, 512, 768, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584 o 4096. El valor oscila entre 128 y 4096.
cpu	Integer	Recursos de CPU de una función. Unidad: milicore (1 núcleo = 1000 millicores). El valor de este campo es proporcional al de "MemorySize". De forma predeterminada, se requieren 100 millicores de CPU para 128 MB de memoria. El valor se calcula de la siguiente manera: Memoria/128 x 100 + 200 (millicores básicos de CPU)
code_type	String	Tipo de código de función. Opciones: inline: código en línea. zip: archivo ZIP. obs: código de función almacenado en un bucket OBS. jar: archivo JAR, para funciones Java. Valores de enumeración: inline zip obs jar
code_url	String	Si CodeType está establecido en obs, introduzca la URL OBS del paquete de código de función. Si CodeType no está establecido en obs, deje este parámetro en blanco.
code_filename	String	Nombre de un archivo de función. Este parámetro solo es obligatorio cuando CodeType se establece en jar o zip.
code_size	Long	Tamaño del código en bytes.
user_data	String	Información de Nombre/Valor definida para la función. Estos son parámetros usados en una función. Por ejemplo, si una función necesita acceder a un host, defina Host={host_ip}. Puede definir un máximo de 20 parámetros de este tipo y su longitud total no puede superar los 4 KB.
encrypted_user_data	String	Nombre/valor definido por el usuario que se va a cifrar.
digest	String	Valor hash SHA512 del código de función, que se usa para determinar si la función ha cambiado.
version	String	Versión de la función, que es generada automáticamente por el sistema. El nombre de la versión tiene el formato "vYYYYMMDD-HHMMSS" (v+año/mes/día-hora/minuto/segundo).
image_name	String	Identificador interno de una versión de función.
xrole	String	Agencia utilizada por la función. Es necesario crear una delegación en la consola IAM. Este campo es obligatorio cuando una función necesita acceder a otros servicios.
app_xrole	String	Agencia utilizada por la aplicación de función. Es necesario crear una delegación en la consola IAM. Este campo es obligatorio cuando una función necesita acceder a otros servicios.
description	String	Descripción de la función.
last_modified	String	Hora en la que se actualizó por última vez la función.
func_vpc_id	String	ID correspondiente a la tabla tbl_func_vpc.
strategy_config	StrategyConfig object	Configuración de la política de función.
extend_config	String	Configuración extendida.
initializer_handler	String	Inicializador de la función. Está en el formato de "xx.xx" y debe contener un punto (.). Por ejemplo, para la función Node.js myfunction.initializer, el nombre del archivo es myfunction.js, y la función de inicialización es inicializador.
initializer_timeout	Integer	Duración máxima de la función puede ser inicializada. Rango de valores: 1s–300s.
enterprise_project_id	String	ID de proyecto de empresa. Este parámetro es obligatorio si crea una función como usuario de empresa.
long_time	Boolean	Ya sea para permitir un tiempo de espera largo.
log_group_id	String	ID de grupo de registro.
log_stream_id	String	ID de flujo de registro.
type	String	v2 indica la versión OBT y v1 indica la versión original. Valores de enumeración: v1 v2
fail_count	Integer	Número de veces que una función no se pudo ejecutar en el último día.

**Tabla 5** StrategyConfig
Parámetro	Tipo	Descripción
concurrency	Integer	Número máximo de instancias para una sola función. Para v1, el valor puede ser 0 o –1; para v2, varía de –1 a 1000.
concurrent_num	Integer	Número máximo de solicitudes simultáneas para una sola instancia. Este parámetro solo es compatible con v2. El valor oscila entre –1 y 200,000.

Código de estado: 401

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensaje de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Código de estado: 403

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensaje de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Código de estado: 404

**Tabla 8** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensaje de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Código de estado: 500

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0
error_msg	String	Mensaje de error. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Ejemplo de las solicitudes

Funciones de consulta del inquilino actual.

GET https://{Endpoint}/v2/{project_id}/fgs/functions?marker=0&maxitems=400

Ejemplo de las respuestas

Código de estado: 200

{
  "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_utc" : 1571989047,
    "last_modified" : "2019-10-25T15:37:27+08:00",
    "func_code" : { },
    "strategy_config" : {
      "concurrency" : 0
    },
    "initializer_handler" : "index.initializer",
    "initializer_timeout" : 3,
    "fail_count" : 12
  } ],
  "next_marker" : 4
}