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 funciones de Apigee y Apigee Hybrid.

En la siguiente tabla, se enumeran los productos de administración de la API de Apigee que se comparan en este tema:

Producto Cuándo se aloja Administrado por
Apigee Google Cloud Apigee
Apigee Hybrid Google Cloud y el centro de datos privado del cliente Apigee administra el plano de administración y el cliente administra el plano de entorno de ejecución.

Resumen de las funciones de Apigee

En la siguiente tabla, se proporciona un resumen a nivel de las funciones de Apigee (y Apigee Hybrid).

Atributo Asistencia en Apigee y Apigee Hybrid
Revisiones del proxy de API

Inmutable cuando se implementa

Adaptador de Apigee para Istio Obsoleto: Te recomendamos que uses el adaptador de Apigee para Envoy.
Organización de apps Organiza apps con AppGroups o asociaciones de apps para desarrolladores. Consulta Organiza la propiedad de la app cliente.
Deployments
  • Implementaciones asíncronas
  • La obtención del estado de implementación se basa en la última vez que el plano de entorno de ejecución "se registró" con el plano de administración.
Entornos
  • Compatibilidad con grupos de entornos
  • Autoservicio a través de la IU y las API de Apigee
  • Flexibilidad en la topología de entrega
  • Un pod de MP solo puede entregar un entorno

Para obtener más información, consulta Información acerca de los entornos y grupos de entornos.

Compatibilidad con proxy basado en gRPC

Procesa solicitudes API de protocolo de gRPC unario a un servidor de destino de gRPC. Consulta Cómo crear proxies de API de gRPC.

Caso de nombre de campo de encabezado HTTP/1.1

Convierte los nombres de campo del encabezado HTTP/1.1 en minúsculas cuando se reenvían al backend. Este comportamiento puede afectar a las aplicaciones que esperan que se conserve el caso.

Almacéne de claves/Truststores
  • Extremos ascendentes administrados como secretos de Kubernetes
KVM
  • Puedes crear KVM encriptadas con alcance de entorno en la IU de Apigee. Los KVM siempre están encriptados. No puedes agregar, actualizar ni ver entradas de KVM en la IU.
  • Usa el atributo private. con todas las variables cuando accedas a un KVM con el comando GET para ocultar la información de KVM en una sesión de depuración (Trace). Si no se usa el atributo private., la KVM aún está encriptada. Sin embargo, la información de KVM aparecerá desencriptada en la sesión de depuración de Trace) y no se lanzará ninguna excepción.
  • Puedes administrar las entradas de KVM mediante la API de keyvaluemaps.entries o la política de KeyValueMapOperations.
  • Puedes usar conjuntos de propiedades para algunos de los mismos casos de uso que KVM. Consulta Cómo usar conjuntos de propiedades.
  • El elemento <MapName> habilita la política KeyValueMapOperations para identificar qué KVM se usará de forma dinámica en el entorno de ejecución.

Si deseas obtener más información para crear KVM en la IU, consulta Usa mapas de clave-valor. Consulta también Cómo acceder a los datos de configuración para obtener información sobre cómo elegir el mecanismo de persistencia de datos correcto.

Monetización Consulta la descripción general de la monetización.
Node.js
  • Los proxies de API de Node.js no son compatibles.
  • Apigee recomienda que alojes aplicaciones de Node.js como contenedores independientes en Kubernetes (mismo o diferente clúster).
OAuth Nueva política de RevokeOAuthv2 revoca por ID de usuario final, ID de la app o ambos
Políticas Consulta Descripción general de la política.
Recursos No se pueden usar los recursos a nivel de organización
Funciones y permisos
  • Administrado a través del servicio de IAM de la consola de Google Cloud
  • Se encuentran disponibles algunas funciones listas para usar
  • Puedes crear roles personalizados que puedan incluir otros permisos de Google Cloud.

Para obtener más información, consulta Usuarios y funciones.

Servicios de SOAP en el asistente de compilación de un proxy No compatible. Consulta wsdl2apigee, un proyecto de código abierto que proporciona utilidades de SOAP para su uso con Apigee.
Sesiones de seguimiento o depuración Consulta Compatibilidad con Trace.
Hosts virtuales

Para Hybrid:

  • La entrada se implementa a través de Anthos Service Mesh.
  • Las claves y los certificados se implementan de forma directa en Kubernetes.

Para Apigee:

  • Cada instancia expone un extremo HTTPS a través de un certificado autofirmado. Para descargar la CA del certificado, consulta a la organización.

Compatibilidad con Trace y Debug

En la siguiente tabla, se muestra la compatibilidad con Apigee y el Trace híbrido:

Atributo Apigee y la compatibilidad híbrida
Oportunidad Retraso leve; asíncrono
Nombre/ID de la sesión No se acepta el nombre de la sesión del usuario.
Filtros Compatibilidad con la 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 condicionales, como se muestra en la referencia de condiciones.
Tiempo de espera de sesión

Define solo la duración de la sesión de depuración. El punto de partida es cuando Message Processor recibe la solicitud para ejecutarse en modo de depuración.

El valor predeterminado es de 5 minutos si la sesión se inició con la API y 10 minutos si se inició en la IU.

Los datos se conservan durante 24 horas antes de que se borren de forma automática.

Validez de la sesión Período durante el cual la solicitud de creación de sesión es válida. Si la sesión de depuración no comienza en este período, los Synchronizers pueden ignorar la solicitud de creación de sesión. Asegúrate de que los relojes de Synchronizers estén sincronizados, como se describe en Requisitos previos.
Recuento de solicitudes de seguimiento El valor predeterminado es 10 por Message Processor y el máximo es 15.
APIs Apigee expone la API de sesión de depuración y la API de datos de sesión de depuración.

Descripción general de la API

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

Comportamiento API de Apigee
Dominio base apigee.googleapis.com
Tipos de medios application/json
Autenticación OAuth2
Marcas de tiempo en claves Formato String

{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Estructura del parámetro de búsqueda expand=false

{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Parámetros de búsqueda con guion bajo como prefijo No admitido (optimal=true)
Propiedades en cargas útiles:
  • created_by
  • modified_by
  • self
No compatible
Valores predeterminados en cargas útiles No incluida
Estructura de manejo de errores

{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Respuesta de eliminación de la caché Muestra: 204 No Content
Operaciones de caché de la API Solo Enumerar y Borrar. La caché L1 de corta duración se crea automáticamente cuando implementas un proxy de API. Para obtener más información, consulta Objetos internos de la caché.

APIs de métricas de Apigee

Resumen de las API de métricas de Apigee:

Atributo API de Apigee
extremo de API apigee.googleapis.com
Correos electrónicos de estadísticas diarias No se admiten API
API de lista de búsquedas asíncronas La propiedad userId se omite de la respuesta. Consulta Método: organizations.environments.queries.list.
API de informes personalizados Se quitaron las propiedades createdBy y lastModifiedBy de la respuesta. Consulta API de informes.

Funciones de Apigee Hybrid

En la siguiente tabla, se resumen las características híbridas:

Servicio Área híbrida
Analytics Un pod de recopilación de datos en el plano del entorno de ejecución usa fluentd y UDCA (Universal Data Collection Agent) para recopilar estadísticas y enviar los datos a la UAP (Unified Analytics Platform) en el plano de administración.
Puerta de enlace del proxy de API El Message Processor (MP) procesa las solicitudes entrantes. Los MP se implementan como una o más apps en contenedores en el plano de entorno de ejecución.
Persistencia Cassandra proporciona persistencia para las funciones de KMS, KVM, las cuotas y la caché.
Deployment Sincronizador garantiza que las configuraciones del proxy de la API, la información del entorno y otros datos se mantengan actualizadas entre el plano de administración y el plano del entorno de ejecución.
Interfaz de usuario administrativa La IU de Apigee es una aplicación en contenedores alojada en el plano de administración.
Balanceo de cargas Un controlador Ingress de Istio envía solicitudes a la app en contenedor Router/MessageProcessor (RMP) en el plano de entorno de ejecución.
APIs Se puede acceder a las API de Apigee mediante el servidor de administración y MART. MART interactúa con el almacén de datos local de Cassandra y funciona como proveedor de API para que las API de Apigee accedan y administren las entidades de datos del entorno de ejecución.
Métricas Administrado por un único servidor de Prometheus por clúster para todos los servicios.