# 追加写对象(C SDK) ![](https://support.huaweicloud.com/sdk-c-devg-obs/public_sys-resources/notice_3.0-zh-cn.png) 开发过程中，您有任何问题可以在GitHub上[提交issue](https://github.com/huaweicloud/huaweicloud-sdk-c-obs/issues)，或者在[华为云对象存储服务论坛](https://bbs.huaweicloud.com/forum/forum-620-1.html)中发帖求助。 #### 功能说明 您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型：文本文件、图片、视频等。 追加写对象操作是指在指定对象尾追加上传数据，不存在相同对象键值的对象则创建新对象。 每次追加上传都会更新该对象的最后修改时间。 #### 接口约束 - 您必须是桶拥有者或拥有上传对象的权限，才能上传对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见[OBS权限控制概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.html)，配置方式详见[使用IAM自定义策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.html)、[配置对象策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0075.html)。 - OBS支持的Region与Endpoint的对应关系，详细信息请参见[地区与终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/OBS)。 - 启用服务端加密SSE-C方式时，追加上传和初始化段一样，设置诸如x-obs-server-side-encryption之类的请求Header，后续追加上传也必须携带。 - 启用服务端加密SSE-KMS方式时，有且只有第一次上传且桶内不存在同名对象时，才设置诸如x-obs-server-side-encryption之类的请求Header，后续追加上传不携带，会继承之前的设置。 - 每次追加上传的长度不能超过对象长度上限5GB的限制。 - 每个Appendable对象追加上传次数最多为10000次。 - 如果对象存储类别为COLD（归档存储）或DEEP_ARCHIVE（深度归档存储），则不能调用该接口。 - 如果桶设置了跨区域复制配置，则不能调用该接口。 - 并行文件系统不支持追加上传对象。 - put_object上传的对象可覆盖append_object上传的对象，覆盖后对象变为普通对象，不可再进行追加上传。 - 第一次调用追加上传时，如果已存在同名的普通对象，则会抛出异常（HTTP状态码为409）。 - 追加上传返回的ETag是当次追加数据内容的ETag，不是完整对象的ETag。 #### 方法定义 ``` void append_object(const obs_options *options, char *key, uint64_t content_length, const char * position, obs_put_properties *put_properties,server_side_encryption_params *encryption_params, obs_append_object_handler *handler, void *callback_data); ``` #### 请求参数 表1请求参数列表 | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | options | const [obs_options]\* | 必选 | **参数解释：** 请求桶的上下文，[配置option(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0203.html)，通过obs_options设置AK、SK、endpoint、bucket、超时时间、临时鉴权。 **约束限制：** 无 | | key | char \* | 必选 | **参数解释：** 对象名。对象名是对象在桶中的完整路径，路径中不包含桶名。 例如，您对象的访问地址为examplebucket.obs.cn-north-4.myhuaweicloud.com/folder/test.txt 中，对象名为folder/test.txt。 **约束限制：** 同一个桶中存储的对象名必须是唯一的。 **取值范围：** 长度大于0且不超过1024的字符串。 **默认取值：** 无 | | content_length | uint64_t | 必选 | **参数解释：** 对象内容长度。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 如果不设置，则SDK会自动计算对象数据的长度。 | | position | char \* | 必选 | **参数解释：** 追加写的起始位置。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | put_properties | [obs_put_properties]\* | 必选 | **参数解释：** 上传对象属性。 **约束限制：** 无 | | encryption_params | [server_side_encryption_params] \* | 可选 | **参数解释：** 上传对象加密设置。 **约束限制：** 无 | | handler | [obs_append_object_handler] \* | 必选 | **参数解释：** 回调结构体，结构体内所有成员都是回调函数的指针，用于设置处理接口响应数据的回调函数。您可以通过设置回调函数，把服务端的响应数据复制到您的自定义回调数据callback_data中。 **约束限制：** 无 | | callback_data | void \* | 可选 | **参数解释：** 用户自定义回调数据。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表2obs_options | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | bucket_options | [obs_bucket_context] | 必选 | **参数解释：** 桶相关设置。 **约束限制：** 无 | | request_options | [obs_http_request_option] | 必选 | **参数解释：** 请求相关设置。 **约束限制：** 无 | | temp_auth | [temp_auth_configure]\* | 可选 | **参数解释：** 用于临时计算签名的结构体，不使用时请设置为NULL。 **约束限制：** 无 | 表3obs_bucket_context | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | host_name | char \* | 必选 | **参数解释** **：** 连接OBS的服务地址，请求使用的主机名，是指存放资源的服务器的域名，就是终端节点endpoint。 示例：host_name = "obs.cn-north-4.myhuaweicloud.com"; **约束限制：** 不需要带"http://"或"https://"前缀，通过[obs_protocol]控制是使用http协议还是https协议。 **取值范围：** 您可以从[这里](https://developer.huaweicloud.com/endpoint?OBS)查看OBS当前开通的服务地址。 **默认取值：** 无 | | bucket_name | char \* | 必选 | **参数解释** **：** 桶名。 **约束限制：** - 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。 - 桶命名规则如下： - 3～63个字符，数字或字母开头，支持小写字母、数字、"-"、"."。 - 禁止使用IP地址。 - 禁止以"-"或"."开头及结尾。 - 禁止两个"."相邻（如："my..bucket"）。 - 禁止"."和"-"相邻（如："my-.bucket"和"my.-bucket"）。 - 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。 **默认取值：** 无 | | useCname | bool | 可选 | **参数解释** **：** 是否通过自定义域名访问OBS服务。 **约束限制：** 无 **取值范围：** true：通过自定义域名访问OBS服务。 false：不通过自定义域名访问OBS服务。 **默认取值：** false | | protocol | [obs_protocol] | 可选 | **参数解释** **：** 是使用http协议还是https协议。 **约束限制：** 无 **取值范围：** 可详见[obs_protocol]。 **默认取值：** OBS_PROTOCOL_HTTPS（默认使用https协议） | | access_key | char \* | 必选 | **参数解释：** 访问密钥中的AK。 **约束限制：** 无 **取值范围：** 可详见[创建访问密钥](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0102.html#obs_20_0102__l9411f8847bda4bb18a00b996423f8ee7)。 **默认取值：** 无 | | secret_access_key | char \* | 必选 | **参数解释：** 访问密钥中的SK。 **约束限制：** 无 **取值范围：** 可详见[创建访问密钥](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0102.html#obs_20_0102__l9411f8847bda4bb18a00b996423f8ee7)。 **默认取值：** 无 | | storage_class | [obs_storage_class] | 可选 | **参数解释** **：** 创建桶时可指定的桶的存储类别。 **约束限制：** 无 **取值范围：** 可详见[obs_storage_class]。 **默认取值：** OBS_STORAGE_CLASS_STANDARD（指标准存储类别） | | token | char \* | 可选 | **参数解释：** 临时访问密钥中的SecurityToken。 **约束限制：** 无 **取值范围：** 可详见[创建访问密钥](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0102.html#obs_20_0102__l9411f8847bda4bb18a00b996423f8ee7)。 **默认取值：** 无 | | epid | char \* | 可选 | **参数解释** **：** 创建桶时可指定的企业项目ID，开通企业项目的用户可以从企业项目服务获取。 **约束限制：** epid格式为uuid，未开通企业项目的用户可以不带该头域。 示例：9892d768-2d13-450f-aac7-ed0e44c2585f **默认取值：** 无 | | bucket_type | [obs_bucket_type] | 可选 | **参数解释** **：** 创建桶时，指定是对象桶还是并行文件系统。 **约束限制：** 无 **取值范围：** 可详见[obs_bucket_type]。 **默认取值：** OBS_BUCKET_OBJECT（指对象桶） | | bucket_list_type | [obs_bucket_list_type] | 可选 | **参数解释** **：** 列举桶时，确定列举桶的类型：所有桶、对象桶、并行文件系统。 **约束限制：** 无 **取值范围：** 可详见[obs_bucket_list_type]。 | 表4obs_storage_class | 常量名 | 原始值 | 说明 | |:---|:---|:---| | OBS_STORAGE_CLASS_STANDARD | STANDARD | 标准存储。 标准存储拥有低访问时延和较高的吞吐量，适用于有大量热点对象（平均一个月多次）或小对象（\<1MB），且需要频繁访问数据的业务场景。 | | OBS_STORAGE_CLASS_STANDARD_IA | STANDARD_IA | 低频访问存储。 低频访问存储适用于不频繁访问（平均一年少于12次）但在需要时也要求能够快速访问数据的业务场景。 | | OBS_STORAGE_CLASS_GLACIER | GLACIER | 归档存储。 归档存储适用于很少访问（平均一年访问一次）数据的业务场景。 | | OBS_STORAGE_CLASS_DEEP_ARCHIVE | DEEP_ARCHIVE | 深度归档存储 适用于长期不访问（平均几年访问一次）数据的业务场景。 | 表5obs_protocol | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_PROTOCOL_HTTPS | https | 使用https协议访问。 | | OBS_PROTOCOL_HTTP | http | 使用http协议访问。 | 表6obs_bucket_type | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_BUCKET_OBJECT | OBJECT | 对象桶。 | | OBS_BUCKET_PFS | POSIX | 并行文件系统。 | 表7obs_bucket_list_type | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_BUCKET_LIST_ALL | 不发送头域 | 列举所有桶。 | | OBS_BUCKET_LIST_OBJECT | OBJECT | 列举所有对象桶。 | | OBS_BUCKET_LIST_PFS | POSIX | 列举所有并行文件系统。 | 表8obs_http_request_option | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | connect_time | int | 必选 | **参数解释** **：** 建立HTTP/HTTPS连接的超时时间（单位：毫秒）。 **约束限制：** 无 **取值范围：** \[10000, 60000\] **默认取值：** 60000 | | max_connected_time | int | 必选 | **参数解释** **：** 请求超时时间（单位：秒）。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 0（指永远不会主动断开连接） | | proxy_auth | char\* | 可选 | **参数解释** **：** 代理认证信息，格式为username:password。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | proxy_host | char\* | 可选 | **参数解释** **：** 代理服务器的IP地址或主机名。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表9temp_auth_configure | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | expires | long long int | 必选 | **参数解释：** 临时鉴权的有效期（单位：秒）。 **约束限制：** 无 **取值范围：** \[0-630720000\] **默认取值**： 无 | | temp_auth_callback | void (\*[temp_auth_callback])(char \*temp_auth_url, uint64_t temp_auth_url_len, char\*temp_auth_headers, uint64_t temp_auth_headers_len, void\*callback_data) | 必选 | **参数解释：** 用户自定义回调函数指针，用于将临时url以及涉及的计算签名头域记录到用户自定义回调数据中。 **约束限制：** 无 | | callback_data | void \* | 必选 | **参数解释：** 用户自定义回调数据。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | 表10temp_auth_callback | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | temp_auth_url | char \* | 必选 | **参数解释：** 临时鉴权的URL。OBS服务支持用户构造一个特定操作的URL，这个URL的Query参数中会包含用户AK、签名、有效期等信息，任何拿到这个URL的人均可执行临时鉴权操作，OBS服务收到这个请求后认为该请求就是签发URL用户自己在执行操作。例如构造一个携带签名信息的下载对象的URL，拿到相应URL的人都能下载这个对象，但该URL只在Expires指定的失效时间内有效。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | temp_auth_url_len | uint64_t | 必选 | **参数解释：** 临时鉴权的URL的长度。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | temp_auth_headers | char \* | 必选 | **参数解释：** 临时鉴权的headers。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | temp_auth_headers_len | uint64_t | 必选 | **参数解释：** 临时鉴权headers的缓冲区长度（字节数）。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | callback_data | void \* | 必选 | **参数解释：** 用户自定义回调数据。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | 表11obs_put_properties | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | content_type | char \* | 必选 | **参数解释：** 指定对象被下载时的文件类型。 **约束限制：** 无 **取值范围：** 参见HTTP标准头域Content-Type的取值。 **默认取值：** 无 | | md5 | char \* | 必选 | **参数解释：** 对象数据的MD5值（经过Base64编码），提供给OBS服务端，校验数据完整性。OBS服务端会将该MD5值与对象数据计算出的MD5值进行对比，如果不匹配则上传失败，返回HTTP 400错误。 **约束限制：** 对象数据的MD5值必须经过Base64编码。如果不设置对象的MD5值，OBS服务端会忽略对对象数据的MD5值校验。 **取值范围：** 按照RFC 1864标准计算出消息体的MD5摘要字符串，即消息体128-bit MD5值经过Base64编码后得到的字符串。 示例：n58IG6hfM7vqI4K0vnWpog== **默认取值：** 无 | | cache_control | char \* | 必选 | **参数解释：** 指定对象被下载时的网页的缓存行为。 **约束限制：** 无 **取值范围：** 参见HTTP标准头域Cache-Control的取值。 **默认取值：** 无 | | content_disposition_filename | char \* | 必选 | **参数解释：** 指定对象被下载时的名称。假设设置为test.txt则相当于添加了Content-Disposition: attachment; filename=test.txt头域。 **约束限制：** 无 **取值范围：** 参见HTTP标准头域Content-Disposition的取值。 **默认取值：** 无 | | content_encoding | char \* | 必选 | **参数解释：** 指定对象被下载时的内容编码格式。 **约束限制：** 无 **取值范围：** 参见HTTP标准头域Content-Encoding的取值。 **默认取值：** 无 | | website_redirect_location | char \* | 必选 | **参数解释：** 当桶设置了Website配置，可以将获取这个对象的请求重定向到桶内另一个对象或一个外部的URL。 例如，重定向请求到桶内另一对象： x-obs-website-redirect-location:/anotherPage.html 或重定向请求到一个外部URL： x-obs-website-redirect-location:http://www.example.com/ **约束限制：** 必须以"/"、"http://"或"https://"开头，长度不超过2KB。 **取值范围：** 无 **默认取值：** 无 | | get_conditions | [obs_get_conditions] \* | 可选 | **参数解释：** 对象上传、拷贝和下载等操作的前置条件和一系列行为参数集合。 **约束限制：** 无 | | start_byte | uint64_t | 可选 | **参数解释：** 指定复制对象的起始位置。 **约束限制：** 无 **取值范围：** \[0\~对象长度-1)，单位：字节。 **默认取值：** 0（即从对象的第一个字节开始复制） | | byte_count | uint64_t | 可选 | **参数解释：** 指定复制的长度。 **约束限制：** - 取值必须大于0。 - 如果"start_byte+byte_count"大于对象长度-1，实际仍取对象长度-1，单位为字节。 **取值范围：** 无 **默认取值：** 无 | | upload_limit | uint64_t | 可选 | **参数解释：** 对单链接请求的带宽限制。 **约束限制：** 无 **取值范围：** \[819200，838860800\]，单位 bit/s。 **默认取值：** 无 | | expires | int64_t | 可选 | **参数解释：** OBS请求中Expires头的值。指定Object被下载时的网页的缓存过期时间。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | obs_expires | int64_t | 可选 | **参数解释：** 指定对象过期时间，单位是天。过期之后对象会被自动删除。 **约束限制：** 设置的天数计算出的过期时间不能早于当前时间，如10天前上传的对象，不能设置小于10的值。 **取值范围：** 大于0的整数值。 **默认取值：** 无 | | canned_acl | [obs_canned_acl] | 可选 | **参数解释：** 权限控制策略。 **约束限制：** 无 **取值范围：** 可详见[obs_canned_acl]。 | | az_redundancy | [obs_az_redundancy] | 可选 | **参数解释：** 创桶时可指定的数据冗余类型，即AZ类型。 **约束限制：** 无 **取值范围：** 可详见[obs_az_redundancy]。 | | meta_data_count | int | 可选 | **参数解释：** meta_data数组中元素的个数。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | meta_data | [obs_name_value]\* | 可选 | **参数解释：** 对象的自定义元数据。OBS支持用户使用自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回的消息头中出现。 **约束限制**： - 如果请求携带了此头域，那么响应的消息中应该包含此消息头。 - 所有自定义元数据大小的总和不超过8KB。单个自定义元数据大小的计算方式为：每个键和值的UTF-8 编码中的字节总数。 - 自定义元数据的key值不区分大小写，OBS统一转为小写进行存储。value值区分大小写。 - 自定义元数据key-value对都必须符合US-ASCII。如果一定要使用非ASCII码或不可识别字符，需要客户端自行做编解码处理，可以采用URL编码或者Base64编码，服务端不会做解码处理。例如x-obs-meta-中文：中文经URL编码后发送，"中文"的URL编码为：%E4%B8%AD%E6%96%87，则响应为x-obs-meta-%E4%B8%AD%E6%96%87: %E4%B8%AD%E6%96%87 | | metadata_action | [metadata_action_indicator] | 可选 | **参数解释：** 元数据操作指示符。 **约束限制：** 无 **取值范围：** 可详见[metadata_action_indicator]。 | | server_callback | [obs_upload_file_server_callback] | 可选 | **参数解释：** 服务端回调相关参数。 **约束限制：** 无 | 表12obs_canned_acl | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_CANNED_ACL_PRIVATE | private | 私有读写，桶或对象的所有者拥有完全控制的权限，其他任何人都没有访问权限。 | | OBS_CANNED_ACL_PUBLIC_READ | public-read | 公共读私有写，设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本。设在对象上，所有人可以获取该对象内容和元数据。 | | OBS_CANNED_ACL_PUBLIC_READ_WRITE | public-read-write | 公共读写，设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、上传对象、删除对象、初始化段任务、上传段、合并段、复制段、取消多段上传任务。设在对象上，所有人可以获取该对象内容和元数据。 | | OBS_CANNED_ACL_BUCKET_OWNER_FULL_CONTROL | bucket-owner-full-control | 设在对象上，桶和对象的所有者拥有对象的完全控制权限，其他任何人都没有访问权限。默认情况下，上传对象至其他用户的桶中，桶拥有者没有对象的控制权限。对象拥有者为桶拥有者添加此权限控制策略后，桶所有者可以完全控制对象。例如，用户A上传对象x至用户B的桶中，系统默认用户B没有对象x的控制权。当用户A为对象x设置bucket-owner-full-control策略后，用户B就拥有了对象x的控制权。仅S3 API支持。 | | OBS_CANNED_ACL_PUBLIC_READ_DELIVERED | public-read-delivered | 桶公共读，桶内对象公共读，设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据，可以获取该桶内对象的内容和元数据。不能应用于对象。 | | OBS_CANNED_ACL_PUBLIC_READ_WRITE_DELIVERED | public-read-write-delivered | 桶公共读写，桶内对象公共读写，设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、上传对象、删除对象、初始化段任务、上传段、合并段、复制段、取消多段上传任务，可以获取该桶内对象的内容和元数据。不能应用于对象。 | 表13obs_az_redundancy | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_REDUNDANCY_1AZ | - | 默认创建单AZ桶。 | | OBS_REDUNDANCY_3AZ | 3az | 创建3AZ桶。 | 表14obs_name_value | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | name | char \* | 可选 | **参数解释：** 属性的键。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | value | char \* | 可选 | **参数解释：** 属性的值。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表15obs_get_conditions | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | start_byte | uint64_t | 可选 | **参数解释：** 指定下载对象的起始位置。 **取值范围：** \[0\~对象长度-1)，单位：字节。 **默认取值：** 0（即从对象的第一个字节开始下载） | | byte_count | uint64_t | 可选 | **参数解释：** 指定下载的长度。 **取值范围：** - 取值必须大于0。 - 如果"start_byte+byte_count"大于对象长度-1，实际仍取对象长度-1，单位为字节。 **默认取值：** 无 | | download_limit | uint64_t | 可选 | **参数解释：** 对单链接请求的带宽限制。 **取值范围：** \[819200，838860800\]，单位 bit/s。 **默认取值：** 无 | | if_modified_since | int64_t | 可选 | **参数解释：** 如果对象在指定的时间后有修改，则请求成功，否则返回错误。 | | if_not_modified_since | int64_t | 可选 | **参数解释：** 如果对象在指定的时间后没有修改，则请求成功，否则返回错误。 | | if_match_etag | char \* | 可选 | **参数解释：** 指定一个预设的Etag值，如果下载或复制对象的ETag值与该参数值相同，则请求成功，否则返回错误。 **取值范围：** 长度为32的字符串。 **默认取值：** 无 | | if_not_match_etag | char \* | 可选 | **参数解释：** 指定一个预设的Etag值，如果下载或复制对象的ETag值与该参数值不相同，则请求成功，否则返回错误。 **取值范围：** 长度为32的字符串。 **默认取值：** 无 | | image_process_config | [image_process_configure] \* | 可选 | **参数解释：** 图片处理相关参数。 **约束限制：** 无 | 表16metadata_action_indicator | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_NO_METADATA_ACTION | - | 默认的无效值。 | | OBS_REPLACE | REPLACE | 表示使用当前请求中携带的头域完整替换，未指定的元数据会被删除。 | | OBS_REPLACE_NEW | REPLACE_NEW | 表示对于已经存在值的元数据进行替换，不存在值的元数据进行赋值，未指定的元数据保持不变（自定义元数据作替换处理）。 | 表17obs_upload_file_server_callback | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | callback_url | char \* | 必选 | **参数解释：** 对象上传成功之后，OBS向此url发送回调请求，请求方法为POST。 支持设置多个url，以英文分号（;）分隔，最多支持10个。 callbackUrl需要做url编码。例如："http://www.example.com/中文?key=中文名"需要编码成"http://www.example.com/%E4%B8%AD%E6%96%87?key=%E4%B8%AD%E6%96%87%E5%90%8D"。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | callback_host | char \* | 可选 | **参数解释：** 发起回调请求的Host头域的值，如果不设置，会使用callbackUrl解析出来的Host。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | callback_body | char \* | 必选 | **参数解释：** 发起回调请求的body体。body体格式必须符合callbackBodyType中设置的媒体类型。 回调body体支持系统变量和自定义变量，系统变量如[回调body体支持的系统变量表](https://support.huaweicloud.com/api-obs/obs_04_0095.html#obs_04_0095__table695016242719)所示，自定义变量就是以x:开头的变量。例如：key=$(key)\&hash=$(etag)\&fileid=$(x:fileid)，其中变量key、etag是系统变量，x:fileid是自定义变量。如果用户上传的对象是图片，可以在参数中设置imageInfo.width和imageInfo.height表示该图片的宽高。例如：key=$(key)\&hash=$(etag)\&w=$(imageInfo.width)\&h=$(imageInfo.height)。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | callback_body_type | char \* | 可选 | **参数解释：** 发起回调请求的Content-Type头域的值。 **约束限制：** 无 **取值范围：** - application/x-www-form-urlencoded - application/json **默认取值：** 如果不设置取值，则默认为application/json。 | 表18image_process_configure | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | image_process_mode | [image_process_mode_type] | 可选 | **参数解释：** 图片处理参数头。 **约束限制：** 无 **取值范围：** 可详见[image_process_mode_type]。 | | cmds_stylename | char \* | 可选 | **参数解释：** 图片处理相关参数。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表19image_process_mode_type | **常量名** | **原始值** | **说明** | |:---|:---|:---| | obs_image_process_invalid_mode | - | 默认的无效值。 | | obs_image_process_cmd | image | 图片处理参数以image开头。 | | obs_image_process_style | style | 图片处理参数以style开头。 | 表20server_side_encryption_params | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | encryption_type | [obs_encryption_type] | 可选 | **参数解释：** 加密类型。 **约束限制：** 无 **取值范围：** 可详见[obs_encryption_type]。 | | kms_server_side_encryption | char \* | 可选 | **参数解释：** 使用该头域表示对象使用的服务端加密方式是SSE-KMS。 **约束限制：** 无 **取值范围**： - kms - AES256 **默认取值：** 无 | | kms_key_id | char \* | 可选 | **参数解释：** 密钥ID。当加密方式为SSE-KMS且使用指定密钥加密时，需输入密钥ID。 **约束限制：** 当您设置了kms_server_side_encryption且赋值为"kms"，即选择kms加密方式时，才能使用该头域指定加密密钥。 **取值范围：** 密钥ID获取方法请参见[查看密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0179.html)。 **默认取值：** 当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。 | | ssec_customer_algorithm | char \* | 可选 | **参数解释：** 该头域表示加密对象使用的算法。 **约束限制：** 仅SSE-C方式下使用该头域。 **取值范围：** AES256（指AES256加密算法） **默认取值：** 无 | | ssec_customer_key | char \* | 可选 | **参数解释：** 该头域表示加密对象使用的密钥。 **约束限制：** 仅SSE-C方式下使用该头域。 **取值范围：** 256位密钥的base64编码。 **默认取值：** 无 | | des_ssec_customer_algorithm | char \* | 可选 | **参数解释：** 该头域表示解密源对象使用的算法。 **约束限制：** 仅SSE-C方式下使用该头域。 **取值范围：** 无 **默认取值：** 无 | | des_ssec_customer_key | char \* | 可选 | **参数解释：** 该头域表示解密源对象使用的密钥。 **约束限制：** 仅SSE-C方式下使用该头域。 **取值范围：** 无 **默认取值：** 无 | 表21obs_encryption_type | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_ENCRYPTION_KMS | kms | 使用KMS加密方式。 | | OBS_ENCRYPTION_SSEC | AES256 | 使用SSE-C加密方式。 | 表22obs_append_object_handler | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | response_handler | [obs_response_handler] \* | 必选 | **参数解释：** 响应回调函数结构体。 **约束限制：** 无 | | append_object_data_callback | [obs_append_object_data_callback] \* | 必选 | **参数解释：** 回调函数指针，用于把要上传的数据复制到待上传的数据缓冲区。 **约束限制：** 无 | 表23obs_append_object_data_callback | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | buffer_size | int | 必选 | **参数解释：** buffer的长度。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | buffer | char \* | 必选 | **参数解释：** 待上传的数据缓冲区，把要上传的数据复制到这个缓冲区。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | callback_data | void \* | 必选 | **参数解释：** 用户自定义回调数据指针。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表24obs_response_handler | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | properties_callback | [obs_response_properties_callback] \* | 必选 | **参数解释：** 响应回调函数指针，可以在这个回调中把[obs_response_properties](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0308.html#obs_20_0308__table13287123911192)的内容记录到callback_data（用户自定义回调数据）中。 **约束限制：** 无 | | complete_callback | [obs_response_complete_callback] \* | 必选 | **参数解释：** 结束回调函数指针，可以在这个回调中把[obs_status]和[obs_error_details]的内容记录到callback_data（用户自定义回调数据）中。 **约束限制：** 无 | 表25obs_response_properties_callback | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | properties | const [obs_response_properties]\* | 必选 | **参数解释：** 响应头域中的参数，建议将其内容记录到callback_data（用户自定义回调数据）中。 **约束限制：** 无 | | callback_data | void \* | 必选 | **参数解释：** 用户自定义回调数据指针。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | 表26obs_response_complete_callback | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | status | [obs_status] | 必选 | **参数解释：** SDK内部的请求状态码。 **约束限制：** 无 **取值范围：** 可详见[obs_status]。 | | error_details | const [obs_error_details]\* | 必选 | **参数解释：** 请求失败的错误详情，包含错误消息、资源信息等，建议将其内容记录到callback_data（用户自定义回调数据）中。 **约束限制：** 无 | | callback_data | void \* | 必选 | **参数解释：** 用户自定义回调数据指针。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | 表27obs_response_properties | **参数名称** | **参数类型** | **是否必选** | **描述** | |:---|:---|:---|:---| | request_id | const char \* | 可选 | **参数解释：** 由OBS创建来唯一确定本次请求的值，可以通过该值来定位问题。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | request_id2 | const char \* | 可选 | **参数解释：** 帮助定位问题的特殊符号。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | content_type | const char \* | 可选 | **参数解释：** 对象的文件类型（MIME类型）。Content-Type（MIME）用于标识发送或接收数据的类型，浏览器根据该参数来决定数据的打开方式。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | content_length | uint64_t | 可选 | **参数解释：** 响应消息体的字节长度。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | server | const char \* | 可选 | **参数解释：** 请求中的Server头域。 **约束限制：** 无 **取值范围：** 无 **默认取值**： 无 | | etag | const char \* | 可选 | **参数解释：** 对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识，可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A，下载对象时ETag为B，则说明对象内容发生了变化。ETag只反映变化的内容，而不是其元数据。上传的对象或复制操作创建的对象，都有唯一的ETag。 **约束限制：** 当对象是服务端加密的对象时，ETag值不是对象的MD5值。 **取值范围：** 长度为32的字符串。 **默认取值：** 无 | | expiration | const char \* | 可选 | **参数解释：** 对象的详细过期信息。 **约束限制：** 无 **取值范围：** ISO 8601 格式的时间字符串，如"Web, 7 Nov 2012 00:00:00 GMT"。 **默认取值：** 无 | | website_redirect_location | const char \* | 可选 | **参数解释：** 当桶设置了Website配置，就可以设置对象元数据的这个属性，Website接入点返回301重定向响应，将获取这个对象的请求重定向到该属性指定的桶内另一个对象或一个外部的URL，该参数指明对象的重定向地址。 例如，重定向请求到桶内另一对象： x-obs-website-redirect-location:/anotherPage.html 或重定向请求到一个外部URL： x-obs-website-redirect-location:http://www.example.com/ OBS将这个值从头域中取出，保存在对象的元数据"WebsiteRedirectLocation"中。 **约束限制：** - 必须以"/"、"http://"或"https://"开头，长度不超过2KB。 - OBS仅支持为桶根目录下的对象设置重定向，不支持为桶中文件夹下的对象设置重定向。 **取值范围：** 无 **默认取值：** 无 | | version_id | const char \* | 可选 | **参数解释：** 对象的版本号。 **约束限制：** 如果该对象无版本号，则为NULL。 **取值范围：** 长度为32的字符串。 **默认取值**： 无 | | meta_data_count | int | 可选 | **参数解释：** meta_data数组中的元素个数。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | meta_data | const [obs_name_value] \* | 可选 | **参数解释：** 对象的自定义元数据。OBS支持用户使用以"x-obs-meta-"开头的消息头来加入自定义的元数据，以便对对象进行自定义管理。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回的消息头中出现。 **约束限制：** 无 | | use_server_side_encryption | char | 可选 | **参数解释：** 如果开启了服务端加密，会被置为'\\1'。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | allow_origin | const char \* | 可选 | **参数解释：** 当桶设置了CORS配置，如果请求中的Origin满足服务端的CORS配置，则在响应中包含这个Origin。 **约束限制：** 无 **取值范围：** 符合CORS协议的取值范围。 **默认取值：** 无 | | allow_headers | const char \* | 可选 | **参数解释：** 当桶设置了CORS配置，如果请求的headers满足服务端的CORS配置，则在响应中包含这个headers。 **约束限制：** 最多可填写一个"\*"通配符，不支持\&、:、\<、空格以及中文字符。 **取值范围：** 符合CORS协议的取值范围。 **默认取值：** 无 | | max_age | const char \* | 可选 | **参数解释：** 桶CORS规则中的MaxAgeSeconds。MaxAgeSeconds指请求来源的客户端可以对跨域请求返回结果的缓存时间。 **约束限制：** 每个CORSRule可以包含至多一个MaxAgeSeconds。 **取值范围：** 大于等于0的整型数，单位：秒。 **默认取值：** 3000 | | allow_methods | const char \* | 可选 | **参数解释：** 当桶设置了CORS配置，如果请求的Access-Control-Request-Method满足服务端的CORS配置，则在响应中包含这条rule中的Methods。 **约束限制：** 无 **取值范围：** - GET - PUT - HEAD - POST - DELETE **默认取值：** 无 | | expose_headers | const char \* | 可选 | **参数解释：** 桶CORS规则中的ExposeHeader。ExposeHeader是指CORS规则允许响应中可返回的附加头域，给客户端提供额外的信息。默认情况下浏览器只能访问以下头域：Content-Length、Content-Type，如果需要访问其他头域，需要在附加头域中配置。 **约束限制：** 不支持\*、\&、:、\<、空格以及中文字符。 **取值范围：** 无 **默认取值：** 无 | | storage_class | const char \* | 可选 | **参数解释：** 对象的存储类别。 **约束限制：** 仅当对象为非标准存储类别时，会返回此头域。 **取值范围：** - WARM（指低频存储） - COLD（指归档存储） - DEEP_ARCHIVE（指深度归档存储） **默认取值：** 无 | | server_side_encryption | const char \* | 可选 | **参数解释：** 该头域表示服务端的加密方式。 示例：x-obs-server-side-encryption：kms **约束限制：** 如果服务端加密是SSE-KMS方式，响应包含该头域。 **取值范围：** - kms（指SSE-KMS加密方式） - obs（指SSE-OBS加密方式） **默认取值：** 无 | | kms_key_id | const char \* | 可选 | **参数解释：** 密钥ID。当加密方式为SSE-KMS且使用指定密钥加密时，需输入密钥ID。 **约束限制：** 当您设置了server_side_encryption且赋值为"kms"，即选择kms加密方式时，才能使用该头域指定加密密钥。 **取值范围：** 密钥ID获取方法请参见[查看密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0179.html)。 **默认取值：** 当您选择使用kms加密方式，但未设置此头域时，默认的主密钥将会被使用。如果默认主密钥不存在，系统将默认创建并使用。 | | customer_algorithm | const char \* | 可选 | **参数解释：** 如果服务端加密是SSE-C方式，响应包含该头域，该头域表示解密使用的算法。 **约束限制：** 无 **取值范围：** AES256（指AES256解密算法） **默认取值：** 无 | | customer_key_md5 | const char \* | 可选 | **参数解释：** 如果服务端加密是SSE-C方式，响应包含该头域，该头域表示解密使用的密钥的MD5值。 **约束限制：** 由密钥值经过MD5加密再经过Base64编码后得到，示例：4XvB3tbNTN+tIEVa0/fGaQ== **取值范围：** 密钥ID MD5的base64值。 **默认取值：** 无 | | bucket_location | const char \* | 可选 | **参数解释：** 桶的区域位置信息。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | obs_version | const char \* | 可选 | **参数解释：** 桶所在的OBS服务版本号。 **约束限制：** 无 **取值范围：** - 3.0：最新版本的桶。 - --：表示老版本的桶。 **默认取值：** 无 | | restore | const char \* | 可选 | **参数解释：** 标识对象的恢复状态。 示例：正在恢复ongoing-request="true"；已恢复 ongoing-request="false", expiry-date="Wed, 7 Nov 2012 00:00:00 GMT"。其中expiry-date表示对象恢复后的失效时间。 **约束限制：** 仅当对象为归档存储或深度归档存储类别，并且处于正在恢复或已经恢复时，会返回此头域。 **取值范围：** 无 **默认取值：** 无 | | obs_object_type | const char \* | 可选 | **参数解释：** 对象的类型。 **约束限制：** 仅当对象为非Normal对象时，会返回此头域。 **取值范围：** Appendable **默认取值：** 无 | | obs_next_append_position | const char \* | 可选 | **参数解释：** 指明下一次请求应该提供的position。 **约束限制：** 仅当对象为Appendable对象时，会返回此头域。 **取值范围：** 无 **默认取值：** 无 | | obs_head_epid | const char \* | 可选 | **参数解释：** 当前桶的企业项目ID，开通企业项目的用户可以从企业项目服务获取。 **约束限制：** 格式为uuid，未开通企业项目的用户可以不带该头域。 **取值范围：** 无 **默认取值：** 无 | | reserved_indicator | const char \* | 可选 | **参数解释：** 帮助定位问题的特殊符号。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表28obs_error_details | **参数名称** | **参数类型** | **描述** | |:---|:---|:---| | message | const char\* | **参数解释：** 错误响应消息体XML中具体错误更全面、详细的英文解释。 **约束限制：** 无 **取值范围：** 取值范围可参见[错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html)。 **默认取值：** 无 | | resource | const char\* | **参数解释：** 该错误相关的桶或对象资源。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | further_details | const char\* | **参数解释：** 错误响应消息体XML中的FurtherDetails元素的值。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | extra_details_count | int | **参数解释：** 错误响应消息体XML中的其他元素的数量。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | extra_details | [obs_name_value]\* | **参数解释：** 错误响应消息体XML中的其他元素的值。 **约束限制：** 无 | | error_headers_count | int | **参数解释：** error_headers的头域数量。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | | error_headers | char\*\* | **参数解释：** 响应头域中包含error的所有头域。 **约束限制：** 无 **取值范围：** 无 **默认取值：** 无 | 表29obs_status | **常量名** | **原始值** | **说明** | |:---|:---|:---| | OBS_STATUS_OK | 0 | 请求成功。 | | OBS_STATUS_InitCurlFailed | 1 | 初始化curl失败。 | | OBS_STATUS_InternalError | 2 | 内部错误。 | | OBS_STATUS_OutOfMemory | 3 | 本地环境内存不足。 | | OBS_STATUS_FailedToIInitializeRequest | 6 | 初始化请求失败。 | | OBS_STATUS_XmlParseFailure | 23 | xml解析失败。 | | OBS_STATUS_NameLookupError | 33 | 域名解析失败。 | | OBS_STATUS_FailedToConnect | 34 | 无法连接到服务端。 | | OBS_STATUS_ConnectionFailed | 36 | 网络连接失败。 | | OBS_STATUS_PartialFile | 38 | 网络传输中断。 | | OBS_STATUS_InvalidParameter | 39 | 参数非法。 | | OBS_STATUS_NoToken | 40 | 当前并发数已经超过最大并发数（默认值1000）。此处的Token指并发请求令牌，非安全认证令牌。可通过set_online_request_max_count函数调整最大并发数。 | | OBS_STATUS_OpenFileFailed | 41 | 打开文件失败。 | | OBS_STATUS_AccessDenied | 43 | 请求被拒绝。 | | OBS_STATUS_MalformedPolicy | 44 | 请求policy格式不正确。 | | OBS_STATUS_MalformedXML | 45 | 请求xml格式不正确。 | | OBS_STATUS_MethodNotAllowed | 46 | 请求方法不允许。 | | OBS_STATUS_SignatureDoesNotMatch | 47 | 签名不匹配，检查ak、sk、token是否对应或有误。 | | OBS_STATUS_ServiceUnavailable | 48 | 服务端异常。 | | OBS_STATUS_SlowDown | 49 | 请求频率过快。 | #### 代码示例：追加写对象 以下示例展示如何通过append_object实现追加上传： ``` #include "eSDKOBS.h" #include #include // 响应回调函数，可以在这个回调中把properties的内容记录到callback_data(用户自定义回调数据)中 obs_status response_properties_callback(const obs_response_properties *properties, void *callback_data); void put_buffer_complete_callback(obs_status status, const obs_error_details *error, void *callback_data); typedef struct put_buffer_object_callback_data { char *put_buffer; uint64_t buffer_size; uint64_t cur_offset; obs_status ret_status; } put_buffer_object_callback_data; int put_buffer_data_callback(int buffer_size, char *buffer, void *callback_data); char* generate_upload_buffer(uint64_t buffer_size); int main() { // 以下示例展示如何通过append_object实现追加上传： // 在程序入口调用obs_initialize方法来初始化网络、内存等全局资源。 obs_status ret_status = obs_initialize(OBS_INIT_ALL); if (OBS_STATUS_OK != ret_status) { printf("obs_initialize failed(%s).\n", obs_get_status_name(ret_status)); return -1; } obs_options options; // 创建并初始化options，该参数包括访问域名(host_name)、访问密钥（access_key_id和access_key_secret）、桶名(bucket_name)、桶存储类别(storage_class)等配置信息 init_obs_options(&options); // host_name填写桶所在的endpoint, 此处以华北-北京四为例，其他地区请按实际情况填写。 options.bucket_options.host_name = "obs.cn-north-4.myhuaweicloud.com"; // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量ACCESS_KEY_ID和SECRET_ACCESS_KEY。 options.bucket_options.access_key = getenv("ACCESS_KEY_ID"); options.bucket_options.secret_access_key = getenv("SECRET_ACCESS_KEY"); // 填写Bucket名称，例如example-bucket-name。 char * bucket_name = "example-bucket-name"; options.bucket_options.bucket_name = bucket_name; // 初始化上传对象属性 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)); // 设置buffersize data.buffer_size = 10 * 1024 * 1024; // 创建模拟的流式上传数据buffer, 并赋值到上传数据结构中 data.put_buffer = generate_upload_buffer(data.buffer_size); if (NULL == data.put_buffer) { printf("generate put buffer failed. \n"); return -1; } // 上传的对象名 char *key = "example_put_file_test_append"; // append上传的起始位置 char *position = "0"; obs_append_object_handler append_obj_handler = {{&response_properties_callback, &put_buffer_complete_callback}, &put_buffer_data_callback}; append_object(&options, key, data.buffer_size, position, &put_properties, 0, &append_obj_handler, &data); if (OBS_STATUS_OK == data.ret_status) { printf("append object from buffer successfully. \n"); } else { printf("append object from buffer failed(%s).\n", obs_get_status_name(data.ret_status)); } // 释放分配的全局资源 obs_deinitialize(); return 0; } // 响应回调函数，可以在这个回调中把properties的内容记录到callback_data(用户自定义回调数据)中 obs_status response_properties_callback(const obs_response_properties *properties, void *callback_data) { if (properties == NULL) { printf("error! obs_response_properties is null!"); return OBS_STATUS_OK; } // 打印响应信息 #define print_nonnull(name, field) \ do { \ if (properties-> field) { \ printf("%s: %s\n", name, properties->field); \ } \ } while (0) print_nonnull("request_id", request_id); print_nonnull("request_id2", request_id2); print_nonnull("content_type", content_type); if (properties->content_length) { printf("content_length: %llu\n", properties->content_length); } print_nonnull("server", server); print_nonnull("ETag", etag); print_nonnull("expiration", expiration); print_nonnull("website_redirect_location", website_redirect_location); print_nonnull("version_id", version_id); print_nonnull("allow_origin", allow_origin); print_nonnull("allow_headers", allow_headers); print_nonnull("max_age", max_age); print_nonnull("allow_methods", allow_methods); print_nonnull("expose_headers", expose_headers); print_nonnull("storage_class", storage_class); print_nonnull("server_side_encryption", server_side_encryption); print_nonnull("kms_key_id", kms_key_id); print_nonnull("customer_algorithm", customer_algorithm); print_nonnull("customer_key_md5", customer_key_md5); print_nonnull("bucket_location", bucket_location); print_nonnull("obs_version", obs_version); print_nonnull("restore", restore); print_nonnull("obs_object_type", obs_object_type); print_nonnull("obs_next_append_position", obs_next_append_position); print_nonnull("obs_head_epid", obs_head_epid); print_nonnull("reserved_indicator", reserved_indicator); int i; for (i = 0; i < properties->meta_data_count; i++) { printf("x-obs-meta-%s: %s\n", properties->meta_data[i].name, properties->meta_data[i].value); } return OBS_STATUS_OK; } void put_buffer_complete_callback(obs_status status, const obs_error_details *error, void *callback_data) { if (callback_data) { put_buffer_object_callback_data *data = (put_buffer_object_callback_data *)callback_data; data->ret_status = status; } else { printf("Callback_data is NULL"); } if (error && error->message) { printf("Error Message: \n %s\n", error->message); } if (error && error->resource) { printf("Error Resource: \n %s\n", error->resource); } if (error && error->further_details) { printf("Error further_details: \n %s\n", error->further_details); } if (error && error->extra_details_count) { int i; for (i = 0; i < error->extra_details_count; i++) { printf("Error Extra Detail(%d):\n %s:%s\n", i, error->extra_details[i].name, error->extra_details[i].value); } } if (error && error->error_headers_count) { int i; for (i = 0; i < error->error_headers_count; i++) { const char *errorHeader = error->error_headers[i]; printf("Error Headers(%d):\n %s\n", i, errorHeader == NULL ? "NULL Header" : errorHeader); } } } int put_buffer_data_callback(int buffer_size, char *buffer, void *callback_data) { put_buffer_object_callback_data *data = (put_buffer_object_callback_data *)callback_data; int toRead = 0; if (data->buffer_size) { toRead = ((data->buffer_size > (unsigned)buffer_size) ? (unsigned)buffer_size : data->buffer_size); memcpy_s(buffer, buffer_size, data->put_buffer + data->cur_offset, toRead); } uint64_t originalContentLength = data->buffer_size; data->buffer_size -= toRead; data->cur_offset += toRead; if (data->buffer_size) { printf("%llu bytes remaining ", (unsigned long long)data->buffer_size); printf("(%d%% complete) ...\n", (int)(((originalContentLength - data->buffer_size) * 100) / originalContentLength)); } return toRead; } // 创建模拟的流式上传数据 char* generate_upload_buffer(uint64_t buffer_size) { void* upload_buffer = NULL; if (buffer_size > 0) { upload_buffer = malloc(buffer_size); if (upload_buffer != NULL) { memset(upload_buffer, 't', buffer_size); } } return upload_buffer; } ``` #### 相关链接 - 关于追加写的API说明，请参见[追加写对象](https://support.huaweicloud.com/api-obs/obs_04_0088.html)。 - 更多关于追加写的代码示例，请参见[Github示例](https://github.com/huaweicloud/huaweicloud-sdk-c-obs/blob/master/source/eSDK_OBS_API/eSDK_OBS_API_C++_Demo/demo.c)。 - 追加写过程中返回的错误码含义、问题原因及处理措施可参考[OBS错误码](https://support.huaweicloud.com/api-obs/obs_04_0115.html#section1)。 - 桶和对象相关常见问题请参见[上传对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0134.html)。