HeadObject
获取某个文件（Object）的元信息
服务地址：
华北2（北京）
输入参数
只看必填
bucketBucket名称
keyObject的完整路径
versionId请求Object的版本号
If-Modified-Since如果传入参数中的时间早于实际修改时间
If-Unmodified-Since如果传入参数中的时间等于或者晚于文件实...
If-Match如果传入期望的ETag和Object的...
If-None-Match如果传入期望的ETag值和Object...
插件下载了解更多
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.
安 装

接口说明

  • 使用此接口不会返回文件内容。

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

请求语法

HEAD /{key} HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
If-Modified-Since: string
If-Unmodified-Since: string
If-Match: string
If-None-Match: string

路径参数

字段名称字段详情
keystring

Object 的完整路径。

示例值:exampledir/exampleobject/txt

请求参数

字段名称字段详情
bucketstring

Bucket 名称。

示例值:examplebucket
versionIdstring

请求 Object 的版本号。

示例值:CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx****
If-Modified-Sincestring

如果传入参数中的时间早于实际修改时间，则返回 200 OK 和 Object Meta；否则返回 304 not modified。展开详情

示例值:Fri, 9 Apr 2021 14:47:53 GMT
If-Unmodified-Sincestring

如果传入参数中的时间等于或者晚于文件实际修改时间，则返回 200 OK 和 Object Meta；否则返回 412 precondition failed。展开详情

示例值:Fri, 13 Oct 2021 14:47:53 GMT
If-Matchstring

如果传入期望的 ETag 和 Object 的 ETag 匹配，则返回 200 OK 和 Object Meta；否则返回 412 precondition failed。展开详情

示例值:fba9dede5f27731c9771645a3986****
If-None-Matchstring

如果传入期望的 ETag 值和 Object 的 ETag 不匹配，则返回 200 OK 和 Object Meta；否则返回 304 Not Modified。展开详情

示例值:5B3C1A2E0563E1B002CC607C****

返回参数

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