腾讯云对象存储CRC64 校验

简介

数据在客户端和服务器间传输时可能会出现错误，对象存储（Cloud Object Storage，COS）除了可以通过 MD5 和自定义属性 验证数据完整性外，还可以通过 CRC64 检验码来进行数据校验。COS 会对新上传的对象进行 CRC64 计算，并将结果作为对象的属性进行存储，随后在返回的响应头部中携带 x-cos-hash-crc64ecma，该头部表示上传对象的 CRC64 值，根据 ECMA-182标准 计算得到。对于 CRC64 特性上线前就已经存在于 COS 的对象，COS 不会对其计算 CRC64 值，所以获取此类对象时不会返回其 CRC64 值。

操作说明

目前支持 CRC64 的 API 如下：简单上传接口
PUT Object 和 POST Object：用户可在返回的响应头中获得文件 CRC64 校验值。分块上传接口Upload Part：用户可以根据 COS 返回的 CRC64 值与本地计算的数值进行比较验证。Complete Multipart Upload：如果每个分块都有 CRC64 属性，则会返回整个对象的 CRC64 值，如果某些分块不具备 CRC64 值，则不返回。执行 Upload Part – Copy 时，会返回对应的 CRC64 值。执行 PUT Object – Copy 时，如果源对象存在 CRC64 值，则返回 CRC64，否则不返回。执行 HEAD Object 和 GET Object 时，如果对象存在 CRC64，则返回。用户可以根据 COS 返回的 CRC64 值和本地计算的 CRC64 进行比较验证。

API 接口示例

分块上传响应

下面为用户发出 Upload Part 请求后得到的响应示例。x-cos-hash-crc64ecma 头部表示分块的 CRC64 值，用户可以通过该值与本地计算的 CRC64 值进行比较，从而校验分块完整性。

HTTP/1.1 200 OKcontent-length: 0connection: closedate: Thu, 05 Dec 2019 01:58:03 GMTetag: "358e8c8b1bfa35ee3bd44cb3d2cc416b"server: tencent-cosx-cos-hash-crc64ecma: 15060521397700495958x-cos-request-id: NWRlODY0MmJfMjBiNDU4NjRfNjkyZl80ZjZi****

完成分块上传响应

下面为用户发出 Complete Multipart Upload 请求后得到的响应示例。x-cos-hash-crc64ecma 头部表示整个对象的 CRC64 值，用户可以通过该值与本地计算的 CRC64 值进行比较，从而校验对象完整性。

HTTP/1.1 200 OKcontent-type: application/xmltransfer-encoding: chunkedconnection: closedate: Thu, 05 Dec 2019 02:01:17 GMTserver: tencent-cosx-cos-hash-crc64ecma: 15060521397700495958x-cos-request-id: NWRlODY0ZWRfMjNiMjU4NjRfOGQ4Ml81MDEw****
[Object Content]

SDK 校验方式

目前C++ SDK对于不同接口默认校验方式不同：简单上传接口
PUT Object ：默认使用 MD5 校验，暂不支持 CRC64 校验。分块上传接口Upload Part：默认使用 MD5 校验，暂不支持 CRC64 校验。Complete Multipart Upload：默认使用 CRC64 校验，暂不支持 MD5 校验。

请求示例1：分块上传

qcloud_cos::CosConfig config("./config.json");qcloud_cos::CosAPI cos(config);
std::string bucket_name = "examplebucket-1250000000"; // 修改为用户的存储桶名std::string object_name = "exampleobject"; // 修改为用户的对象名std::string local_file = "./test"; // 修改为用户的本地文件名
qcloud_cos::MultiUploadObjectReq req(bucket_name, object_name, local_file); // 默认开启了CRC64校验req.SetRecvTimeoutInms(1000 * 60);qcloud_cos::MultiUploadObjectResp resp;qcloud_cos::CosResult result = cos.MultiUploadObject(req, &resp); // 内部自动校验CRC64// 调用成功，调用 resp 的成员函数获取返回内容if (result.IsSucc()) {    // ...} else {    // 可以调用 CosResult 的成员函数输出错误信息，例如 requestID 等} 



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠