Este tópico responde a perguntas frequentes sobre upload de arquivos no Drive and Photo Service, incluindo upload instantâneo, upload retomável, atrasos na atualização do uso de armazenamento e solução de problemas de falhas de upload.
Diferença entre upload instantâneo e verificação prévia
O upload instantâneo baseia-se no hash SHA-1 do arquivo inteiro. Ao crie um arquivo, o servidor calcula seu hash SHA-1 completo. Se esse hash corresponder a um registro existente, o upload será concluído instantaneamente.
A verificação prévia para upload instantâneo otimiza o processamento de arquivos grandes, pois calcular o hash SHA-1 completo pode ser demorado. Esse processo lê inicialmente os primeiros 1 KB do arquivo e calcula seu hash. Caso não exista registro correspondente para esse hash de 1 KB, o arquivo não se qualifica para upload instantâneo e o processo termina antecipadamente para evitar um cálculo de hash completo desnecessário. Se houver correspondência para o hash de 1 KB, o servidor prossegue com o cálculo do hash SHA-1 de todo o arquivo para confirme a possibilidade de upload instantâneo.
Atraso na atualização do armazenamento do drive
O PDS atualize o uso de armazenamento do drive de forma assíncrona. Após a conclusão de um upload, os dados de uso de armazenamento geralmente são atualizados em 2 a 3 segundos.
Granularidade do upload instantâneo
O upload instantâneo opera no nível do arquivo. Após o upload, o servidor calcula e armazena o hash SHA-1 do arquivo. Uploads subsequentes de arquivos com o mesmo hash acionam o upload instantâneo.
Uploads retomáveis
Sim. Os uploads retomáveis funcionam pela divisão do arquivo em várias partes independentes. A menor unidade retomável é uma única parte. Não é possível retomar um upload a partir do meio de uma parte.
Causas comuns de falhas no upload
No modo de hospedagem, as falhas de upload frequentemente resultam de regras de Cross-Origin Resource Sharing (CORS) configuradas incorretamente. Verifique as regras CORS do seu bucket OSS para garantir que a origem, o método de solicitação e o cabeçalho da solicitação estejam incluídos na lista de permissões.
Os uploads também podem falhar se a cota de armazenamento do drive for esgotada. Nesse caso, a API retorna o código de erro
QuotaExhausted.