GetObjectMeta
获取文件（Object）的元数据信息，包括该Object的ETag、Size、LastModified信息，并且不返回该Object的内容
服务地址：
华东1 金融云
输入参数
只看必填
bucketBucket名称
keyObject的完整路径
versionIdObject的版本ID
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

注意事项

  • 文件（Object）的元数据信息包括该 Object 的 ETag、Size、LastModified 信息，且不返回该 Object 的内容。如果 Object 类型为软链接，则会返回软链接自身信息。
  • 当 Bucket 未启用版本控制时，要获取文件的元数据信息，您必须有 oss:GetObject 权限。当 Bucket 已启用版本控制时，要获取文件指定版本（请求中携带了 x-oss-version-id 请求头）的元数据信息，您必须有 oss:GetObjectVersion 权限。具体操作，请参见为 RAM 用户授权自定义的 RAM Policy。

版本控制

GetObjectMeta 操作默认获取 Object 当前版本的元数据信息。如果 Object 的当前版本为删除标记，则返回 404 Not Found。请求参数中指定 versionId 则返回指定版本 Object 的元数据信息。

请求语法

HEAD /{key}?objectMeta HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com

路径参数

字段名称字段详情
keystring

Object 的完整路径。

示例值:exampledir/exampleobject.txt

请求参数

字段名称字段详情
bucketstring

Bucket 名称。

示例值:examplebucket
versionIdstring

Object 的版本 ID。只有查看 Object 指定版本的元数据信息时才显示该字段。

示例值:CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****

返回参数

变更历史
变更时间变更内容概要操作
2024-10-10
变更返回参数