Descripción general de las funciones técnicas de Apigee

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

En este tema se resumen las características de Apigee y se comparan las características y las funciones de Apigee y Apigee Hybrid.

En la siguiente tabla se enumeran los productos de gestión de APIs de Apigee que se comparan en este tema:

Producto Dónde se aloja Gestionado por
Apigee Google Cloud Apigee
Apigee hybrid Tanto Google Cloud como el centro de datos privado del cliente Apigee gestiona el plano de gestión y el cliente gestiona el plano del entorno de ejecución.

Resumen de las funciones de Apigee

En la siguiente tabla se ofrece un resumen de las funciones de Apigee (y de la versión híbrida).

Función Compatibilidad con Apigee y Hybrid
Revisiones de proxy de API

Inmutable cuando se implementa
Adaptador de Apigee para Istio Obsoleto: te recomendamos que utilices Apigee Adapter for Envoy en su lugar.
Organización de aplicaciones Organiza las aplicaciones mediante AppGroups o asociaciones de aplicaciones de desarrollador. Consulta el artículo sobre organizar la propiedad de aplicaciones cliente.
Implementaciones
  • Despliegues asíncronos
  • La obtención del estado de la implementación se basa en la última vez que el plano del entorno de ejecución se ha registrado en el plano de gestión.
Entornos
  • Compatibilidad con grupos de entornos
  • Autoservicio a través de la interfaz de usuario y las APIs de Apigee
  • Flexibilidad en la topología de servicio
  • Un pod de MP solo puede servir un entorno

Para obtener más información, consulta Acerca de los entornos y los grupos de entornos.
Compatibilidad con proxies basados en gRPC

Procesa solicitudes de API de protocolo gRPC unarias a un servidor de destino gRPC. Consulta Crear proxies de API gRPC.
Uso de mayúsculas y minúsculas en el nombre del campo de encabezado HTTP/1.1

Convierte los nombres de los campos de encabezado HTTP/1.1 a minúsculas cuando se reenvían al backend. Este comportamiento puede afectar a las aplicaciones que esperan que se conserve el uso de mayúsculas y minúsculas.

Almacenes de claves y de confianza
  • Gestión de la comunicación hacia el norte como secretos de Kubernetes
KVMs
  • Puedes crear KVMs cifradas y específicas de un entorno en la interfaz de usuario de Apigee. Los KVMs siempre están cifrados. No puedes añadir, actualizar ni ver entradas de KVM en la interfaz de usuario.
  • Usa el atributo private. con todas las variables al acceder a un KVM con el comando GET para ocultar la información del KVM en una sesión de depuración (Trace). Si no se usa el atributo private., la KVM se seguirá cifrando. Sin embargo, la información de la KVM aparecerá descifrada en la sesión de depuración (Trace) y no se generará ninguna excepción.
  • Puedes gestionar las entradas de KVM con la API keyvaluemaps.entries o con la política KeyValueMapOperations.
  • Puede usar conjuntos de propiedades para algunos de los mismos casos prácticos que los pares clave-valor. Consulta Usar conjuntos de propiedades.
  • El elemento <MapName> permite que la política KeyValueMapOperations identifique qué KVM se debe usar de forma dinámica en el tiempo de ejecución.

Para obtener más información sobre cómo crear mapas de clave-valor en la interfaz de usuario, consulta el artículo Usar mapas de clave-valor. Consulta también Acceder a datos de configuración para obtener información sobre cómo elegir el mecanismo de persistencia de datos adecuado.
Monetización Se admite en Apigee y Apigee Hybrid. Consulta las funciones en el resumen de monetización.
Node.js
  • No se admiten los proxies de API de Node.js.
  • Apigee recomienda alojar las aplicaciones Node.js como contenedores independientes en Kubernetes (en el mismo clúster o en otro).
OAuth La nueva política RevokeOAuthv2 revoca por ID de usuario final, ID de aplicación o ambos.
Políticas Consulta la vista general de las políticas.
Resources No se pueden usar recursos a nivel de organización
Roles y permisos
  • Gestionadas a través del servicio IAM de la consola de Google Cloud
  • Hay algunos roles predefinidos disponibles
  • Puedes crear roles personalizados que incluyan otros permisos de Google Cloud.

Para obtener más información, consulta el artículo Usuarios y roles.
Servicios SOAP en el asistente para crear un proxy No es compatible. Consulta wsdl2apigee, un proyecto de código abierto que proporciona utilidades SOAP para usar con Apigee.
Sesiones de rastreo o depuración Consulta Seguimiento.
Anfitriones virtuales

Para el modelo híbrido:

  • El ingreso se implementa a través de Anthos Service Mesh.
  • Las claves y los certificados se implementan directamente en Kubernetes.

En el caso de Apigee:

  • Cada instancia expone un endpoint HTTPS a través de un certificado autofirmado. La CA del certificado se puede descargar consultando la organización.

Compatibilidad con rastreo y depuración

En la siguiente tabla se muestra la compatibilidad con Trace de Apigee y de Apigee hybrid:

Función Compatibilidad con Apigee y la opción híbrida
Puntualidad Retraso leve; asíncrono
Nombre o ID de la sesión No acepta el nombre de la sesión del usuario
Filtros Admite lógica de filtrado compleja, incluidas las operaciones lógicas AND y OR. Acceso a cualquier variable de flujo mencionada en la referencia de variables de flujo. La sintaxis es la misma que se usa con las condicionales, tal como se muestra en la referencia de condiciones.
Tiempo de espera de la sesión

Define solo la duración de la sesión de depuración. El punto de partida es cuando el procesador de mensajes recibe la solicitud de ejecutarse en modo de depuración.

El valor predeterminado es de 5 minutos si la sesión se ha iniciado con la API y de 10 minutos si se ha iniciado en la interfaz de usuario.

Los datos se conservan durante 24 horas antes de que la aplicación híbrida los elimine automáticamente.
Validez de la sesión Periodo durante el que es válida la solicitud de creación de la sesión. Si la sesión de depuración no se inicia en este periodo, los sincronizadores pueden ignorar la solicitud de creación de la sesión. Asegúrate de que los relojes de tus sincronizadores estén sincronizados, tal como se describe en los requisitos previos.
Número de solicitudes de Trace El valor predeterminado es 10 por procesador de mensajes y el máximo es 15.
APIs Apigee expone la API Debug Session y la API Debug Session Data.

Información general sobre la API

A continuación, se resumen las APIs y las funciones de Apigee.

Comportamiento APIs de Apigee
Dominio base apigee.googleapis.com
Tipos de medios application/json
Autenticación OAuth2
Marcas de tiempo en las claves Formato String 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Estructura del parámetro de consulta expand=false 
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parámetros de consulta con el prefijo de subrayado No admitido (optimal=true)
Propiedades de las cargas útiles:
  • created_by
  • modified_by
  • self
 No se admite
Valores predeterminados en cargas útiles No incluidos
Estructura de gestión de errores 
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Respuesta de eliminación de caché Devoluciones: 204 No Content
Operaciones de la API Cache Lista y eliminar únicamente. La caché de nivel 1 de corta duración se crea automáticamente al implementar un proxy de API. Para obtener más información, consulta Internos de la caché.

APIs de métricas de Apigee

Resumen de las APIs de métricas de Apigee:

Función APIs de Apigee
punto final de API apigee.googleapis.com
Correos de analíticas diarios No se admiten APIs
API Async Query List La propiedad userId se omite en la respuesta. Consulta Method: organizations.environments.queries.list.
APIs de informes personalizados Se han eliminado las propiedades createdBy y lastModifiedBy de la respuesta. Consulta la API Reports.

Características de Apigee Hybrid

En la siguiente tabla se resumen las funciones híbridas:

Servicio zona híbrida
Analytics Un pod de recogida de datos en el plano de tiempo de ejecución usa fluentd y UDCA (Universal Data Collection Agent) para recoger analíticas y enviar los datos a la UAP (Unified Analytics Platform) en el plano de gestión.
API Proxy Gateway El procesador de mensajes (MP) procesa las solicitudes entrantes. Los MPs se implementan como una o varias aplicaciones en contenedores en el plano de tiempo de ejecución.
Persistencia Cassandra proporciona persistencia para las funciones de KMS, KVM, cuota y caché.
Implementación El sincronizador se asegura de que las configuraciones de proxy de API, la información del entorno y otros datos se mantengan actualizados entre el plano de gestión y el plano de tiempo de ejecución.
Interfaz de usuario administrativa La interfaz de usuario de Apigee es una aplicación en contenedores alojada en el plano de gestión.
Balanceo de carga Un controlador Istio Ingress envía solicitudes a la aplicación en contenedores Router/Message Processor (RMP) del plano del entorno de ejecución.
APIs Se accede a las APIs de Apigee a través del servidor de gestión y MART. MART interactúa con el almacén de datos local de Cassandra y actúa como proveedor de APIs para que las APIs de Apigee puedan acceder a las entidades de datos de tiempo de ejecución y gestionarlas.
Métricas Gestionado por un solo servidor Prometheus por clúster para todos los servicios.