Todos os produtos
Search
Central de documentação

Object Storage Service:0048-00000112

Última atualização: Jun 23, 2026

Descrição do problema

Quando você usa um navegador para acessar um objeto por meio de um endpoint de aceleração do Object Storage Service (OSS), o navegador pode baixar o objeto em vez de visualizá-lo.

Causas

Se você usar um endpoint de aceleração do OSS para acessar um objeto em um bucket no qual a aceleração de transferência foi habilitada após 00:00 de 1º de fevereiro de 2023, o OSS adicionará os dois cabeçalhos a seguir à resposta:

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

O cabeçalho Content-Disposition: attachment aciona um download em vez de uma visualização em um navegador padrão.

Exemplos

Por exemplo, você tem um objeto chamado test em um bucket no qual a aceleração de transferência foi habilitada após 00:00 de 1º de fevereiro de 2023. Quando você usa um navegador e um endpoint de aceleração do OSS para acessar o objeto, a resposta inclui os dois cabeçalhos anteriores. O cabeçalho Content-Disposition: attachment faz com que o navegador baixe o objeto em vez de visualizá-lo.

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

Solução

Para evitar que o OSS retorne um cabeçalho que force um download, use um nome de domínio personalizado para acessar o objeto. Para obter mais informações, consulte Mapear nomes de domínio personalizados.