Todos os produtos
Search
Central de documentação

Object Storage Service:WriteGetObjectResponse

Última atualização: Jul 03, 2026

Personaliza os dados e cabeçalhos de resposta de uma solicitação GetObject processada pelo Function Compute.

Pré-requisitos

Conceda a permissão oss:WriteGetObjectResponse à função padrão (AliyunFCDefaultRole) do serviço Function Compute. Exemplo de política:

{
  "Statement": [
    {
      "Action": "oss:WriteGetObjectResponse",
      "Effect": "Allow",
      "Resource": "*"
    }
  ],
  "Version": "1"
}

Conceder permissões a uma função RAM.

Cabeçalhos da solicitação

POST /?x-oss-write-get-object-response HTTP/1.1
Host: RouteFromFcEvent
Date: GMT Date
Authorization: SignatureValue
x-oss-request-route: RouteFromFcEvent
x-oss-request-token: TokenFromFcEvent
x-oss-fwd-status: StatusCode
x-oss-fwd-header-Accept-Ranges: AcceptRanges
x-oss-fwd-header-Cache-Control: CacheControl
x-oss-fwd-header-Content-Disposition: ContentDisposition
x-oss-fwd-header-Content-Encoding: ContentEncoding
x-oss-fwd-header-Content-Language: ContentLanguage
Content-Length: ContentLength
x-oss-fwd-header-Content-Range: ContentRange
x-oss-fwd-header-Content-Type: ContentType
x-oss-fwd-header-ETag: ETag
x-oss-fwd-header-Expires: Expires
x-oss-fwd-header-Last-Modified: LastModified

Parâmetros dos cabeçalhos da solicitação

Cabeçalho

Tipo

Obrigatório

Exemplo

Descrição

Host

String

Sim

****-opap.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com

Endereço de rota do parâmetro de evento do Function Compute.

Date

String

Sim

Tue, 31 Oct 2023 03:17:58 GMT

Horário de início da solicitação no formato GMT do HTTP 1.1.

Authorization

String

Sim

OSS lkojgn8y1exic6e:6**+BuuEqzI1tAMW0wgIyl**

Autentica a solicitação. Calcule este valor conforme descrito em Incluir assinaturas no cabeçalho Authorization.

x-oss-request-route

String

Sim

****-opap.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com

Endereço de rota do parâmetro de evento do Function Compute.

x-oss-request-token

String

Sim

OSSV1#ZvBDC3XPm3g****

Token de encaminhamento do parâmetro de evento do Function Compute.

x-oss-fwd-status

String

Sim

200

Código de status HTTP do servidor backend.

Valores válidos: 200, 206, 301, 302, 303, 304, 400, 401, 403, 404, 405, 409, 411, 412, 416, 500 e 503.

x-oss-fwd-header-Accept-Ranges

String

Não

bytes

Define o intervalo consultável do recurso.

x-oss-fwd-header-Cache-Control

String

Não

no-cache

Determina o comportamento de cache do cliente. Valores válidos:

  • no-cache: Exige revalidação com o servidor a cada acesso.

  • no-store: Desativa completamente o armazenamento em cache.

  • public: Permite o cache por qualquer sistema.

  • private: Restringe o cache ao cliente.

  • max-age=<seconds>: Validade do cache em segundos. Exclusivo do HTTP 1.1.

x-oss-fwd-header-Content-Disposition

String

Não

attachment

Controla o comportamento de baixe. Valores válidos:

  • Content-Disposition:inline: Visualiza o objeto diretamente no navegador.

  • Content-Disposition:attachment: Baixa o arquivo com o nome original do objeto.

  • Content-Disposition:attachment; filename="yourFileName": Baixa o arquivo com um nome personalizado.

    yourFileName é o nome de arquivo personalizado, como example.jpg.

x-oss-fwd-header-Content-Encoding

String

Não

gzip

Indica a codificação do conteúdo. Valores válidos:

  • identity (padrão): Nenhuma codificação aplicada.

  • gzip: Compressão LZ77 com CRC de 32 bits.

  • compress: Compressão LZW.

  • deflate: Estrutura zlib com compressão deflate.

  • br: Compressão Brotli.

x-oss-fwd-header-Content-Language

String

Não

en

Especifica o idioma do conteúdo.

Content-Length

String

Sim

67589

Tamanho do corpo da mensagem HTTP em bytes.

x-oss-fwd-header-Content-Range

String

Não

bytes 0-9/67589

Define o intervalo de bytes do conteúdo retornado. Por exemplo, bytes 0-9/67589 retorna os primeiros 10 bytes de um objeto de 67.589 bytes.

x-oss-fwd-header-Content-Type

String

Não

text/html; charset=utf-8

Indica o tipo MIME do corpo da resposta.

x-oss-fwd-header-ETag

String

Não

D41D8CD98F00B204E9800998ECF8****

Tag de entidade que identifica o objeto de forma única.

x-oss-fwd-header-Expires

String

Não

Fri, 10 Nov 2023 03:17:58 GMT

Data absoluta de expiração do conteúdo em cache.

x-oss-fwd-header-Last-Modified

String

Não

Tue, 10 Oct 2023 03:17:58 GMT

Data da última modificação do recurso solicitado.

Cabeçalhos da resposta

O WriteGetObjectResponse retorna apenas Cabeçalhos HTTP comuns.

Exemplos

  • Exemplo de solicitação

    POST /?x-oss-write-get-object-response HTTP/1.1
    Host: RouteFromFcEvent
    Date: Tue, 31 Oct 2023 03:17:58 GMT
    Authorization: SignatureValue
    x-oss-request-route: RouteFromFcEvent
    x-oss-request-token: TokenFromFcEvent
    x-oss-fwd-status: 200
    x-oss-fwd-header-Accept-Ranges: bytes
    x-oss-fwd-header-Cache-Control: no-cache
    x-oss-fwd-header-Content-Disposition: attachment
    x-oss-fwd-header-Content-Encoding: gzip
    x-oss-fwd-header-Content-Language: en
    Content-Length: 67589
    x-oss-fwd-header-Content-Range: bytes 0-9/67589
    x-oss-fwd-header-Content-Type: text/html; charset=utf-8
    x-oss-fwd-header-ETag: D41D8CD98F00B204E9800998ECF8****
    x-oss-fwd-header-Expires: Fri, 10 Nov 2023 03:17:58 GMT
    x-oss-fwd-header-Last-Modified: Tue, 10 Oct 2023 03:17:58 GMT
  • Exemplo de resposta

    HTTP/1.1 200 OK
    x-oss-request-id: 6540CF0DCB24453133A****
    Date: Tue, 31 Oct 2023 03:17:58 GMT
    Content-Length: 0