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/ Versiones y Alias/ Consulta de las versiones de una función

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

Ver PDF

Consulta de las versiones de una función

Función

Esta API se utiliza para consultar las versiones de una función.

URI

GET /v2/{project_id}/fgs/functions/{function_urn}/versions

**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
function_urn	Sí	String	URN de la función. Para obtener más información, consulte las descripciones del modelo de función. 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 a obtener en una solicitud. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Parámetros de solicitud

**Tabla 3** Parámetros de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es un token. Mínimo: 0 Máximo: 0 Mínimo: 0 Máximo: 0

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
versions	Array of ListFunctionVersionResult objects	Lista de versiones.
next_marker	Long	Siguiente lugar de registro.
count	Long	Número total de versiones.

**Tabla 5** ListFunctionVersionResult
Parámetro	Tipo	Descripción
func_urn	String	URN de la función.
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 (.). For example, for Node.js function myfunction.handler, the file name is myfunction.js, and the handler function is handler.
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.
last_modified	String	Hora en la que se actualizó por última vez la función.
func_vpc_id	String	ID de VPC.
concurrency	Integer	0: Una función está deshabilitada. -1: Una función está habilitada.
concurrent_num	Integer	Número de instancias simultáneas.
strategy_config	StrategyConfig object	Configuración de la política de función.
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.
long_time	Boolean	Si se admite la ejecución a largo plazo.
function_async_config	FunctionAsyncConfig object	Devuelve la estructura de la configuración de notificación de ejecución asincrónica.
type	String	Versión de función.
enable_cloud_debug	String	Si se debe habilitar la depuración basada en la nube.
enable_dynamic_memory	Boolean	Si se debe habilitar la asignación de memoria dinámica.
enterprise_project_id	String	ID de proyecto de empresa. Este parámetro es obligatorio si crea una función como usuario de empresa.
is_stateful_function	Boolean	Si se admiten funciones con estado. Si se admiten, establezca este parámetro en true. Este parámetro es compatible con FunctionGraph v2.
enable_auth_in_header	Boolean	Se permite o no la información de autenticación en el encabezado de solicitud.
custom_image	CustomImage object	-
reserved_instance_idle_mode	Boolean	Si se activa el modo inactivo para las instancias reservadas.

**Tabla 6** 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.

**Tabla 7** FunctionAsyncConfig
Parámetro	Tipo	Descripción
max_async_event_age_in_seconds	Integer	Período de validez máximo de un mensaje. Rango de valores: 60–86,400. Unidad: segundo.
max_async_retry_attempts	Integer	Número máximo de intentos de reintento si falla la invocación asincrónica. Valor predeterminado: 3. Rango de valores: 0–8.
destination_config	FuncAsyncDestinationConfig object	Objetivo de invocación asincrónica.
created_time	String	Hora en que se configuró la notificación de ejecución asincrónica.
last_modified	String	Hora en la que se modificó por última vez la configuración de notificación de ejecución asincrónica.

**Tabla 8** FuncAsyncDestinationConfig
Parámetro	Tipo	Descripción
on_success	FuncDestinationConfig object	Objetivo a ser invocado cuando una función se ejecuta con éxito.
on_failure	FuncDestinationConfig object	Objetivo a ser invocado cuando una función no puede ser ejecutada debido a un error del sistema o un error interno.

**Tabla 9** FuncDestinationConfig
Parámetro	Tipo	Descripción
destination	String	Tipo de objeto OBS SMN DIS FunctionGraph Valores de enumeración: OBS SMN DIS FunctionGraph
param	String	Parámetros (en formato JSON) correspondientes al servicio de destino. OBS: se incluyen los parámetros relacionados con el nombre del bucket, el prefijo del directorio de objetos y el tiempo de expiración del objeto. El tiempo de expiración del objeto oscila entre 0 y 365 días. Si el valor es 0, el objeto no caducará. SMN: Se incluye el parámetro topic_urn. DIS: Se incluye el parámetro stream_name. FunctionGraph Se incluye el parámetro func_urn.

**Tabla 10** CustomImage
Parámetro	Tipo	Descripción
enabled	Boolean	Si desea habilitar esta función.
image	String	Dirección de imagen.
command	String	Comando para iniciar una imagen de contenedor.
args	String	Parámetro de línea de comandos para iniciar una imagen de contenedor.
working_dir	String	Directorio de trabajo de un contenedor de imágenes.
uid	String	ID de usuario de un contenedor de imagen.
gid	String	ID de grupo de usuario de un contenedor de imagen.

Código de estado: 400

**Tabla 11** 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: 401

**Tabla 12** 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 13** 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 14** 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 15** 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.

GET https://{Endpoint}/v2/{project_id}/fgs/functions/{function_urn}/versions

Ejemplo de las respuestas

Código de estado: 200

Aceptar

{
  "versions" : [ {
    "func_urn" : "urn:fss:xxxxxxxxxxx:7aad83af3e8d42e99ac194e8419e2c9b:function:default:test",
    "func_name" : "test",
    "domain_id" : "14ee2e3501124efcbca7998baa24xxxx",
    "namespace" : "46b6f338fc3445b8846c71dfb1fbxxxx",
    "project_name" : "xxxxx",
    "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" : "faa825575c45437cddd4e369bea69893bcbe195d478178462ad90984fe72993f3f59d15f41c5373f807f3e05fb9af322c55dabeb16565c386e402413458e6068",
    "version" : "latest",
    "image_name" : "latest-191025153727@zehht",
    "last_modified_utc" : 1571989047,
    "last_modified" : "2019-10-25T15:37:27+08:00",
    "func_code" : { },
    "strategy_config" : {
      "concurrency" : 0
    }
  } ],
  "next_marker" : 5
}

Código de estado: 404

No se encontró ninguno.

{
  "error_code" : "FSS.1051",
  "error_msg" : "Not found the function"
}

Códigos de estado

Código de estado	Descripción
200	Aceptar
400	Solicitud incorrecta.
401	No autorizado.
403	Prohibido.
404	No se encontró ninguno.
500	Error de servidor interno.

Códigos de error

Consulte Códigos de error.

Tema principal: Versiones y Alias

Tema anterior: Modificación del alias de una versión de función

Tema siguiente: Publicación de una versión de función

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar