查询对象元数据

最近更新时间:2024-08-05 10:56:01

我的收藏

简介

本文档提供关于查询对象元数据操作相关的 API 概览以及 SDK 示例代码。

注意事项

若您想查询目标对象的元数据,需要具有目标对象的读取权限:在您进行 授权策略 时,action 需要设置为cos:HeadObject,更多授权请参见 支持CAM的业务接口

相关示例

功能名称
描述
示例代码
查询对象元数据
提供了查询对象元数据的功能。

查询对象元数据

功能说明

查询 Object 的 Meta 信息。

使用案例

Objective-C
Swift
QCloudHeadObjectRequest* headerRequest = [QCloudHeadObjectRequest new];

// 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "video/xxx/movie.mp4"
headerRequest.object = @"exampleobject";

// versionId 当启用版本控制时,指定要查询的版本 ID,如不指定则查询对象的最新版本
headerRequest.versionID = @"versionID";

// 存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
headerRequest.bucket = @"examplebucket-1250000000";

[headerRequest setFinishBlock:^(NSDictionary* result, NSError *error) {
// result 返回具体信息
// 获取文件crc64
NSString * crc64 = [[result __originHTTPURLResponse__].allHeaderFields valueForKey:@"x-cos-hash-crc64ecma"];
}];

[[QCloudCOSXMLService defaultCOSXML] HeadObject:headerRequest];
let headObject = QCloudHeadObjectRequest.init();

// 存储桶名称,由BucketName-Appid 组成,可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket
headObject.bucket = "examplebucket-1250000000";

// versionId 当启用版本控制时,指定要查询的版本 ID,如不指定则查询对象的最新版本
headObject.versionID = "versionID";

// 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "video/xxx/movie.mp4"
headObject.object = "exampleobject";
headObject.finishBlock = {(result,error) in
if let result = result {
// 获取文件crc64
let crc64 = (result as? NSObject)?.__originHTTPURLResponse__.allHeaderFields["x-cos-hash-crc64ecma"];

} else {
print(error!);
}
}
QCloudCOSXMLService.defaultCOSXML().headObject(headObject);

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 SDK API

API 操作

查询对象元数据涉及的 API 接口说明,请参见 HEAD Object 文档。