Limitações

Antes de ativar a otimização de imagens, revise as restrições técnicas, formatos compatíveis, e os limites operacionais do recurso. Entender esses limites ajuda a garantir a compatibilidade com seus fluxos de trabalho de mídia atuais e a criar um pipeline de entrega de imagens eficiente e confiável.

Esta seção descreve restrições gerais, limites de cota e capacidade, tratamento de erros à prova de falhas e regras de validação.

Restrições gerais

O plano de dados de otimização de imagens valida todas as solicitações recebidas em relação a limites de sistema e regras de validação rigorosos. O pipeline de borda processa solicitações que usam formatos válidos e atendem às seguintes restrições de otimização:

Restrição

Valor

Entrada/saída

Tamanho máximo

20 MB

Entrada e saída

Dimensão máxima

8192 px por dimensão

Entrada e saída

Resolução total máxima

67 mpx (67.108.864 megapixels)

Entrada e saída

Caso de parâmetro

Snake_case (palavras separadas por sublinhados), sem distinção entre maiúsculas e minúsculas

Entrada

Validação rigorosa

Se até mesmo um parâmetro for inválido, o sistema rejeitará toda a solicitação e retornará um código de status HTTP 400 Bad Request.

Entrada

Limites de cota e capacidade

O Cloud CDN transforma imagens dinamicamente na borda. Para manter a estabilidade do serviço e evitar o esgotamento de recursos, o Cloud CDN gerencia e aplica a capacidade de processamento do plano de dados para cada região (ponto de presença ou PoP).

Se a transferência de dados em uma região específica exceder a capacidade de processamento local, o Cloud CDN implementará automaticamente as seguintes estratégias de mitigação para preservar a disponibilidade:

  • O Cloud CDN encaminha automaticamente a solicitação para regiões adjacentes para processamento. Embora esse encaminhamento ajude a garantir que a imagem seja otimizada, ele introduz a latência de preenchimento do cache entre regiões.

  • Se as regiões adjacentes também estiverem na capacidade máxima, o Cloud CDN rejeitará a solicitação e retornará um código de status HTTP 429 Too Many Requests.

Tratamento de erros à prova de falhas

A plataforma tem um limite de processamento rigoroso:

  • Tempo limite de transformação: se uma ação de processamento de borda demorar muito, a sequência de processamento vai expirar.

  • Se o processamento demorar muito, ele será encerrado e um código de erro explícito será veiculado ao usuário final.

Regras de validação

Para garantir que o sistema processe suas imagens e evitar erros, verifique se as solicitações estão dentro dos seguintes limites:

  • Limite de operação: é possível incluir no máximo 10 operações de imagem (imop) em uma única string de consulta. Apenas uma operação de um determinado tipo pode ser incluída na string de consulta única.

  • Limite de comprimento do URL: todo o caminho do URL, incluindo a string de modificação do parâmetro imop, não pode exceder 1.024 caracteres.

Validação de parâmetros

O sistema valida todos os parâmetros recebidos em relação a um esquema. Para evitar que sua solicitação seja rejeitada com um HTTP 400 (Bad Request) error, verifique se todas as operações e parâmetros na string de consulta usam a ortografia e a formatação corretas.

A seguir