Todos os produtos
Search
Central de documentação

ApsaraVideo VOD:Limpeza e pré-busca

Última atualização: Jun 27, 2026

Ao atualizar o conteúdo do servidor de origem ou remover recursos não conformes, limpe o cache nos pontos de presença (POPs) da Content Delivery Network (CDN) para garantir que os usuários acessem a versão mais recente. Antes de eventos ou publicações, 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.

Pré-requisitos

  • Horário: Tarefas de limpeza e pré-busca geram tráfego de retorno à origem. Execute operações em grande escala fora dos horários de pico.

  • Formato de URL: Caso a URL enviada contenha caracteres não ASCII, como ideogramas chineses ou espaços, aplique a codificação percentual em UTF-8 antes de prosseguir.

  • Cache compartilhado: Se um domínio estiver configurado com cache compartilhado, enviar uma tarefa de limpeza pelo domínio principal ou por qualquer domínio associado invalidará o cache de todos os domínios vinculados.

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 o método de atualização adequado e envie a tarefa.

    Método de Atualização

    Descrição

    URL

    Finalidade: Limpar o cache de 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 termine com /. 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 Atualizar Cache e defina Force=true.

  5. Clique em Submit para iniciar a tarefa de limpeza.

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

    • A limpeza geralmente leva de 5 a 6 minutos para propagar por toda a rede. Se o tempo de vida (TTL) do cache for inferior a esse período, a limpeza manual é desnecessária.

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 para pré-busca. Insira uma URL por linha. Não há suporte para pré-busca de diretórios. Exemplo: https://www.example.com/install/package.zip.

  5. Clique em Submit para iniciar a tarefa de pré-busca.

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

    • A duração da pré-busca varia conforme o tamanho e a quantidade de arquivos, além do desempenho do servidor de origem. Geralmente, o processo leva de 5 a 30 minutos.

Resultados da Validação

  • Consulta manual

    Na aba Registro de Operações, visualize os detalhes e o progresso das tarefas de limpeza ou pré-busca. O valor 100% indica conclusão. Operações com muitos recursos podem demorar mais; aguarde o término da tarefa.

  • Consulta via API

    Chame a operação GetMediaRefreshJobs para verificar o status da tarefa.

  • 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:

    • X-Cache como HIT indica que a solicitação atingiu o cache e a pré-busca foi bem-sucedida.

    • X-Cache como MISS significa que a solicitação não encontrou o cache. Isso aponta para falha ou incompletude na pré-busca. Refaça o procedimento.

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

    A ausência do cabeçalho X-Cache indica que o recurso ainda não foi adicionado à CDN. Siga as instruções em Adicionar um nome de domínio para configurar o domínio da URL e, em seguida, realize a pré-busca.

Limites

Tipo de operação

Método

Limite de cota

Atualização

Limpeza de URL

Até 2.000 entradas por conta/dia, com máximo de 1.000 entradas por solicitação.

Atualização de diretório

Limite de 100 solicitações por conta/dia e 100 itens por solicitação.

Pré-busca

Pré-busca de URL

Até 500 itens por conta/dia e 100 itens por solicitação.

Faturamento

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

Contudo, ambas as operações acionam os POPs de borda da CDN para buscar recursos no servidor de origem, gerando custos de tráfego de retorno e solicitações à origem. Os padrões de faturamento variam conforme o tipo de servidor utilizado:

Importante

Operações em grande escala, especialmente em curtos períodos, podem elevar os custos de retorno à origem. Avalie o impacto financeiro antes de executá-las.

Operações de API relacionadas

Perguntas frequentes