全部产品
Search
文档中心

对象存储 OSS:WriteGetObjectResponse

更新时间:Nov 01, 2023

调用WriteGetObjectResponse接口自定义返回数据和响应标头。

前提条件

为已创建函数计算服务关联的默认角色(AliyunFCDefaultRole)授予oss:WriteGetObjectResponse权限。具体的权限策略如下:

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

具体步骤,请参见为RAM角色授权

请求头

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

请求头

名称

类型

是否必选

示例值

描述

Host

字符串

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

从函数计算Event内容中获取的路由转发地址。

Date

字符串

Tue, 31 Oct 2023 03:17:58 GMT

发起请求的时间,格式为HTTP 1.1协议中规定的GMT时间。

Authorization

字符串

OSS lkojgn8y1exic6e:6****+BuuEqzI1tAMW0wgIyl****

用于验证请求合法性的认证信息。关于Authorization计算方法的更多信息,请参见在Header中包含签名

x-oss-request-route

字符串

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

从函数计算Event内容中获取的路由转发地址。

x-oss-request-token

字符串

OSSV1#ZvBDC3XPm3g****

从函数计算Event内容中获取的唯一转发token。

x-oss-fwd-status

字符串

200

请求转发后端返回的状态码。

取值为:200、206、301、302、303、304、400、401、403、404、405、409、411、412、416、500和503。

x-oss-fwd-header-Accept-Ranges

字符串

bytes

请求转发后端服务器返回的HTTP响应头部字段之一,用来指定获取资源的范围或部分内容。

x-oss-fwd-header-Cache-Control

字符串

no-cache

请求转发后端服务器返回的HTTP响应头部字段之一,用来指定客户端如何缓存响应的内容。取值如下:

  • no-cache:不可直接使用缓存,而是先到服务端验证Object是否已更新。如果Object已更新,表明缓存已过期,需从服务端重新下载Object;如果Object未更新,表明缓存未过期,此时将使用本地缓存。

  • no-store:所有内容都不会被缓存。

  • public:所有内容都将被缓存。

  • private:所有内容只在客户端缓存。

  • max-age=<seconds>:缓存内容的相对过期时间,单位为秒。此选项仅在HTTP 1.1中可用。

x-oss-fwd-header-Content-Disposition

字符串

attachment

请求转发后端服务器返回的HTTP响应头部字段之一,用来指定将要被下载的文件的名称和处理方式。取值如下:

  • Content-Disposition:inline:直接预览文件内容。

  • Content-Disposition:attachment:以原文件名的形式下载到浏览器指定路径。

  • Content-Disposition:attachment; filename="yourFileName":以自定义文件名的形式下载到浏览器指定路径。

    yourFileName用于自定义下载后的文件名称,例如example.jpg。

x-oss-fwd-header-Content-Encoding

字符串

gzip

请求转发后端服务器返回的HTTP响应头部字段之一,用来指示服务器对返回内容的编码压缩类型。取值如下:

  • identity(默认值):表示Object未经过压缩或编码。

  • gzip:表示Object采用Lempel-Ziv(LZ77)压缩算法以及32位CRC校验的编码方式。

  • compress:表示Object采用Lempel-Ziv-Welch(LZW)压缩算法的编码方式。

  • deflate:表示Object采用zlib结构和deflate压缩算法的编码方式。

  • br:表示Object采用Brotli算法的编码方式。

x-oss-fwd-header-Content-Language

字符串

en

请求转发后端服务器返回的HTTP响应头部字段之一,用来指示返回的实体内容所使用的语言。

Content-Length

字符串

67589

请求转发后端服务器返回的HTTP响应头部字段之一,用来描述HTTP消息体的传输大小,单位为字节。

x-oss-fwd-header-Content-Range

字符串

bytes 0-9/67589

请求转发后端服务器返回的HTTP响应头部字段之一,用来指定文件传输的范围。例如Content-Range: bytes 0-9/67589,表示整个Object大小为67589,此次返回的范围为0~9。

x-oss-fwd-header-Content-Type

字符串

text/html; charset=utf-8

请求转发后端服务器返回的HTTP响应头部字段之一,用于指示发送或接收数据的类型。

x-oss-fwd-header-ETag

字符串

D41D8CD98F00B204E9800998ECF8****

请求转发后端服务器返回的HTTP响应头部字段之一,作为对象内容的唯一标识符。

x-oss-fwd-header-Expires

字符串

Fri, 10 Nov 2023 03:17:58 GMT

请求转发后端服务器返回的HTTP响应头部字段之一,表示缓存内容的绝对过期时间。

x-oss-fwd-header-Last-Modified

字符串

Tue, 10 Oct 2023 03:17:58 GMT

请求转发后端服务器返回的HTTP响应头部字段之一,表示请求资源的最后修改时间。

响应头

此接口仅包含公共响应头。更多信息,请参见公共响应头(Common Response Headers)

示例

  • 请求示例

    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
  • 返回示例

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