Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Parameter filtering

Última atualização: Jun 27, 2026

Ao ativar a filtragem de parâmetros, os pontos de presença (POPs) do Alibaba Cloud CDN removem os parâmetros após o ponto de interrogação (?) na URL da requisição. Esses parâmetros podem conter informações como identidades de usuários e canais de acesso. O CDN usa a URL resultante para gerar uma chave de hash de cache. Esse processo aumenta a taxa de acerto do cache e acelera a entrega de conteúdo. Este tópico descreve como configurar a filtragem de parâmetros.

Visão geral

Nota

O recurso de assinatura de URL tem prioridade sobre a filtragem de parâmetros. As informações de assinatura geradas pelo tipo A contêm os parâmetros da requisição HTTP. O Alibaba Cloud CDN verifica essas informações antes que os pontos de presença (POPs) armazenem em cache uma cópia do recurso solicitado. Para obter mais informações sobre como configurar a assinatura de URL, consulte Configurar assinatura de URL.

    Procedimento

    1. Faça login no console do ApsaraVideo VOD.

    2. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Domain Names.

    3. Na página Domain Names, localize o nome de domínio a ser gerenciado e clique em Configure na coluna Actions.

    4. No painel de navegação à esquerda, clique em Performance Optimization.

    5. Na seção Ignore Parameters, clique em Modify.

    6. Configure os itens necessários, como o padrão de filtragem e os parâmetros de filtro.

      A tabela a seguir descreve os parâmetros.

      Importante

      Alterar o padrão de filtro exclui a configuração atual.

      • Padrão de Filtro: Manter Parâmetros Especificados

        Parâmetro

        Descrição

        Exemplo

        Ignore Parameters

        • Yes: Ativa a filtragem de parâmetros. Nas requisições de busca na origem, os parâmetros após o ponto de interrogação (?) na URL são removidos.

          Nota

          Se você ativar Ignore Parameters, mas deixar Retain specified parameters vazio, todos os parâmetros após o ponto de interrogação (?) serão removidos.

        • No: Desativa o recurso de ignorar parâmetros.

        Considere que a URL original seja http://example.com/1.jpg?key1=1&key2=2&key3=3. Os exemplos abaixo mostram como o CDN processa a URL com base em diferentes configurações:

        • Exemplo 1: Filtrar todos os parâmetros + Usar a URL processada para busca na origem:

          • Configuração: Defina Ignore Parameters como Yes, deixe Retain specified parameters vazio e defina Retain back-to-origin parameters como No.

          • Chave de cache: http://example.com/1.jpg

          • URL de busca na origem: http://example.com/1.jpg

        • Exemplo 2: Manter parâmetros especificados + Usar a URL processada para busca na origem:

          • Configuração: Defina Ignore Parameters como Yes, defina Retain specified parameters como key1 e defina Retain origin parameters como No.

          • Chave de cache: http://example.com/1.jpg?key1=1

          • URL de busca na origem: http://example.com/1.jpg?key1=1

        • Exemplo 3: Filtrar todos os parâmetros + Usar a URL original para busca na origem:

          • Configuração: Defina Ignore Parameters como Yes, deixe Retain specified parameters vazio e defina Retain back-to-origin parameters como Yes.

          • Chave de cache: http://example.com/1.jpg

          • URL de busca na origem: http://example.com/1.jpg?key1=1&key2=2&key3=3

        • Exemplo 4: Manter parâmetros especificados + Usar a URL original para busca na origem:

          • Configuração: Defina Ignore Parameters como Yes, defina Retain specified parameters como key1 e defina Retain origin parameters como Yes.

          • Chave de cache: http://example.com/1.jpg?key1=1

          • URL de busca na origem: http://example.com/1.jpg?key1=1&key2=2&key3=3

        Retain Specified Parameters

        Especifique os parâmetros a serem mantidos. É possível definir até 10 parâmetros. Separe múltiplos parâmetros por vírgulas (,).

        Retain Origin Parameters

        • Yes: Mantém todos os parâmetros da URL de requisição original na requisição de volta à origem.

        • No: Os parâmetros na requisição de volta à origem correspondem aos da chave de hash de cache. Ou seja, apenas os parâmetros especificados são mantidos.

      • Padrão de Filtro: Excluir Parâmetros Especificados

        Parâmetro

        Descrição

        Exemplo

        Delete specified parameters

        Especifique os parâmetros a serem excluídos. O limite é de 10 parâmetros. Use espaços para separar vários parâmetros.

        Suponha que a URL original seja http://example.com/1.jpg?key1=1&key2=2&key3=3. Veja como o CDN processa a URL conforme as configurações aplicadas:

        • Exemplo 1: Excluir parâmetros especificados + Usar a URL processada para busca na origem:

          • Configuração: Defina Delete specified parameters como key1 e defina Retain origin parameters como No.

          • Chave de cache: http://example.com/1.jpg?key2=2&key3=3

          • URL de busca na origem: http://example.com/1.jpg?key2=2&key3=3

        • Exemplo 2: Excluir parâmetros especificados + Usar a URL original para busca na origem:

          • Configuração: Defina Delete specified parameters como key1 e defina Retain origin parameters como Yes.

          • Chave de cache: http://example.com/1.jpg?key2=2&key3=3

          • URL de busca na origem: http://example.com/1.jpg?key1=1&key2=2&key3=3

        Retain Origin Parameters

        • Yes: Preserva todos os parâmetros da URL original durante a requisição de volta à origem.

        • No: A requisição de volta à origem usa os mesmos parâmetros da chave de hash de cache. Isso significa que os parâmetros especificados são excluídos.

    7. Clique em OK.