接口说明
注意事项
-
GetObject 接口默认可通过 HTTP 和 HTTPS 两种方式访问。如果要设置仅允许通过 HTTPS 方式访问，请使用 Bucket Policy 的授权访问方式。具体操作，请参见通过 Bucket Policy 授权用户访问指定资源。
-
如果 Object 类型为归档类型，需要先完成解冻文件（RestoreObject）请求，且该请求不能超时。
版本控制
默认情况下，调用 GetObject 接口仅返回 Object 的当前版本。 如果在查询参数中指定 Object 的 versionId，则返回指定的 Object 版本。当 versionId 指定为 null 时，则返回 versionId 为 null 的 Object 版本。
流控信息
请求语法
GET /{key} HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Range: string
If-Modified-Since: string
If-Unmodified-Since: string
If-Match: string
If-None-Match: string
Accept-Encoding: string
路径参数
| 字段名称 | 字段详情 |
|---|---|
keystring | Object 的完整路径。 示例值:exampledir/exampleobject/txt |
请求参数
| 字段名称 | 字段详情 |
|---|---|
bucketstring | Bucket 名称。 示例值:examplebucket |
response-content-typestring | 指定 OSS 返回请求的 content-type 头。 示例值:image/jpg |
response-content-languagestring | 指定 OSS 返回请求的 content-language 头。 示例值:中文 |
response-expiresstring | 指定 OSS 返回请求的 expires 头。 示例值:Fri, 24 Feb 2012 17:00:00 GMT |
response-cache-controlstring | 指定 OSS 返回请求的 cache-control 头。 示例值:no-cache |
response-content-dispositionstring | 指定 OSS 返回请求的 content-disposition 头。 示例值:attachment; filename:testing.txt |
response-content-encodingstring | 指定 OSS 返回请求的 content-encoding 头。 示例值:utf-8 |
Rangestring | 指定文件传输的范围。展开详情 示例值:Content-Range: bytes 100-900/344606 |
If-Modified-Sincestring | 如果指定的时间早于实际修改时间或指定的时间不符合规范，则直接返回 Object，并返回 200 OK；如果指定的时间等于或者晚于实际修改时间，则返回 304 Not Modified。展开详情 示例值:Fri, 13 Nov 2015 14:47:53 GMT |
If-Unmodified-Sincestring | 如果指定的时间等于或者晚于 Object 实际修改时间，则正常传输 Object，并返回 200 OK；如果指定的时间早于实际修改时间，则返回 412 Precondition展开详情 示例值:Fri, 13 Nov 2015 14:47:53 GMT |
If-Matchstring | 如果传入的 ETag 和 Object 的 ETag 匹配，则正常传输 Object，并返回 200 OK；如果传入的 ETag 和 Object 的 ETag 不匹配，则返回 412 Precondition Failed。展开详情 示例值:fba9dede5f27731c9771645a3986**** |
If-None-Matchstring | 如果传入的 ETag 值和 Object 的 ETag 不匹配，则正常传输 Object，并返回 200 OK；如果传入的 ETag 和 Object 的 ETag 匹配，则返回 304 Not Modified。展开详情 示例值:5B3C1A2E0563E1B002CC607C**** |
Accept-Encodingstring | 指定客户端的编码类型。展开详情 示例值:gzip |
versionIdstring | 目标文件的版本 ID。 示例值:CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0**** |
返回参数
| 字段名称 | 字段详情 |
|---|---|
string<binary> | 对象关联的标签的个数。仅当有读取标签权限时返回。 示例值:10 |