全部產品
Search

搜尋本產品

    Object Storage Service：WriteGetObjectResponse

    文件中心

    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