tencent cloud

文档反馈

CRC64 校验

最后更新时间:2022-02-18 16:08:50

    简介

    数据在客户端和服务器间传输时可能会出现错误,对象存储(Cloud Object Storage,COS)除了可以通过 MD5 和自定义属性 验证数据完整性外,还可以通过 CRC64 检验码来进行数据校验。

    COS 会对新上传的对象进行 CRC64 计算,并将结果作为对象的属性进行存储,随后在返回的响应头部中携带 x-cos-hash-crc64ecma,该头部表示上传对象的 CRC64 值,根据 ECMA-182标准 计算得到。对于 CRC64 特性上线前就已经存在于 COS 的对象,COS 不会对其计算 CRC64 值,所以获取此类对象时不会返回其 CRC64 值。

    操作说明

    目前支持 CRC64 的 API 如下:

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

    API 接口示例

    分块上传响应

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

    HTTP/1.1 200 OK
    content-length: 0
    connection: close
    date: Thu, 05 Dec 2019 01:58:03 GMT
    etag: "358e8c8b1bfa35ee3bd44cb3d2cc416b"
    server: tencent-cos
    x-cos-hash-crc64ecma: 15060521397700495958
    x-cos-request-id: NWRlODY0MmJfMjBiNDU4NjRfNjkyZl80ZjZi****
    

    完成分块上传响应

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

    HTTP/1.1 200 OK
    content-type: application/xml
    transfer-encoding: chunked
    connection: close
    date: Thu, 05 Dec 2019 02:01:17 GMT
    server: tencent-cos
    x-cos-hash-crc64ecma: 15060521397700495958
    x-cos-request-id: NWRlODY0ZWRfMjNiMjU4NjRfOGQ4Ml81MDEw****
    [Object Content]
    

    SDK 校验方式

    目前C++ SDK对于不同接口默认校验方式不同:

    • 简单上传接口
      PUT Object :默认使用 MD5 校验,暂不支持 CRC64 校验。
    • 分块上传接口

    请求示例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 等
    } 
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持