Function Compute:Descripción general de los disparadores HTTP

Funcionamiento

Un disparador HTTP expone su función como un endpoint HTTP. Cuando llega una solicitud, Function Compute la autentica (si se configuró), la pasa a su función y devuelve la respuesta HTTP al llamador.

Métodos HTTP compatibles: GET, POST, PUT, DELETE, HEAD, PATCH y OPTIONS.

Ejemplo de un controlador mínimo para una función web en Node.js:

exports.handler = (event, context, callback) => {
  const request = JSON.parse(event);
  const response = {
    statusCode: 200,
    headers: { 'Content-Type': 'text/plain' },
    body: 'Hello from Function Compute'
  };
  callback(null, response);
};

El objeto event contiene la solicitud HTTP completa (ruta, encabezados, cuerpo y método). Para enviar una respuesta HTTP, devuelva un objeto con statusCode, headers y body.

Notas de uso

Antes de desarrollar con disparadores HTTP, tenga en cuenta los siguientes comportamientos.

Riesgo de acceso anónimo

Si establece Authentication Method en No Authentication, cualquier persona que conozca la URL del endpoint podrá invocar su función. Para aplicar una autorización personalizada, valide el encabezado Authorization dentro del código de su función. Para obtener más detalles, consulte Configure signature-based authentication for HTTP triggers.

Restricción para descargar archivos APK

A partir del 10 de junio de 2024, los nuevos disparadores HTTP bloquean las descargas de archivos APK (tipo MIME application/vnd.android.package-archive) a través de endpoints de red pública. Estas solicitudes devuelven el código de estado HTTP 400. Para obtener más detalles, consulte How to ensure your HTTP trigger's public endpoint returns .apk files correctly.

Rotación de VIP

Function Compute rota periódicamente las direcciones IP virtuales (VIP) asociadas a los endpoints públicos y privados. Codificar las VIP de forma fija provoca interrupciones del servicio y no está cubierto por el acuerdo de nivel de servicio (SLA) de Function Compute. Utilice un nombre de dominio personalizado con configuración CNAME para garantizar un acceso estable. Para obtener más detalles, consulte Configure a custom domain name.

Comportamiento del dominio predeterminado y del adjunto

Cuando utiliza el dominio predeterminado aliyuncs.com, Function Compute añade content-disposition: attachment a todas las respuestas. Esto obliga a los navegadores a descargar las respuestas como archivos en lugar de mostrarlas. Configure un nombre de dominio personalizado para eliminar este comportamiento.

Límites

Métodos de invocación

Autenticación y autorización

Los llamadores externos deben superar las comprobaciones de autenticación de Function Compute antes de acceder a su función mediante un disparador HTTP. Métodos compatibles:

• Signature-based authentication

• Autenticación básica

• Autenticación JWT

• Bearer authentication

Intercambio de recursos de origen cruzado (CORS)

Function Compute admite tres formas de gestionar las solicitudes de intercambio de recursos de origen cruzado (CORS), cada una con distintas ventajas en cuanto a costo, complejidad y flexibilidad.

exports.handler = (event, context, callback) => {
  const method = JSON.parse(event).requestContext.http.method;
  if (method === 'OPTIONS') {
    const fcResponse = {
      statusCode: 204,
      headers: {
        'Access-Control-Allow-Origin': 'http://www.fc.com',
        'Access-Control-Allow-Methods': 'POST',
        'Access-Control-Allow-Headers': 'Content-Type, Authorization',
        'Access-Control-Max-Age': '3600'
      },
      body: ''
    };
    callback(null, fcResponse);
  } else {
    callback(null, {
      statusCode: 200,
      body: 'hello world'
    });
  }
};

import json

def handler(event, context):
    evt = json.loads(event)
    method = evt.get('requestContext', {}).get('http', {}).get('method', '')
    if method == 'OPTIONS':
        return {
            'statusCode': 204,
            'headers': {
                'Access-Control-Allow-Origin': 'http://www.fc.com',
                'Access-Control-Allow-Methods': 'POST',
                'Access-Control-Allow-Headers': 'Content-Type, Authorization',
                'Access-Control-Max-Age': '3600'
            },
            'body': ''
        }
    return {
        'statusCode': 200,
        'body': 'hello world'
    }

package main

import (
    "context"
    "encoding/json"
)

type HttpRequest struct {
    RequestContext struct {
        Http struct {
            Method string `json:"method"`
        } `json:"http"`
    } `json:"requestContext"`
}

type HttpResponse struct {
    StatusCode int               `json:"statusCode"`
    Headers    map[string]string `json:"headers"`
    Body       string            `json:"body"`
}

func Handler(ctx context.Context, event []byte) (*HttpResponse, error) {
    var req HttpRequest
    if err := json.Unmarshal(event, &req); err != nil {
        return nil, err
    }
    if req.RequestContext.Http.Method == "OPTIONS" {
        return &HttpResponse{
            StatusCode: 204,
            Headers: map[string]string{
                "Access-Control-Allow-Origin":  "http://www.fc.com",
                "Access-Control-Allow-Methods": "POST",
                "Access-Control-Allow-Headers": "Content-Type, Authorization",
                "Access-Control-Max-Age":       "3600",
            },
            Body: "",
        }, nil
    }
    return &HttpResponse{StatusCode: 200, Body: "hello world"}, nil
}

Disparador HTTP frente a disparador de API Gateway

Tanto los disparadores HTTP como los de API Gateway permiten crear aplicaciones web.

Los disparadores HTTP ofrecen estas ventajas sobre los de API Gateway:

• Son más rápidos de configurar y más fáciles de depurar, ya que no requieren configuración adicional de la puerta de enlace.

• Eliminan la sobrecarga de codificación y decodificación JSON, pues transmiten las solicitudes y respuestas directamente.

• Son compatibles con las herramientas estándar de pruebas HTTP.

• Se integran fácilmente con servicios que admiten webhooks, como la recuperación de origen de CDN y Simple Message Queue (antes MNS).

Preguntas frecuentes

¿Por qué falla la llamada a mi API después de agregar OPTIONS a allowMethods?

No agregue OPTIONS a corsConfig.allowMethods. La puerta de enlace gestiona automáticamente todas las solicitudes preflight. Incluir OPTIONS de forma manual genera errores en el procesamiento de las solicitudes.

Después de configurar el CORS por API, las solicitudes OPTIONS devuelven 200 en lugar de 204. ¿Por qué?

Confirme que su cuenta tiene acceso a la vista previa por invitación. Si el plugin de la puerta de enlace no está completamente activado, esta recurre al comportamiento predeterminado de CORS, el cual devuelve 200 y reenvía la solicitud a su función.

**¿Puedo usar comodines de subdominio en allowOrigins, por ejemplo *.example.com?**

No. No se admiten comodines de subdominio. Enumere de forma explícita todos los dominios necesarios en el arreglo allowOrigins, o use https://* para coincidir de manera amplia con orígenes HTTPS.

El código de mi función también establece encabezados CORS. ¿Habrá conflictos?

No. Los encabezados generados por la puerta de enlace y los devueltos por la función se combinan. Si existen duplicados, los navegadores utilizan el primer valor válido. Las aplicaciones existentes seguirán funcionando durante la migración.