全部產品
Search
文件中心

Object Storage Service:WriteGetObjectResponse

更新時間:Feb 28, 2024

調用WriteGetObjectResponse介面自訂返回資料和響應標題。

前提條件

為已建立Function Compute服務關聯的預設角色(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

從Function ComputeEvent內容中擷取的路由轉寄地址。

Date

字串

Tue, 31 Oct 2023 03:17:58 GMT

發起請求的時間,格式為HTTP 1.1協議中規定的GMT時間。

Authorization

字串

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

用於驗證請求合法性的認證資訊。關於Authorization計算方法的更多資訊,請參見簽名版本1

x-oss-request-route

字串

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

從Function ComputeEvent內容中擷取的路由轉寄地址。

x-oss-request-token

字串

OSSV1#ZvBDC3XPm3g****

從Function ComputeEvent內容中擷取的唯一轉寄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