WriteGetObjectResponse_对象存储(OSS)-阿里云帮助中心

调用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