調用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響應頭部字段之一,用來指定客戶端如何緩存響應的內容。取值如下:
|
x-oss-fwd-header-Content-Disposition | 字符串 | 否 | attachment | 請求轉發后端服務器返回的HTTP響應頭部字段之一,用來指定將要被下載的文件的名稱和處理方式。取值如下:
|
x-oss-fwd-header-Content-Encoding | 字符串 | 否 | gzip | 請求轉發后端服務器返回的HTTP響應頭部字段之一,用來指示服務器對返回內容的編碼壓縮類型。取值如下:
|
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