Todos os produtos
Search
Central de documentação

Object Storage Service:0048-00000107

Última atualização: Jul 03, 2026

Descrição do problema

Ao usar um endpoint de aceleração do Object Storage Service (OSS) para acessar um objeto pelo navegador, o navegador baixa o arquivo em vez de exibi-lo.

Causas

Se você utilizar um endpoint de aceleração para acessar um objeto em um bucket com aceleração de transferência ativada após as 12:00:00 de 7 de janeiro de 2021, a resposta do OSS incluirá os cabeçalhos x-oss-force-download e Content-Disposition.

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

O cabeçalho Content-Disposition: attachment aciona uma operação de baixe em vez de uma pré-visualização no navegador padrão.

Exemplos

Por exemplo, ao acessar pelo navegador um objeto chamado test em um bucket com aceleração de transferência ativada após as 12:00:00 de 7 de janeiro de 2021, a resposta conterá os dois cabeçalhos mencionados. Nesse cenário, Content-Disposition: attachment faz com que o navegador padrão baixe o objeto em vez de fornecer uma pré-visualização.

GET /test HTTP/1.1

HTTP/1.1 200 OK
Content-Disposition: attachment
x-oss-force-download: true

Soluções

Para evitar que o OSS retorne um cabeçalho que acione a operação de baixe, use um nome de domínio personalizado para acessar o objeto. Para mais informações, consulte Mapear nomes de domínio personalizados.

Referências