Invoca una función de Function Compute de forma síncrona o asíncrona. Pase una carga útil de evento en el cuerpo de la solicitud; Function Compute la reenvía al controlador de la función y devuelve el resultado o un identificador de invocación.
Para llamar a esta operación de manera interactiva y generar código de ejemplo del SDK, utilice OpenAPI Explorer .
Sintaxis de la solicitud
POST /services/{serviceName.qualifier}/functions/{functionName} HTTP/1.1Encabezados de la solicitud
Esta operación utiliza los encabezados de solicitud comunes, además de los encabezados específicos que se muestran a continuación.
|
Encabezado |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
X-Fc-Invocation-Type |
String |
No |
Sync |
El modo de invocación. Valores válidos: Sync (invocación síncrona) y Async (invocación asíncrona). |
|
X-Fc-Log-Type |
String |
No |
None |
Controla si se devuelven registros. Valores válidos: Tail (devuelve los últimos 4 KB de registros de la solicitud) y None (no se devuelven registros). Valor predeterminado: None. |
|
X-Fc-Stateful-Async-Invocation-Id |
String |
No |
g6u*iyvhd3jk8s6bhj0hh |
El identificador que se asigna a una tarea asíncrona. Requiere habilitar previamente la función de tareas asíncronas. Debe comenzar con una letra o un guion bajo ( |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Ubicación |
Obligatorio |
Ejemplo |
Descripción |
|
serviceName |
String |
Path |
Sí |
service_name |
El nombre del servicio. |
|
qualifier |
String |
Path |
No |
LATEST |
La versión o el alias del servicio. |
|
functionName |
String |
Path |
Sí |
function_name |
El nombre de la función. |
|
(body) |
String |
Body |
Sí |
{"key1": "value1"} |
La carga útil del evento. Function Compute pasa este arreglo binario al controlador de la función para su procesamiento. |
Elementos de la respuesta
|
Encabezado |
Tipo |
Ejemplo |
Descripción |
|
X-Fc-Error-Type |
String |
UnhandledInvocationError |
El tipo de error que se devuelve después de la invocación. Valores válidos: HandledInvocationError (errores que devuelve una devolución de llamada de Node.js) y UnhandledInvocationError (todos los demás errores). Para obtener más información, consulte Manejo de errores. |
|
X-Fc-Log-Result |
String |
demo log result |
La salida de registros de la invocación. Se devuelve cuando |
|
X-Fc-Code-Checksum |
String |
5697641582914695457 |
La suma de comprobación CRC-64 del paquete de código de la función. |
|
X-Fc-Stateful-Async-Invocation-Id |
String |
g6u*iyvhd3jk8s6bhj0hh |
El identificador de la tarea asíncrona. Longitud máxima: 128 caracteres. Function Compute genera un identificador si no se especificó uno en la solicitud. |
|
X-Fc-Instance-Id |
String |
7c43576b-48b1-4c3a-86e5-dcb01872**** |
El identificador de la instancia de la función que procesó la invocación. |
|
X-Fc-Request-Id |
String |
dab25e58-9356-4e3f-97d6-f044c4**** |
El identificador de la solicitud para esta invocación. |
|
X-Fc-Max-Memory-Usage |
String |
9.2 |
El pico de memoria consumida durante la ejecución de la función, en MB. |
|
X-Fc-Invocation-Duration |
String |
10 |
La duración de la ejecución de la función, en milisegundos. |
|
X-Fc-Invocation-Service-Version |
String |
LATEST |
La versión o el alias de la función invocada. |
|
(body) |
String |
hello world |
El valor que devuelve la función. Puede especificar el resultado que se devuelve. |
Ejemplos
Solicitud
POST /services/{serviceName.qualifier}/functions/function_name HTTP/1.1
Host: fc-ram.aliyuncs.com
X-Fc-Invocation-Type: Sync
X-Fc-Log-Type: None
X-Fc-Stateful-Async-Invocation-Id: g6u*****iyvhd3jk8s6bhj0hh
Content-Type: application/json
{"key1": "value1"}Respuesta
HTTP/1.1 200 OK
Content-Type: application/json
{
"result": "hello world"
}Códigos de error
Para ver la lista de códigos de error, consulte Códigos de error del servicio.