Todos os produtos
Search

Este produto

    CDN:Redimensionar imagens

    Central de documentação

    CDN:Redimensionar imagens

    Última atualização: Jul 03, 2026

    Use a ação resize para dimensionar imagens a uma largura, altura ou porcentagem específica. Esse recurso é útil quando sua plataforma ou aplicativo exige tamanhos de imagem definidos, como fotos de perfil, miniaturas ou ativos para diferentes densidades de tela.

    O recurso de edição de imagens do Alibaba Cloud CDN, o recurso de edição de imagens do DCDN e o recurso Image Processing (IMG) do Object Storage Service (OSS) são três funcionalidades distintas e não podem ser usadas de forma intercambiável.
    A edição de imagens é gratuita até novo aviso.
    A conversão entre formatos de imagem (por exemplo, de JPEG para WebP ou de PNG para WebP) pode gerar um arquivo maior, pois cada formato utiliza algoritmos de compressão diferentes. Para reduzir o tamanho do arquivo de saída, defina o parâmetro quality para diminuir a qualidade da imagem.

    Limites

    • A ação resize reduz o tamanho das imagens apenas para baixo. Se as dimensões de destino forem maiores que as originais, o sistema retorna a imagem sem alterações.

    • Definir qualquer parâmetro com um valor negativo faz com que o sistema retorne a imagem sem modificações.

    • A contagem total de pixels da imagem de saída não pode exceder 16.777.216 pixels.

    Parâmetros

    Ação: resize

    Parâmetro

    Nome completo

    Descrição

    Valores válidos

    w

    Largura

    Largura desejada em pixels.

    Inteiro. Padrão: 0.

    h

    Altura

    Altura desejada em pixels.

    Inteiro.

    l

    Lado maior

    Comprimento alvo para o lado mais longo.

    Inteiro.

    s

    Lado menor

    Comprimento alvo para o lado mais curto.

    Inteiro.

    fw e fh

    Largura e altura fixas

    Dimensões exatas de largura e altura para redimensionamento.

    Inteiro.

    p

    Porcentagem

    Tamanho final como porcentagem das dimensões originais. A proporção da imagem é mantida.

    Inteiro, [0, 100].

    Exemplos

    Todos os exemplos usam image_process=resize como parâmetro de consulta para aplicar a ação resize.

    Cenário

    URL de exemplo

    Reduzir para 80% do tamanho original

    example.com/image01.png?image_process=resize,p_80

    Redimensionar apenas se o arquivo tiver pelo menos 1.024.000 bytes

    example.com/image01.png?image_process=resize,l_200/threshold,1024000

    Ajustar pelo lado maior (200 px)

    example.com/image01.png?image_process=resize,l_200

    Ajustar pelo lado menor (200 px)

    example.com/image01.png?image_process=resize,s_200

    Defina pela largura (200 px)

    example.com/image01.png?image_process=resize,w_200

    Defina pela altura (200 px)

    example.com/image01.png?image_process=resize,h_200

    Especificar largura e altura exatas (200 x 200 px)

    example.com/image01.png?image_process=resize,fw_200,fh_200
    No exemplo de redimensionamento condicional, o parâmetro threshold especifica o tamanho mínimo do arquivo em bytes. O sistema redimensiona a imagem apenas quando seu tamanho atinge ou ultrapassa esse limiar. Ajuste o valor conforme suas necessidades.