Tous les produits
Search
Centre de documentation

Object Storage Service:WriteGetObjectResponse

Dernière mise à jour :Aug 08, 2026

Personnalise les données et les en-têtes de la réponse pour une requête GetObject traitée via Function Compute.

Prérequis

Accordez l'autorisation oss:WriteGetObjectResponse au rôle par défaut (AliyunFCDefaultRole) de votre service Function Compute. Exemple de politique :

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

Accorder des autorisations à un rôle RAM.

En-têtes de requête

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

Paramètres des en-têtes de requête

En-tête

Type

Obligatoire

Exemple

Description

Host

String

Oui

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

Adresse de routage issue du paramètre d'événement Function Compute.

Date

String

Oui

Tue, 31 Oct 2023 03:17:58 GMT

Heure de début de la requête au format HTTP 1.1 GMT.

Authorization

String

Oui

OSS lkojgn8y1exic6e:6**+BuuEqzI1tAMW0wgIyl**

Authentifie la requête. Calculez cette valeur comme décrit dans Inclure les signatures dans l'en-tête Authorization.

x-oss-request-route

String

Oui

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

Adresse de routage issue du paramètre d'événement Function Compute.

x-oss-request-token

String

Oui

OSSV1#ZvBDC3XPm3g****

Jeton de transfert issu du paramètre d'événement Function Compute.

x-oss-fwd-status

String

Oui

200

Code d'état HTTP provenant du serveur backend.

Valeurs valides : 200, 206, 301, 302, 303, 304, 400, 401, 403, 404, 405, 409, 411, 412, 416, 500 et 503.

x-oss-fwd-header-Accept-Ranges

String

Non

bytes

Spécifie la plage de ressources pouvant faire l'objet d'une requête partielle.

x-oss-fwd-header-Cache-Control

String

Non

no-cache

Définit le comportement de mise en cache côté client. Valeurs valides :

  • no-cache : Force la revalidation avec le serveur à chaque accès.

  • no-store : Désactive entièrement la mise en cache.

  • public : Autorise la mise en cache par n'importe quel cache.

  • private : Autorise la mise en cache uniquement sur le client.

  • max-age=<seconds> : Durée de validité du cache en secondes. Uniquement pour HTTP 1.1.

x-oss-fwd-header-Content-Disposition

String

Non

attachment

Contrôle le comportement de téléchargement. Valeurs valides :

  • Content-Disposition:inline : Affiche un aperçu de l'objet dans le navigateur.

  • Content-Disposition:attachment : Télécharge l'objet avec son nom d'origine.

  • Content-Disposition:attachment; filename="yourFileName" : Télécharge l'objet avec un nom personnalisé.

    yourFileName correspond au nom de fichier personnalisé, par exemple example.jpg.

x-oss-fwd-header-Content-Encoding

String

Non

gzip

Spécifie l'encodage du contenu. Valeurs valides :

  • identity (par défaut) : Aucun encodage appliqué.

  • gzip : Compression LZ77 avec CRC 32 bits.

  • compress : Compression LZW.

  • deflate : Structure zlib avec compression deflate.

  • br : Compression Brotli.

x-oss-fwd-header-Content-Language

String

Non

en

Spécifie la langue du contenu.

Content-Length

String

Oui

67589

Taille du corps du message HTTP en octets.

x-oss-fwd-header-Content-Range

String

Non

bytes 0-9/67589

Spécifie la plage d'octets du contenu renvoyé. Par exemple, bytes 0-9/67589 renvoie les 10 premiers octets d'un objet de 67 589 octets.

x-oss-fwd-header-Content-Type

String

Non

text/html; charset=utf-8

Spécifie le type MIME du corps de la réponse.

x-oss-fwd-header-ETag

String

Non

D41D8CD98F00B204E9800998ECF8****

Étiquette d'entité identifiant l'objet de manière unique.

x-oss-fwd-header-Expires

String

Non

Fri, 10 Nov 2023 03:17:58 GMT

Date d'expiration absolue du contenu mis en cache.

x-oss-fwd-header-Last-Modified

String

Non

Tue, 10 Oct 2023 03:17:58 GMT

Date de dernière modification de la ressource demandée.

En-têtes de réponse

WriteGetObjectResponse renvoie uniquement les En-têtes HTTP communs.

Exemples

  • Exemple de requête

    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
  • Exemple de réponse

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