get-object_对象存储(OSS)-阿里云帮助中心

您可以通过API级命令获取存储空间（Bucket）中的某个文件（Object）。

注意事项

GetObject接口默认可通过HTTP和HTTPS两种方式访问。如果要设置仅允许通过HTTPS方式访问，请使用Bucket Policy的授权访问方式。具体操作，请参见通过Bucket Policy授权用户访问指定资源。
如果Object类型为归档类型，需要先完成解冻文件（RestoreObject）请求，且该请求不能超时。

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明

API	Action	说明
GetObject	`oss:GetObject`	下载Object。
	`oss:GetObjectVersion`	下载Object时，如果通过versionId指定了Object的版本，则需要授予此操作的权限。
	`kms:Decrypt`	下载Object时，如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS，则需要此操作的权限。

ossutil api get-object --bucket value --key value [flags]

参数	类型	说明

参数	类型	说明
--accept-encoding	string	指定客户端的编码类型。
--bucket	string	Bucket名称。
--if-match	string	如果传入期望的ETag和Object的ETag匹配，则返回200 OK和Object Meta；否则返回412 precondition failed。
--if-modified-since	string	如果传入参数中的时间早于实际修改时间，则返回200 OK和Object Meta；否则返回304 not modified。
--if-none-match	string	如果传入期望的ETag值和Object的ETag不匹配，则返回200 OK和Object Meta；否则返回304 Not Modified。
--if-unmodified-since	string	如果传入参数中的时间等于或者晚于文件实际修改时间，则返回200 OK和Object Meta；否则返回412 Precondition Failed。
--key	string	Object的完整路径。
--range	stringArray	指定文件传输的范围。
--response-cache-control	string	指定OSS返回请求的cache-control头。
--response-content-disposition	string	指定OSS返回请求的content-disposition头。
--response-content-encoding	string	指定OSS返回请求的content-encoding头。
--response-content-language	string	指定OSS返回请求的content-language头。
--response-expires	string	指定OSS返回请求的expires头。
--version-id	string	请求解冻的Object的版本号。

说明

获取examplebucket存储空间下的exampleobject文件。

ossutil api get-object --bucket examplebucket --key exampleobject

获取examplebucket存储空间下的版本号为123的exampleobject文件。

ossutil api get-object --bucket examplebucket --key exampleobject --version-id 123

获取examplebucket存储空间下的exampleobject指定文件范围内容。

ossutil api get-object --bucket examplebucket --key exampleobject --range bytes=1-10

获取examplebucket存储空间下的exampleobject，如果exampleobject的修改时间早于 Mon, 11 May 2020 08:16:23 GMT则返回object。
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-modified-since "Mon, 11 May 2020 08:16:23 GMT"
```
获取examplebucket存储空间下的exampleobject，如果exampleobject的ETag等于123则返回object。
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123
```
获取examplebucket存储空间下的exampleobject，对返回内容进行Gzip压缩传输。
```
ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip
```