Specifies the return data and response headers for a GetObject request.
Prerequisites
The oss:WriteGetObjectResponse
permission is granted to the default role (AliyunFCDefaultRole) of the service you created in the Function Compute console. Sample permission policy:
{
"Statement": [
{
"Action": "oss:WriteGetObjectResponse",
"Effect": "Allow",
"Resource": "*"
}
],
"Version": "1"
}
For more information, see Grant permissions to a RAM role.
Request headers
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
Request headers
Header | Type | Required | Example | Description |
Host | String | Yes | ****-opap.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com | The router forwarding address obtained from the event parameter of Function Compute. |
Date | String | Yes | Tue, 31 Oct 2023 03:17:58 GMT | The time when the request was initiated. The time is in GMT specified by HTTP 1.1. |
Authorization | String | Yes | OSS lkojgn8y1exic6e:6****+BuuEqzI1tAMW0wgIyl**** | The authentication information used to verify the validity of the request. For more information about how to calculate the Authorization header, see Include signatures in the Authorization header. |
x-oss-request-route | String | Yes | ****-opap.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com | The router forwarding address obtained from the event parameter of Function Compute. |
x-oss-request-token | String | Yes | OSSV1#ZvBDC3XPm3g**** | The unique forwarding token obtained from the event parameter of Function Compute. |
x-oss-fwd-status | String | Yes | 200 | The HTTP status code returned by the backend server. Valid values: 200, 206, 301, 302, 303, 304, 400, 401, 403, 404, 405, 409, 411, 412, 416, 500, and 503. |
x-oss-fwd-header-Accept-Ranges | String | No | bytes | The HTTP response header returned by the backend server. It is used to specify the scope of the resources that you want to query. |
x-oss-fwd-header-Cache-Control | String | No | no-cache | The HTTP response header returned by the backend server. It is used to specify the resource cache method that the client uses. Valid values:
|
x-oss-fwd-header-Content-Disposition | String | No | attachment | The HTTP response header returned by the backend server. It is used to specify the name of the object to download and whether and how the object is downloaded. Valid values:
|
x-oss-fwd-header-Content-Encoding | String | No | gzip | The HTTP response header returned by the backend server. It is used to specify the compression and encoding method of the downloaded object. Valid values:
|
x-oss-fwd-header-Content-Language | String | No | en | The HTTP response header returned by the backend server. It is used to specify the language of the downloaded object. |
Content-Length | String | Yes | 67589 | The HTTP response header returned by the backend server. It is used to specify the size of the HTTP message body. Unit: bytes. |
x-oss-fwd-header-Content-Range | String | No | bytes 0-9/67589 | The HTTP response header returned by the backend server. It is used to specify the range of the object that you want to query. For example, if the Content-Range header is set to bytes 0-9/67589, the size of the entire object is 67589 and the content of the first 10 bytes (0 to 9) is returned. |
x-oss-fwd-header-Content-Type | String | No | text/html; charset=utf-8 | The HTTP response header returned by the backend server. It is used to specify the type of the received or sent data. |
x-oss-fwd-header-ETag | String | No | D41D8CD98F00B204E9800998ECF8**** | The HTTP response header returned by the backend server. It uniquely identifies the object. |
x-oss-fwd-header-Expires | String | No | Fri, 10 Nov 2023 03:17:58 GMT | The HTTP response header returned by the backend server. It specifies the absolute expiration time of the cache. |
x-oss-fwd-header-Last-Modified | String | No | Tue, 10 Oct 2023 03:17:58 GMT | The HTTP response header returned by the backend server. It specifies the time when the requested resource was last modified. |
Response headers
The response to a WriteGetObjectResponse request contains only common response headers. For more information, see Common HTTP headers.
Examples
Sample request
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
Sample response
HTTP/1.1 200 OK x-oss-request-id: 6540CF0DCB24453133A**** Date: Tue, 31 Oct 2023 03:17:58 GMT Content-Length: 0