Todos os produtos
Search
Central de documentação

Object Storage Service:0048-00000002

Última atualização: Sep 22, 2026

Descrição do problema

Ao acessar um objeto pelo endpoint de aceleração do Object Storage Service (OSS) em um navegador, o objeto pode ser baixado diretamente em vez de exibido como pré-visualização.

Causas

Esse comportamento ocorre em buckets que tiveram a aceleração de transferência ativada após 00:00 de 31 de dezembro de 2020. Ao acessar um objeto cujo nome termina com .htm ou .html, ou cujo Content-Type é text/html, por meio de um endpoint de aceleração do OSS, o OSS adiciona os dois cabeçalhos a seguir à resposta:

x-oss-force-download: true
Content-Disposition: attachment

Em um navegador padrão, o cabeçalho Content-Disposition: attachment aciona o baixe do arquivo em vez da pré-visualização.

Exemplos

Suponha que um bucket teve a aceleração de transferência ativada após 00:00 de 31 de dezembro de 2020 e contém um objeto chamado index.html. Ao acessar esse objeto pelo endpoint de aceleração do OSS em um navegador, o OSS adiciona os dois cabeçalhos à resposta. O navegador então baixa o objeto em vez de exibi-lo como pré-visualização, por causa do cabeçalho Content-Disposition: attachment.

GET /index.html HTTP/1.1
HTTP/1.1 200 OK
Content-Disposition: attachment
x-oss-force-download: true

Solução

Caso não deseje que o OSS retorne os cabeçalhos que forçam o baixe, acesse o objeto por meio de um nome de domínio personalizado. Para mais informações, consulte Map a custom domain name.