Limitaciones

Antes de habilitar la optimización de imágenes, revisa las restricciones técnicas, los formatos compatibles, y los límites operativos de la función. Comprender estos límites te ayudará a garantizar la compatibilidad con tus flujos de trabajo de contenido multimedia existentes y a diseñar una canalización de entrega de imágenes eficiente y confiable.

En esta sección, se describen las restricciones generales, los límites de cuota y capacidad, el manejo de errores a prueba de fallas y las reglas de validación.

Restricciones generales

El plano de datos de optimización de imágenes valida todas las solicitudes entrantes con límites estrictos del sistema y reglas de validación. La canalización perimetral procesa las solicitudes que usan formatos válidos y cumplen con las siguientes restricciones de optimización:

Restricción

Valor

Entrada/Salida

Tamaño máximo

20 MB

Entrada y salida

Dimensión máxima

8,192 px por dimensión

Entrada y salida

Resolución total máxima

67 mpx (67,108,864 megapíxeles)

Entrada y salida

Uso de mayúsculas y minúsculas en los parámetros

Snake_case (palabras separadas por guiones bajos), no distingue mayúsculas de minúsculas

Entrada

Validación estricta

Si incluso un parámetro no es válido, el sistema rechaza toda la solicitud y muestra un HTTP 400 Bad Request código de estado.

Entrada

Límites de cuota y capacidad

Cloud CDN transforma imágenes de forma dinámica en el perímetro. Para mantener la estabilidad del servicio y evitar el agotamiento de los recursos, Cloud CDN administra y aplica la capacidad de procesamiento del plano de datos para cada región (punto de presencia o PoP).

Si la transferencia de datos en una región específica supera la capacidad de procesamiento local, Cloud CDN implementa automáticamente las siguientes estrategias de mitigación para preservar la disponibilidad:

  • Cloud CDN enruta automáticamente la solicitud a las regiones adyacentes para su procesamiento. Si bien este enrutamiento ayuda a garantizar que la imagen esté optimizada, introduce latencia de llenado de caché entre regiones.

  • Si las regiones adyacentes también están al máximo de su capacidad, Cloud CDN rechaza la solicitud y muestra un código de estado HTTP 429 Too Many Requests.

Manejo de errores a prueba de fallas

La plataforma tiene un umbral de procesamiento estricto:

  • Tiempo de espera de transformación: Si una acción de procesamiento perimetral tarda demasiado, se agota el tiempo de espera de la secuencia de procesamiento.

  • Si el procesamiento tarda demasiado, se finaliza y se muestra un código de error explícito al usuario final.

Reglas de validación

Para garantizar que el sistema procese tus imágenes correctamente y evitar errores, asegúrate de que tus solicitudes se mantengan dentro de los siguientes límites:

  • Límite de operaciones: Puedes incluir un máximo de 10 operaciones de imagen (imop) en una sola cadena de consulta. Solo se puede incluir una operación de un tipo determinado en la cadena de consulta única.

  • Límite de longitud de la URL: La ruta de URL completa, incluida la cadena de modificación del parámetro imop, no puede superar los 1,024 caracteres.

Validación de parámetros

El sistema valida todos los parámetros entrantes con un esquema. Para evitar que se rechace tu solicitud con un HTTP 400 (Bad Request) error, verifica que todas las operaciones y los parámetros de tu cadena de consulta usen la ortografía y el formato correctos.

¿Qué sigue?