全部产品
Search

搜索本产品

    对象存储 OSS：WriteGetObjectResponse

    文档中心

    对象存储 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