head-object

head-object用于获取某个文件（Object）的元信息。

注意事项

使用此命令不会返回文件内容。

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

API	Action	说明
HeadObject	`oss:GetObject`	获取某个Object的元数据。

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

参数	类型	说明
--bucket	string	Bucket名称。
--key	string	Object的完整路径。
--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。
--version-id	string	Obejct的版本号。

说明

获取exampleobject对象的元信息。

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

获取exampleobject对象的元信息，以JSON格式显示。

ossutil api head-object --bucket examplebucket --key exampleobject --output-format json

获取版本号为123的exampleobject的元信息。

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

获取exampleobject对象且ETag等于123的元信息。

ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123

获取exampleobject对象且对象实际修改时间早于"Thu, 11 Jul 2024 06:36:31 GMT"的元信息。

ossutil api head-object --bucket examplebucket --key exampleobject --if-modified-since "Thu, 11 Jul 2024 06:36:31 GMT"

您可以通过API级命令获取存储空间（Bucket）中的某个文件（Object）。注意事项 GetObject接口默认可通过HTTP和HTTPS两种方式访问。如果要设置仅允许通过HTTPS方式访问，请使用Bucket Policy的授权访问方式。具体操作，请参见通过Bucket Policy授权用户

copy-object用于拷贝同一地域下相同或不同存储空间（Bucket）之间的文件（Object）。注意事项如果需要恢复Object的早期版本为当前版本，您只需将Object的早期版本拷贝到同一个Bucket中，OSS会将该Object对应的早期版本置为当前版本。<