Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Limpeza e pré-busca

Última atualização: Aug 27, 2026

Quando o conteúdo do servidor de origem é atualizado ou quando você precisa remover recursos não conformes, limpe o cache nos pontos de presença (POPs) da Content Delivery Network (CDN). Isso garante que os usuários acessem o conteúdo mais recente. Antes de um evento ou da publicação de novo conteúdo, a pré-busca de recursos para os POPs da CDN melhora significativamente a velocidade no primeiro acesso e reduz a carga no servidor de origem. Este tópico descreve como usar os recursos de limpeza de cache e pré-busca do ApsaraVideo VOD.

Como funciona

Limpeza de recursos

A operação de limpeza envia um comando de invalidação de cache para os POPs da CDN, em vez de excluir arquivos diretamente. Ao receber o comando, o POP marca os recursos em cache correspondentes como "inválidos" ou "expirados". Na próxima solicitação do usuário, o POP detecta o cache inválido, busca a versão mais recente no servidor de origem e a entrega ao usuário, armazenando-a novamente em cache.

Casos de uso

  1. Atualização e lançamento de conteúdo: Após atualizar recursos no servidor de origem, limpe-os para garantir que os usuários recebam a versão mais recente. O conteúdo será então armazenado novamente nos POPs.

  2. Remoção de conteúdo não conforme: Se o servidor de origem contiver conteúdo não conforme, ele poderá permanecer no cache da CDN mesmo após a exclusão do arquivo de origem. Use o recurso de limpeza de URL para remover o recurso do cache.

Pré-busca de recursos

A operação de pré-busca instrui os POPs da CDN a buscar e armazenar proativamente recursos do servidor de origem com base em uma lista de URLs fornecida por você. Trata-se de um modelo de "pull", e não de "push" a partir do servidor de origem. A pré-busca melhora a velocidade inicial de carregamento, reduz a pressão de requisições à origem durante eventos de alto tráfego e ajuda a proteger o servidor de origem.

Casos de uso

  1. Integração ao Alibaba Cloud CDN: Ao adicionar um novo domínio ao Alibaba Cloud CDN, faça a pré-busca dos recursos estáticos populares para os POPs. Isso assegura que as solicitações iniciais dos usuários sejam atendidas diretamente do cache, evitando lentidão no carregamento e melhorando a experiência do usuário.

  2. Suporte a campanhas promocionais: Para campanhas de grande escala, pré-busque os recursos estáticos das páginas do evento para os POPs com antecedência. Quando a campanha começar, todas as solicitações de usuários para esses recursos estáticos serão atendidas diretamente pelos POPs, garantindo carregamentos rápidos das páginas.

  3. Publicação de pacotes de instalação ou arquivos grandes: Antes de lançar novos softwares, pacotes de instalação ou outros arquivos grandes, faça a pré-busca deles para os POPs. Após o lançamento, o grande volume de solicitações de download será atendido diretamente pelo cache da CDN. Essa abordagem aumenta as velocidades de download, diminui a carga no servidor de origem e aprimora a experiência do usuário.

Pré-requisitos

  • Horário: Tarefas de limpeza e pré-busca geram tráfego de retorno à origem. Execute tarefas de limpeza ou pré-busca em grande escala durante horários de baixa demanda.

  • Formato de URL: Se uma URL enviada contiver caracteres não ASCII, como caracteres chineses ou espaços, aplique primeiro a codificação percentual em UTF-8.

  • Cache compartilhado: Se um nome de domínio estiver configurado com cache compartilhado, o envio de uma tarefa de limpeza usando o nome de domínio principal ou qualquer nome de domínio associado invalidará o cache para todos os nomes de domínio associados.

Procedimento

Limpar recursos

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

  2. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Refresh and Prefetch.

  3. Na aba Purge Cache, defina Operation Type como Purge.

  4. Selecione um método de atualização conforme suas necessidades e envie a tarefa.

    Método de Atualização

    Descrição

    URL

    Finalidade: Limpar o cache de um ou mais arquivos específicos.

    Operação: Na caixa de texto URL, insira as URLs completas, incluindo http:// ou https://. Insira uma URL por linha. Exemplo: https://www.example.com/static/image.jpg.

    Folder

    Finalidade: Limpar o cache de todos os arquivos e subdiretórios em um diretório da CDN.

    Operação: Insira a URL completa do diretório e certifique-se de que ela termine com /. Por exemplo: https://www.example.com/static/.

    Nota: Esta é uma limpeza baseada em atualização. Para forçar a limpeza de todo o diretório, use Refresh Cache e defina Force=true.

  5. Clique em Submit. O sistema iniciará a execução da tarefa de limpeza.

    Nota
    • Não é possível cancelar uma tarefa de limpeza após o envio.

    • Uma tarefa de limpeza geralmente leva de 5 a 6 minutos para entrar em vigor em toda a rede. Se o tempo de vida (TTL) do cache for menor que essa duração, não será necessário limpar o cache manualmente.

Pré-buscar recursos

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

  2. No painel de navegação à esquerda, escolha Configuration Management > CDN Configuration > Refresh and Prefetch.

  3. Na aba Purge Cache, defina Operation Type como Prefetch.

  4. Na caixa de texto URL, insira as URLs completas dos arquivos que deseja pré-buscar. Insira uma URL por linha. Não é possível pré-buscar diretórios. Exemplo: https://www.example.com/install/package.zip.

  5. Clique em Submit. O sistema iniciará a execução da tarefa de pré-busca.

    Nota
    • Não é possível cancelar uma tarefa de pré-busca após o envio.

    • O tempo necessário para concluir uma tarefa de pré-busca depende do tamanho do arquivo, da quantidade de arquivos e do desempenho do servidor de origem. Geralmente, leva de 5 a 30 minutos.

Resultados da Validação

  • Consulta manual

    Na aba Operation Record, visualize os detalhes e o progresso das tarefas de limpeza ou pré-busca. Um progresso de 100% indica que a tarefa foi concluída. Caso tenha limpado ou pré-buscado muitos recursos, a tarefa poderá levar mais tempo para ser finalizada. Aguarde a conclusão da tarefa.

  • Consulta via API

    Chame a operação GetMediaRefreshJobs para verificar o status de uma tarefa de limpeza ou pré-busca.

  • Validação por linha de comando

    Execute o comando curl -I <resource_URL>. A saída será semelhante à seguinte:

    image

    Se o cabeçalho X-Cache existir:

    • Se X-Cache for HIT, a solicitação atingiu o cache e a pré-busca foi bem-sucedida.

    • Se X-Cache for MISS, a solicitação não encontrou o cache. Isso indica que a tarefa de pré-busca está incompleta ou falhou. Faça a pré-busca do recurso novamente.

    Se o cabeçalho X-Cache não existir:

    Caso o cabeçalho X-Cache não esteja presente, o recurso não foi adicionado à CDN. Siga as instruções em Add a domain name para configurar o nome de domínio da URL e, em seguida, faça a pré-busca do recurso.

Limites

Tipo de operação

Método

Limite de cota

Atualização

Limpeza de URL

Cada conta pode enviar até 2.000 entradas por dia, com um máximo de 1.000 entradas por solicitação.

Atualização de diretório

Cada conta tem um limite de 100 solicitações por dia e 100 itens por solicitação.

Pré-busca

Pré-busca de URL

É possível enviar até 500 itens por conta por dia e até 100 itens por solicitação.

Faturamento

Os recursos de limpeza e pré-busca são gratuitos.

No entanto, ambas as operações acionam os POPs de borda da CDN para buscar recursos no servidor de origem. Isso gera custos de tráfego de retorno à origem e de solicitações à origem. Os padrões de faturamento dependem do tipo de servidor de origem utilizado:

  • Se o servidor de origem for um bucket do ApsaraVideo VOD, haverá cobrança referente a outbound traffic from storage.

  • Caso o servidor de origem seja o Object Storage Service (OSS) do Alibaba Cloud, haverá cobrança de traffic e requests conforme as regras de faturamento do OSS.

Importante

Operações de limpeza ou pré-busca em grande escala, especialmente em um curto período, podem aumentar os custos de retorno à origem. Avalie o impacto potencial nos custos antes de executar essas operações.

Operações de API relacionadas

Perguntas frequentes