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/ Importación y exportación de funciones/ Importación de una función
Actualización más reciente 2022-11-07 GMT+08:00
Ver PDF
Compartir

Importación de una función

Función

Esta API se utiliza para importar una función.

URI

POST /v2/{project_id}/fgs/functions/import

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

Parámetros de solicitud

Tabla 2 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

func_name

Sí

String

Nombre de la función.

file_name

Sí

String

Nombre de archivo.

file_type

Sí

String

Tipo de archivo.

file_code

Sí

String

Código de función. El código debe estar codificado usando Base64.

package

No

String

Nombre de la aplicación. El valor predeterminado es el predeterminado.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

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 (.).

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.

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.

version_description

String

Descripción de la versión.

last_modified

String

Hora en la que se actualizó por última vez la función.

func_vpc

FuncVpc object

Configuración de VPC.

depend_list

Array of strings

ID de dependencia.

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.
Tabla 4 FuncVpc

Parámetro

Tipo

Descripción

vpc_name

String

Nombre de la VPC.

vpc_id

String

ID de VPC.

subnet_name

String

Nombre de subred

subnet_id

String

ID de subred

cidr

String

Máscara de subred

gateway

String

Gateway.
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: 409

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: 500

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

Ejemplo de las solicitudes

Importar una función.

POST https://{Endpoint}/v2/{project_id}/fgs/functions/import

Ejemplo de las respuestas

Código de estado: 200

ok

{
  "func_urn" : "urn:fss:{region}:46b6f338fc3445b8846c71dfb1fbd9e8:function:default:test_v1_2",
  "func_name" : "test_v1_2",
  "domain_id" : "14ee2e35****a7998b******aa24cabf",
  "namespace" : "46b6f338fc3445b8846c71dfb1fbd9e8",
  "project_name" : "{region}",
  "package" : "default",
  "runtime" : "Node.js6.10",
  "timeout" : 3,
  "handler" : "index.handler",
  "memory_size" : 128,
  "cpu" : 300,
  "code_type" : "zip",
  "code_filename" : "index.zip",
  "code_size" : 6709,
  "digest" : "faa825575c45437cddd4e369bea69893bcbe195d478178462ad90984fe72993f3f59d15f41c5373f807f3e05fb9af322c55dabeb16565c386e402413458e6068",
  "version" : "latest",
  "image_name" : "latest-191025153727@zehht",
  "last_modified" : "2019-10-25T15:37:27+08:00",
  "strategy_config" : {
    "concurrency" : -1
  },
  "enterprise_project_id" : "46b6f338fc3445b8846c71dfb1fbxxxx"
}

Código de estado: 409

Conflict

{
  "error_code" : "FSS.1061",
  "error_msg" : "The function has existed"
}

Códigos de estado

Código de estado

Descripción

200

Aceptar

409

Conflicto

500

Error de servidor interno.

Códigos de error

Consulte Códigos de error.