华为云用户手册

对象存储服务 OBS-断点续传下载(C SDK):功能说明

功能说明当下载大对象到本地文件时，经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源，而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败，其原理是将待下载的对象分成若干个分段分别下载，并实时地将每段下载结果统一记录在checkpoint文件中，仅当所有分段都下载成功时返回下载成功的结果，否则返回错误信息提醒用户再次调用接口进行重新下载（重新下载时因为有checkpoint文件记录当前的下载进度，避免重新下载所有分段，从而节省资源提高效率）。您可以通过download_file进行断点续传下载。

对象存储服务 OBS
对象存储服务 OBS-断点续传下载(C SDK):方法定义

方法定义 void download_file(const obs_options *options, char *key, char* version_id, obs_get_conditions *get_conditions, server_side_encryption_params *encryption_params, obs_download_file_configuration * download_file_config, obs_download_file_response_handler *handler, void *callback_data);

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

接口约束您必须是桶拥有者或拥有下载对象的权限，才能下载对象。建议使用 IAM 或桶策略进行授权，如果使用IAM则需授予obs:object:GetObject权限，如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。断点续传下载接口是利用范围下载特性实现的，是对范围下载的封装和加强。断点续传下载接口不仅能在失败后重试下载时节省资源提高效率，还因其对分段进行并发下载的机制能加快下载速度，帮助用户快速完成下载业务；且其对用户透明，用户不用关心checkpoint文件的创建和删除、分段任务的切分、并发下载的实现等内部细节。

对象存储服务 OBS
对象存储服务 OBS-设置桶日志管理配置(C SDK):接口约束

接口约束由于日志文件是OBS产生，并且由OBS上传到存放日志的桶中，因此OBS需要获得委托授权，用于上传生成的日志文件，所以在配置桶日志管理前，需要先到统一身份认证服务生成一个对OBS服务的委托，委托配置权限只需设置目标桶的上传对象权限。如何创建委托请参考创建云服务委托。您必须是桶拥有者或拥有设置桶日志管理配置的权限，才能设置桶日志管理配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutBucketLogging权限，如果使用桶策略则需授予PutBucketLogging权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS 设置访问日志(C SDK)
对象存储服务 OBS-设置桶日志管理配置(C SDK):功能说明

功能说明调用设置桶日志管理配置接口，您可以为指定桶打开桶日志功能，并配置日志存放的目标桶。创建桶时，默认是不生成桶的日志的，调用C SDK的设置桶日志管理配置接口时，接口会自动为您打开桶日志配置。桶日志功能开启后，桶的每次操作将会产生一条日志，并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定，可以存放到开启日志功能的桶中，也可以存放到其他您有权限的桶中，但需要和开启日志功能的桶在同一个region中。您还可以根据需要配置日志文件的访问权限，以及日志文件的文件名前缀。

对象存储服务 OBS 设置访问日志(C SDK)
对象存储服务 OBS-设置桶日志管理配置(C SDK):方法定义

方法定义 void set_bucket_logging_configuration_obs(const obs_options *options, char *target_bucket, char *target_prefix, char *agency, obs_acl_group *acl_group, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS 设置访问日志(C SDK)
对象存储服务 OBS-分段上传-列举已上传的段(C SDK):功能说明

功能说明通过分段上传任务的ID，列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求，OBS将返回有关特定多段上传任务的分段信息，最多为1000个分段。如果多段上传中的段超过1000个，您必须发送一系列列举已上传的段请求以检索所有段。请注意，返回的分段列表不包括已合并的分段。

对象存储服务 OBS
对象存储服务 OBS-分段上传-列举已上传的段(C SDK):接口约束

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

对象存储服务 OBS
对象存储服务 OBS-重命名对象(C SDK):接口约束

接口约束您必须是并行文件系统拥有者或拥有重命名文件的权限，才能重命名文件。建议使用IAM或策略进行授权，如果使用IAM则需授予obs:bucket:PutObject权限，如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的region以及region与endPoint的对应关系，详细信息请参见地区与终端节点。目前接口仅在并行文件系统支持，普通对象桶不支持。重命名时，如果源对象不存在，则会报错（HTTP状态码为404）。

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

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

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

接口约束待删除的桶必须为空，桶为空包含两方面含义：桶内没有任何对象，没有对象的任何历史版本，没有对象的删除标记（删除标记也视作一个历史版本）。桶内没有任何未合并的多段上传任务，即桶内不存在碎片。您必须是桶拥有者或拥有删除桶的权限，才能删除桶。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:DeleteBucket权限，如果使用桶策略则需授予DeleteBucket权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。

对象存储服务 OBS
对象存储服务 OBS-恢复归档或深度归档存储对象(C SDK):接口约束

接口约束您必须是桶拥有者或拥有恢复归档或深度归档存储对象的权限，才能恢复归档或深度归档存储对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:RestoreObject权限，如果使用桶策略则需授予RestoreObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。重复恢复归档或深度归档存储对象时在延长恢复有效期的同时，也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类别的对象副本有效期将会延长，并且收取延长时间段产生的标准存储副本费用。

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

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

对象存储服务 OBS
对象存储服务 OBS-获取桶的生命周期配置(C SDK):接口约束

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

对象存储服务 OBS
对象存储服务 OBS-获取桶的多版本状态(C SDK):接口约束

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

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

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

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

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

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

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

对象存储服务 OBS
对象存储服务 OBS-设置多版本对象ACL-直接设置对象ACL(C SDK):功能说明

功能说明 OBS支持对多版本对象的操作进行权限控制。默认情况下，只有多版本对象的创建者才有该多版本对象的读写权限。用户也可以设置其他的访问策略，比如对一个多版本对象可以设置公共访问策略，允许所有人对其都有读权限。SSE-KMS方式加密的多版本对象即使设置了ACL，跨租户也不生效。 OBS用户在上传多版本对象时可以设置权限控制策略，也可以通过ACL操作API接口对已存在的多版本对象更改或者获取ACL(access control list) 。可以通过本接口设置指定桶中多版本对象ACL。

对象存储服务 OBS
对象存储服务 OBS-设置多版本对象ACL-直接设置对象ACL(C SDK):接口约束

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

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

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

对象存储服务 OBS 多段相关接口(C SDK)
对象存储服务 OBS-设置桶的生命周期配置(C SDK):接口约束

接口约束单个桶的生命周期规则条数没有限制，但一个桶中所有生命周期规则的XML描述总大小不能超过20KB。您最多可以在一个桶下配置20条生命周期管理规则，超过20条将提示不支持。您必须是桶拥有者或拥有设置桶的生命周期配置的权限，才能设置桶的生命周配置。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:bucket:PutLifecycleConfiguration权限，如果使用桶策略则需授予PutLifecycleConfiguration权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、自定义创建桶策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。对象生命周期到期以后，对象将会永久删除，无法恢复。归档存储和深度归档存储不支持多AZ，因此不支持使用生命周期的存储类别转换功能，将多AZ的桶或对象转化为归档或深度归档存储。低频访问存储的最低存储时间为30天，归档存储的最低存储时间为90天，深度归档存储的最低存储时间为180天。如果对象经过转换，归档存储时间少于最低存储时间，需要补足剩余天数的存储费用。

对象存储服务 OBS 生命周期管理(C SDK)
对象存储服务 OBS-设置桶的生命周期配置(C SDK):方法定义

方法定义 void set_bucket_lifecycle_configuration(const obs_options *options, obs_lifecycle_conf* bucket_lifecycle_conf, unsigned int blcc_number, obs_response_handler *handler, void *callback_data);

对象存储服务 OBS 生命周期管理(C SDK)
对象存储服务 OBS-批量删除对象(C SDK):接口约束

接口约束您必须是桶拥有者或拥有批量删除对象的权限，才能批量删除对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:DeleteObject权限，如果使用桶策略则需授予DeleteObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。 OBS支持的Region与Endpoint的对应关系，详细信息请参见地区与终端节点。桶没有开启多版本控制功能时，已删除的对象不可恢复，请谨慎操作。批量删除对象一次能接收最大对象数目为1000个，如果超出限制，服务端会返回请求不合法。并发任务分配后，在循环删除多个对象过程中，如果发生内部错误，有可能出现数据不一致的情况（某个对象索引数据删除但还有元数据）。

对象存储服务 OBS 管理对象(C SDK)
对象存储服务 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 管理对象(C SDK)
对象存储服务 OBS-设置桶的多版本状态(C SDK):接口约束

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

对象存储服务 OBS
对象存储服务 OBS-设置多版本对象ACL-为对象设置预定义访问策略(C SDK):功能说明

功能说明 OBS支持对多版本对象的操作进行权限控制。默认情况下，只有多版本对象的创建者才有该多版本对象的读写权限。用户也可以设置其他的访问策略，比如对一个多版本对象可以设置公共访问策略，允许所有人对其都有读权限。SSE-KMS方式加密的多版本对象即使设置了ACL，跨租户也不生效。 OBS用户在上传多版本对象时可以设置权限控制策略，也可以通过ACL操作API接口对已存在的多版本对象更改或者获取ACL(access control list) 。可以通过本接口设置指定桶中多版本对象ACL。

对象存储服务 OBS 多版本控制(C SDK)
对象存储服务 OBS-设置多版本对象ACL-为对象设置预定义访问策略(C SDK):接口约束

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

对象存储服务 OBS 多版本控制(C SDK)
对象存储服务 OBS-获取桶存储类别(C SDK):接口约束

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

对象存储服务 OBS 管理桶(C SDK)
对象存储服务 OBS-创建文件夹(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 上传对象(C SDK)

共100000条

undefined

意见反馈

0/200

提交取消

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