Todos los productos
Search
Centro de documentos

Object Storage Service:WriteGetObjectResponse

Última actualización: Sep 03, 2026

Personaliza los datos de respuesta y los encabezados para una solicitud GetObject procesada mediante Function Compute.

Requisitos previos

Otorgue el permiso oss:WriteGetObjectResponse al rol predeterminado (AliyunFCDefaultRole) de su servicio Function Compute. Directiva de ejemplo:

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

Grant permissions to a RAM role.

Encabezados de solicitud

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 de encabezado de solicitud

Encabezado

Tipo

Obligatorio

Ejemplo

Descripción

Host

String

Sí

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

Dirección de ruta obtenida del parámetro de evento de Function Compute.

Date

String

Sí

Tue, 31 Oct 2023 03:17:58 GMT

Hora de inicio de la solicitud en formato GMT de HTTP 1.1.

Authorization

String

Sí

OSS lkojgn8y1exic6e:6**+BuuEqzI1tAMW0wgIyl**

Autentica la solicitud. Calcule este valor como se describe en Include signatures in the Authorization header.

x-oss-request-route

String

Sí

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

Dirección de ruta obtenida del parámetro de evento de Function Compute.

x-oss-request-token

String

Sí

OSSV1#ZvBDC3XPm3g****

Token de reenvío obtenido del parámetro de evento de Function Compute.

x-oss-fwd-status

String

Sí

200

Código de estado HTTP del servidor backend.

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

x-oss-fwd-header-Accept-Ranges

String

No

bytes

Especifica el rango consultable del recurso.

x-oss-fwd-header-Cache-Control

String

No

no-cache

Define el comportamiento de caché del cliente. Valores válidos:

  • no-cache: Fuerza la revalidación con el servidor en cada acceso.

  • no-store: Deshabilita la caché por completo.

  • public: Permite el almacenamiento en cualquier caché.

  • private: Permite el almacenamiento únicamente en el cliente.

  • max-age=<seconds>: Periodo de validez de la caché en segundos. Solo HTTP 1.1.

x-oss-fwd-header-Content-Disposition

String

No

attachment

Controla el comportamiento de descarga. Valores válidos:

  • Content-Disposition:inline: Muestra una vista previa del objeto en el navegador.

  • Content-Disposition:attachment: Descarga el archivo con el nombre original del objeto.

  • Content-Disposition:attachment; filename="yourFileName": Descarga el archivo con un nombre personalizado.

    yourFileName es el nombre de archivo personalizado, por ejemplo, example.jpg.

x-oss-fwd-header-Content-Encoding

String

No

gzip

Especifica la codificación del contenido. Valores válidos:

  • identity (predeterminado): No se aplica ninguna codificación.

  • gzip: Compresión LZ77 con CRC de 32 bits.

  • compress: Compresión LZW.

  • deflate: Estructura zlib con compresión deflate.

  • br: Compresión Brotli.

x-oss-fwd-header-Content-Language

String

No

en

Especifica el idioma del contenido.

Content-Length

String

Sí

67589

Tamaño del cuerpo del mensaje HTTP en bytes.

x-oss-fwd-header-Content-Range

String

No

bytes 0-9/67589

Especifica el rango de bytes del contenido devuelto. Por ejemplo, bytes 0-9/67589 devuelve los primeros 10 bytes de un objeto de 67,589 bytes.

x-oss-fwd-header-Content-Type

String

No

text/html; charset=utf-8

Especifica el tipo MIME del cuerpo de la respuesta.

x-oss-fwd-header-ETag

String

No

D41D8CD98F00B204E9800998ECF8****

Etiqueta de entidad que identifica de forma única al objeto.

x-oss-fwd-header-Expires

String

No

Fri, 10 Nov 2023 03:17:58 GMT

Tiempo de caducidad absoluto del contenido en caché.

x-oss-fwd-header-Last-Modified

String

No

Tue, 10 Oct 2023 03:17:58 GMT

Última hora de modificación del recurso solicitado.

Encabezados de respuesta

WriteGetObjectResponse solo devuelve Common HTTP headers.

Ejemplos

  • Solicitud de ejemplo

    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
  • Respuesta de ejemplo

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