pub struct GetObjectOptions {
pub range: Option<String>,
pub if_modified_since: Option<String>,
pub if_unmodified_since: Option<String>,
pub if_match: Option<String>,
pub if_none_match: Option<String>,
pub accept_encoding: Option<String>,
pub response_content_language: Option<String>,
pub response_expires: Option<String>,
pub response_cache_control: Option<String>,
pub response_content_disposition: Option<String>,
pub response_content_encoding: Option<ContentEncoding>,
pub version_id: Option<String>,
}Expand description
Options for getting object
Official document: https://help.aliyun.com/zh/oss/developer-reference/getobject
Fields§
§range: Option<String>指定文件传输的范围。
- 如果指定的范围符合规范,返回消息中会包含整个 Object 的大小和此次返回 Object 的范围。例如:
Content-Range: bytes 0~9/44,表示整个 Object 大小为44,此次返回的范围为0~9。 - 如果指定的范围不符合规范,则传送整个 Object,并且结果中不包含
Content-Range。
if_modified_since: Option<String>GMT 日期时间字符串,例如:Fri, 13 Nov 2015 14:47:53 GMT
如果指定的时间早于实际修改时间或指定的时间不符合规范,则直接返回 Object,并返回 200 OK;
如果指定的时间等于或者晚于实际修改时间,则返回 304 Not Modified。
if_unmodified_since: Option<String>GMT 日期时间字符串,例如:Fri, 13 Nov 2015 14:47:53 GMT
如果指定的时间等于或者晚于 Object 实际修改时间,则正常传输 Object,并返回 200 OK;
如果指定的时间早于实际修改时间,则返回 412 Precondition Failed。
If-Modified-Since 和 If-Unmodified-Since 可以同时使用。
if_match: Option<String>ETag 值
如果传入的 ETag 和 Object 的 ETag 匹配,则正常传输 Object,并返回 200 OK;
如果传入的 ETag 和 Object 的 ETag 不匹配,则返回 412 Precondition Failed。
if_none_match: Option<String>ETag 值
如果传入的 ETag 值和 Object 的 ETag 不匹配,则正常传输 Object,并返回 200 OK;
如果传入的 ETag 和 Object 的 ETag 匹配,则返回 304 Not Modified。
If-Match 和 If-None-Match 可以同时使用。
accept_encoding: Option<String>指定客户端的编码类型。例如:gzip
如果要对返回内容进行 Gzip 压缩传输,您需要在请求头中以显示方式加入 Accept-Encoding:gzip。
OSS 会根据 Object 的 Content-Type 和 Object 大小(不小于1KB),
判断传输过程中是否对数据进行 Gzip 压缩。满足条件时,数据以压缩形式传输,否则,数据以原始形式传输。
注意:
- 如果采用了 Gzip 压缩且压缩生效,则不会附带
ETag和Content-Length信息。 - 目前 OSS 支持对以下
Content-Type类型的数据进行 Gzip 压缩:- text/cache-manifest
- text/xml
- text/css
- text/html
- text/plain
- application/javascript
- application/x-javascript
- application/rss+xml
- application/json
- text/json
response_content_language: Option<String>Add Content-Language to response header
response_expires: Option<String>Add Expires to response header
response_cache_control: Option<String>Add Cache-Control to response header
response_content_disposition: Option<String>Add Content-Disposition to response header
response_content_encoding: Option<ContentEncoding>Add Content-Encoding to response header
version_id: Option<String>The version to retreive