控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

有奖征文|投稿上云技术实践,赢取价值5000元大奖> HOT

简介

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

API 操作名 操作描述
HEAD Object 查询对象元数据 查询对象的元数据信息

SDK API 参考

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

查询对象元数据

功能说明

查询 Object 的 Meta 信息。

示例代码

Objective-C

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 = [[outputObject __originHTTPURLResponse__].allHeaderFields valueForKey:@"x-cos-hash-crc64ecma"];
}];

[[QCloudCOSXMLService defaultCOSXML] HeadObject:headerRequest];

说明:

更多完整示例,请前往 GitHub 查看。

Swift

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?.__originHTTPURLResponse__.allHeaderFields["x-cos-hash-crc64ecma"];

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

说明:

更多完整示例,请前往 GitHub 查看。

目录