文档首页 > > SDK参考> C> 上传对象> 追加写

追加写

分享
更新时间: 2019/11/12 GMT+08:00

追加写接口append_object同put_object参数和使用方法一样,只不过是多了一个写对象的起始位置position。

参数描述

字段名

类型

约束

说明

option

请求桶的上下文,配置option

必选

桶参数。

key

char *

必选

对象名。

content_length

uint64_t

必选

对象内容长度。

position

char *

必选

追加写的起始位置。

put_properties

obs_put_properties*

必选

上传对象属性。

encryption_params

server_side_encryption_params *

可选

上传对象加密设置。

handler

obs_append_object_handler *

必选

回调函数。

callback_data

void *

可选

回调数据。

示例代码

static void test_append_object_from_buffer()
{
    // 待上传buffer
    char *buffer = "abcdefg";
    // 待上传buffer的长度
    int buffer_size = strlen(buffer);
    // 上传的对象名
    char *key = "put_buffer_test";
    char * position = "0";
    // 初始化option
    obs_options option;
    init_obs_options(&option);
    option.bucket_options.host_name = "<your-endpoint>";
    option.bucket_options.bucket_name = "<Your bucketname>";
    option.bucket_options.access_key = "<Your AK>";
    option.bucket_options.secret_access_key = "<Your SK>";
    option.bucket_options.certificate_info = "<Your certificate>";
    // 初始化上传对象属性
    obs_put_properties put_properties;
    init_put_properties(&put_properties);
    //初始化存储上传数据的结构体
    put_buffer_object_callback_data data;
    memset(&data, 0, sizeof(put_buffer_object_callback_data));
    // buffer赋值到上传数据结构中
    data.put_buffer = buffer;
    // 设置buffersize
    data.buffer_size = buffer_size;
    // 设置回调函数
    obs_append_object_handler putobjectHandler =
    { 
        { &response_properties_callback, &put_buffer_complete_callback },
          &put_buffer_data_callback
    };
    append_object(&option, key, buffer_size, position, &put_properties,
    0,&putobjectHandler,&data);
    if (OBS_STATUS_OK == data.ret_status) {
        printf("put object from buffer successfully. \n");
    }
    else
    {
        printf("put object from buffer failed(%s).\n", obs_get_status_name(data.ret_status));
    }
}
  • put_object上传的对象可覆盖append_object上传的对象,覆盖后对象变为普通对象,不可再进行追加上传。
  • 第一次调用追加上传时,若已存在同名的普通对象,则会报错(HTTP状态码为409)。
  • 每次追加上传返回的ETag是当次追加数据内容的ETag,不是完整对象的ETag;
  • 单次追加上传的内容不能超过5GB,且最多支持10000次追加上传。
  • append_object接口中第六个参数是提供服务端加密功能的参数,具体用法参考服务端加密章节。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区