检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
业备份/归档、视频点播、视频监控等多种数据存储场景。 您可以使用本文档提供的API对OBS进行相关操作,如创建、修改、删除桶,上传、下载、删除对象等。支持的全部操作请参见API概览。 在调用OBS API之前,请确保已经充分了解OBS相关概念,详细信息请参见产品介绍。 父主题:
调用说明 OBS提供了REST(Representational State Transfer)风格API,支持您通过HTTP/HTTPS请求调用,调用方法请参见如何调用API。 同时OBS还提供多种编程语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题:
快速入门 创建桶 获取桶列表 上传对象
后的读取操作有可能成功读取到数据,也有可能读不到数据。建议客户端在出现上述错误时,查询数据是否已经上传成功,如果不成功则重新上传。 针对同一个对象或桶的操作,比如多个客户端对同一个对象并行上传、查询和删除时,具体操作结果依赖于操作到达系统的时间和系统内部处理的时延,可能返回不一致
计算表单签名的2种方式 计算方式 描述 更多参考 SDK OBS所有语言的SDK都已实现表单上传签名,无需手动进行签名计算。推荐您直接使用SDK进行接口调用,更方便快捷。 SDK签名实现 手动编码计算签名 按照签名算法手动编码计算签名。 签名算法 SDK签名实现 表6 OBS SDK Header携带签名的实现
是否成功。 注:请使用符合https://www.ietf.org/rfc/rfc2616.txt规定的HTTP/HTTPS请求格式发送API请求。 父主题: 附录
获取桶存量信息(Python SDK) 功能介绍 调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。 由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。 接口约束 您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存
在OBS中存储数据。 下面介绍如何调用创建桶API在指定的区域创建一个桶,API的调用方法请参见如何调用API。 前提条件 已获取AK和SK,获取方法参见获取访问密钥(AK/SK)。 您需要规划桶所在的区域信息,并根据区域确定调用API的Endpoint,详细信息请参见地区和终端节点。
请确认该区域是否支持所调用的接口功能。各语言SDK支持的功能请参见SDK功能矩阵,各功能发布的区域请参见OBS功能总览。 405 Method Not Allowed FsNotSupport posix桶不支持该API。 方法不允许。 请确认该区域是否支持所调用的接口功能。各语言SDK支
权限和授权项 权限及授权项说明 桶相关授权项 对象相关授权项
两种方式单次上传对象大小范围均为[0, 5GB],如果需要上传超过5GB的大文件,需要通过多段上传实现。 关于PUT和POST上传更详细的API信息,请参见API参考PUT上传和POST上传。 父主题: API和SDK等开发者相关
上传对象 操作场景 您可以根据需要,将任何类型的文件上传到OBS桶中进行存储。 下面介绍如何调用PUT上传API在指定的桶中上传对象,API的调用方法请参见如何调用API。 前提条件 已获取AK和SK,获取方法参见获取访问密钥(AK/SK)。 已创建了至少一个可用的桶。 已准备好
获取用户ID请参考:管理员查询IAM用户列表。 获取项目ID请参考:查询指定条件下的项目列表。 获取用户组名称和ID 登录华为云,进入IAM控制台,选择“用户组”页签。 单击需要查询的用户组前的下拉框,即可查询用户组名称、用户组ID。 图3 查询用户组名称、用户组ID 获取区域ID
对象相关授权项 表1 对象相关授权项列表 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 可用作于PUT上传对象,POST上传对象,复制对象,追加写对象,初始化上传段任务,上传段,拷贝段,合并段 PUT上传
桶相关授权项 表1 桶相关授权项列表 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 列举全部桶 获取桶列表 obs:bucket:ListAllMyBuckets √ √ 创建桶 创建桶 obs:bucket:CreateBucket
获取桶存量信息(Go SDK) 功能介绍 调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。 由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。 接口约束 您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存
format_exc()) # 关闭workflowClient workflowClient.close() 相关链接 关于查询工作流的API说明,请参见查询工作流。 查询工作流过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 父主题: 工作流管理
账号具备所有接口的调用权限,如果使用账号下的IAM用户发起API请求时,该IAM用户必须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要
加密密钥类型您也可以选择“自定义密钥”,通过单击“查看KMS密钥”进入数据加密服务页面创建自定义密钥,然后通过KMS密钥的下拉框选中您创建的KMS密钥。 加密密钥类型您还可以选择“共享密钥”,输入共享密钥ID,您上传的对象将使用其他用户共享的密钥进行加密。获取共享密钥ID,具体请参见查看密钥。 说明: 支持配
format_exc()) # 关闭workflowClient workflowClient.close() 相关链接 关于查询工作流实例的API说明,请参见查询工作流实例。 查询工作流实例过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 父主题: 工作流实例管理