更新时间:2026-01-15 GMT+08:00

获取对象元数据

功能说明

对指定桶中的对象发送HEAD请求,获取对象的元数据信息。

方法定义

1. ObsClient->getObjectMetadata(array $parameter)
2. ObsClient->getObjectMetadataAsync(array $parameter, callable $callback)

请求参数

字段名

类型

约束

说明

Bucket

string

必选

桶名。

Key

string

必选

对象名。

VersionId

string

可选

对象的版本号。

Origin

string

可选

预请求指定的跨域请求Origin(通常为域名)。

RequestHeader

string

可选

跨域请求可以使用的HTTP头域。

返回结果

字段名

类型

说明

HttpStatusCode

integer

HTTP状态码。

Reason

string

HTTP文本描述。

RequestId

string

OBS服务端返回的请求ID。

LastModified

string

对象的最近一次修改时间。

ContentLength

integer

对象数据的长度。

ContentType

string

对象的MIME类型,常见的contentType(MIME)列表参见。

ETag

string

对象的ETag值。

VersionId

string

对象的版本号。

WebsiteRedirectLocation

string

当桶设置了Website配置,该参数指明对象的重定向地址。

StorageClass

string

对象的存储类型,当对象存储类型是标准存储时,该值为空。

Restore

string

冷存储类型对象的恢复状态。

AllowOrigin

string

如果请求中的Origin满足桶的CORS规则,则返回CORS规则中的AllowedOrigin。

AllowHeader

string

如果请求的RequestHeader满足桶的CORS规则,则返回CORS规则中的AllowedHeader。

AllowMethod

string

桶CORS规则中的AllowedMethod。

ExposeHeader

string

桶CORS规则中的ExposeHeader。

MaxAgeSeconds

integer

桶CORS规则中的MaxAgeSeconds。

Expiration

string

对象的详细过期信息。

Metadata

associative array

对象自定义元数据。

代码样例

try {
       $resp = $obsClient->getObjectMetadata( [ 
              'Bucket' => 'bucketname',
              'Key' => 'objectkey'
       ] );
       printf ( "RequestId:%s\n", $resp ['RequestId'] );
       printf ( "ETag:%s\n", $resp ['ETag'] );
       printf ( "VersionId:%s\n", $resp ['VersionId'] );
       printf ( "ContentLength:%s\n", $resp ['ContentLength'] );
       printf ( "LastModified:%s\n", $resp ['LastModified'] );
       printf ( "Expiration:%s\n", $resp ['Expiration'] );
       printf ( "StorageClass:%s\n", $resp ['StorageClass'] );
} catch ( Obs\Common\ObsException $obsException ) {
       printf ( "ExceptionCode:%s\n", $obsException->getExceptionCode () );
       printf ( "ExceptionMessage:%s\n", $obsException->getExceptionMessage () );
}