华为云用户手册

对象存储服务 OBS-获取桶标签(C SDK):接口约束

接口约束您必须是桶拥有者或拥有获取桶标签的权限，才能获取桶标签。建议使用 IAM 或桶策略进行授权，如果使用IAM则需授予obs:bucket:GetBucketTagging权限，如果使用桶策略则需授予GetBucketTagging权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS 标签管理(C SDK)
对象存储服务 OBS-获取桶的CORS配置(C SDK):接口约束

接口约束您必须是桶拥有者或拥有获取桶的CORS配置的权限，才能获取桶的CORS配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:GetBucketCORS权限，如果使用桶策略则需授予GetBucketCORS权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS
对象存储服务 OBS-获取桶的CORS配置(C SDK):功能介绍

功能介绍跨域资源共享（Cross Origin Resource Sharing，CORS）是由W3C标准化组织提出的一种网络浏览器的规范机制，定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中，由于同源安全策略（Same Origin Policy，SOP）的存在，不同域之间的网站脚本和内容是无法进行交互的。OBS支持CORS规范，允许跨域请求访问OBS中的资源。调用获取桶的CORS配置接口，您可获取指定桶的跨域资源共享规则。

对象存储服务 OBS
对象存储服务 OBS-分段上传-复制段(C SDK):方法定义

方法定义 1 2 3 4 void copy_part(const obs_options *options, char *key, obs_copy_destination_object_info *object_info, obs_upload_part_info *copypart, obs_put_properties *put_properties, server_side_encryption_params *encryption_params,obs_response_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-分段上传-复制段(C SDK):接口约束

接口约束您必须是桶拥有者或拥有复制段的权限，才能复制段。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。复制段的结果不能仅根据HTTP返回头域中的status_code来判断请求是否成功，头域中status_code返回200时表示服务端已经收到请求，且开始处理复制段请求。复制是否成功会在响应消息的body中，只有body体中有ETag标签才表示成功，否则表示复制失败。

对象存储服务 OBS
对象存储服务 OBS-分段上传-复制段(C SDK):功能说明

功能说明初始化分段上传任务后，通过分段上传任务的ID，复制段到指定桶中。多段上传任务创建后，用户可以通过指定多段上传任务号，为特定的任务上传段。添加段的方式还包括调用段复制接口。允许用户将已上传对象的一部分或全部复制为段。将源对象object复制为一个段part1，如果在复制操作之前part1已经存在，复制操作执行之后，旧的段数据part1会被新复制的段数据覆盖。复制成功后，只能列举到最新的段part1，旧的段数据将会被删除。因此在使用复制段接口时请确保目标段不存在或者已无价值，避免因复制段导致数据误删除。复制过程中源对象object无任何变化。

对象存储服务 OBS
对象存储服务 OBS-获取桶存量信息(C SDK):接口约束

接口约束您必须是桶拥有者或拥有获取桶存量信息的权限，才能获取桶存量信息。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:GetBucketStorage权限，如果使用桶策略则需授予GetBucketStorage权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS
对象存储服务 OBS-获取桶存量信息(C SDK):方法定义

方法定义 void get_bucket_storage_info(const obs_options *options, int capacity_length, char *capacity, int object_number_length, char *object_number, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-设置桶的网站配置(C SDK):方法定义

方法定义 void set_bucket_website_configuration(const obs_options *options, obs_set_bucket_redirect_all_conf *set_bucket_redirect_all, obs_set_bucket_website_conf *set_bucket_website_conf, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-设置桶的网站配置(C SDK):接口约束

接口约束尽量避免目标桶名中带有“.”，否则通过HTTPS访问时可能出现客户端校验证书出错。设置桶的网站配置请求消息体的上限是10KB。您必须是桶拥有者或拥有设置桶的网站配置的权限，才能设置桶的网站配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutBucketWebsite权限，如果使用桶策略则需授予PutBucketWebsite权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS
对象存储服务 OBS-批量删除多版本对象(C SDK):接口约束

接口约束您必须是桶拥有者或拥有删除对象的权限，才能批量删除多版本对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:DeleteObject权限，如果使用桶策略则需授予DeleteObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。桶没有开启多版本控制功能时，已删除的多版本对象不可恢复，请谨慎操作。

对象存储服务 OBS
对象存储服务 OBS-批量删除多版本对象(C SDK):方法定义

方法定义 void batch_delete_objects(const obs_options *options, obs_object_info *object_info,obs_delete_object_info *delobj, obs_put_properties *put_properties, obs_delete_object_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-获取桶的网站配置(C SDK):接口约束

接口约束您必须是桶拥有者或拥有获取桶的网站配置的权限，才能获取桶的网站配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:GetBucketWebsite权限，如果使用桶策略则需授予GetBucketWebsite权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS 静态网站托管(C SDK)
对象存储服务 OBS-对象下载(C SDK):方法定义

方法定义 void get_object(const obs_options *options, obs_object_info *object_info, obs_get_conditions *get_conditions, server_side_encryption_params *encryption_params, obs_get_object_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-对象下载(C SDK):接口约束

接口约束您必须是桶拥有者或拥有下载对象的权限，才能下载对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:GetObject权限，如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。对于存储类别为归档存储或深度归档存储的对象，需要确认对象的状态为“已恢复”才能对其进行下载。

对象存储服务 OBS
对象存储服务 OBS-创建桶(C SDK):接口约束

接口约束您必须拥有obs:bucket:CreateBucket权限，才能创建桶。建议使用IAM进行授权，配置方式详见使用IAM自定义策略。 OBS支持的region以及region与endPoint的对应关系，详细信息请参见地区与终端节点。创建桶时，如果初始化客户端使用的终端节点（endPoint）为“obs.myhuaweicloud.com”，则可以不指定桶所在区域（location），系统会自动在华北-北京一（cn-north-1）创建桶；如果初始化客户端使用的终端节点（endPoint）不是obs.myhuaweicloud.com，则必须指定桶所在区域（location），且指定的区域必须与终端节点（endPoint）区域一致，否则会返回状态码400。比如初始化时使用的终端节点endPoint是obs.cn-north-4. myhuaweicloud.com，那么在创建桶的时候必须指定Location：cn-north-4 才会创建成功，否则会返回状态码400。同一账号下，可以创建多个存桶，数量上限是100个（不区分地域），存储桶中的对象数量和大小没有限制。新创建桶的桶名在OBS中必须是唯一的。如果是同一个用户重复创建同一区域的同名桶时返回HTTP状态码200。除此以外的其他场景重复创建同名桶返回HTTP状态码409，表明桶已存在。用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。并不是所有区域都支持创建多AZ桶，您可以在产品价格详情页面，查询指定区域是否支持多AZ。

对象存储服务 OBS
对象存储服务 OBS-复制多版本对象(C SDK):方法定义

方法定义 1 2 3 4 5 void copy_object(const obs_options *options, char *key, const char *version_id, obs_copy_destination_object_info *object_info, unsigned int is_copy, obs_put_properties *put_properties, server_side_encryption_params *encryption_params, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-复制多版本对象(C SDK):接口约束

接口约束您必须是桶拥有者或拥有复制对象的权限，才能复制多版本对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。复制多版本对象操作的请求需要通过头域携带复制的源桶和多版本对象信息，不能携带消息实体。目标多版本对象大小范围是[0, 5GB]，如果源多版本对象大小超过5GB，只能使用分段上传-复制段(C SDK)功能复制部分多版本对象。

对象存储服务 OBS
对象存储服务 OBS-判断桶是否存在(C SDK):接口约束

接口约束您必须是桶拥有者或拥有判断桶是否存在的权限，才能判断桶是否存在。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:HeadBucket权限，如果使用桶策略则需授予HeadBucket权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS
对象存储服务 OBS-分段上传-初始化分段上传任务(C SDK):接口约束

接口约束您必须是桶拥有者或拥有初始化分段上传任务的权限，才能初始化分段上传任务。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。初始化上传段任务并上传一个或多个段之后，您必须合并段或取消多段上传任务，才能停止收取已上传的段的存储费用。仅当在合并段或取消多段上传任务之后，OBS才释放段存储并停止向您收取段存储费用。

对象存储服务 OBS
对象存储服务 OBS-分段上传-初始化分段上传任务(C SDK):功能说明

功能说明使用多段上传特性时，用户必须首先调用创建多段上传任务接口创建任务，系统会给用户返回一个全局唯一的多段上传任务号，作为任务标识。后续用户可以根据这个标识发起相关的请求，如：上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象；同一个对象可以同时存在多个多段上传任务；每个多段上传任务在初始化时可以附加消息头信息，包括acl、用户自定义元数据和通用的HTTP消息头contentType、contentEncoding等，这些附加的消息头信息将先记录在多段上传任务元数据中。在指定桶中初始化分段上传任务。

对象存储服务 OBS
对象存储服务 OBS-分段上传-初始化分段上传任务(C SDK):方法定义

方法定义 1 2 3 4 void initiate_multi_part_upload(const obs_options *options, char *key,int upload_id_return_size, char *upload_id_return, obs_put_properties *put_properties, server_side_encryption_params *encryption_params, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-追加写对象(C SDK):接口约束

接口约束您必须是桶拥有者或拥有上传对象的权限，才能上传对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。启用服务端加密SSE-C方式时，追加上传和初始化段一样，设置诸如x-obs-server-side-encryption之类的请求Header，后续追加上传也必须携带。启用服务端加密SSE-KMS方式时，有且只有第一次上传且桶内不存在同名对象时，才设置诸如x-obs-server-side-encryption之类的请求Header，后续追加上传不携带，会继承之前的设置。每次追加上传的长度不能超过对象长度上限5G的限制。每个Appendable对象追加上传次数最多为10000次。如果对象存储类别为COLD（归档存储）或DEEP_ARCHIVE（深度归档存储），则不能调用该接口。如果桶设置了跨区域复制配置，则不能调用该接口。并行文件系统不支持追加上传对象。 put_object上传的对象可覆盖append_object上传的对象，覆盖后对象变为普通对象，不可再进行追加上传。第一次调用追加上传时，如果已存在同名的普通对象，则会抛出异常（HTTP状态码为409）。追加上传返回的ETag是当次追加数据内容的ETag，不是完整对象的ETag。

对象存储服务 OBS
对象存储服务 OBS-追加写对象(C SDK):方法定义

方法定义 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);

对象存储服务 OBS
对象存储服务 OBS-设置对象ACL-上传对象时指定预定义ACL(C SDK):接口约束

接口约束您必须是桶拥有者或拥有设置对象ACL的权限，才能设置对象ACL。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObjectAcl权限，如果使用桶策略则需授予PutObjectAcl权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。一个对象的ACL最多支持配置100条规则。

对象存储服务 OBS
对象存储服务 OBS-设置对象ACL-上传对象时指定预定义ACL(C SDK):方法定义

方法定义 1 2 3 4 void put_object(const obs_options *options, char *key, uint64_t content_length, obs_put_properties *put_properties, server_side_encryption_params *encryption_params, obs_put_object_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-设置对象ACL-上传对象时指定预定义ACL(C SDK):功能说明

功能说明访问控制列表（Access Control List，ACL）用于资源拥有者给其他账号授予资源的访问权限。默认情况下，创建存储桶或对象时仅资源拥有者对资源的完全控制权限，即桶创建者对桶拥有完全控制权限，对象上传者对对象拥有完全控制权限，而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限，可以使用ACL实现。OBS桶和对象的ACL是基于账号进行授权，授权后对账号和账号下的IAM用户都生效。了解更多可参见ACL权限控制方式介绍。可以通过本接口在上传对象时指定预定义ACL。

对象存储服务 OBS
对象存储服务 OBS-复制对象(C SDK):接口约束

接口约束您必须是桶拥有者或拥有复制对象的权限，才能复制对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。复制对象操作的请求需要通过头域携带复制的源桶和对象信息，不能携带消息实体。目标对象大小范围是[0, 5GB]，如果源对象大小超过5GB，只能使用分段上传-复制段(C SDK)功能复制部分对象。

对象存储服务 OBS
对象存储服务 OBS-复制对象(C SDK):方法定义

方法定义 1 2 3 4 5 void copy_object(const obs_options *options, char *key, const char *version_id, obs_copy_destination_object_info *object_info, unsigned int is_copy, obs_put_properties *put_properties, server_side_encryption_params *encryption_params, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS
对象存储服务 OBS-删除桶的CORS配置(C SDK):接口约束

接口约束您必须是桶拥有者或拥有删除桶的CORS配置的权限，才能删除桶的CORS配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutBucketCORS权限，如果使用桶策略则需授予PutBucketCORS权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS 跨域资源共享(C SDK)

共100000条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！