华为云用户手册

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 000001682D993B666808E265A3F6361D x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAA BCS yB46jGSQsu06m1nyIeKxTuJ+H27ooC Date: Tue, 08 Jan 2019 13:14:03 GMT

请求示例 1 2 3 4 5 6 DELETE /examplebucket?encryption HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Tue, 08 Jan 2019 13:18:35 +0000 Authorization: OBS UDS IAM STUBTEST000001:UT9F2YUgaFu9uFGMmxFj2CBgQHs=

请求示例 1 2 3 4 5 6 DELETE /?website HTTP/1.1 User-Agent: curl/7.29.0 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 03:44:37 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:AZ1b0N5eLknxNOe/c0BISV1bEqc=

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: BF2600000164363786230E2001DC0807 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAAB CS FUG4fEyDRgzUiEY2i71bJndBCy+wUZ Date: WED, 01 Jul 2015 03:44:37 GMT

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 900B000001643FE6BBCC9C9F54FA7A7E x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCS8Exs52zCf9duxPLnBircmGa/JOCjec Date: Wed, 27 Jun 2018 13:45:50 GMT

请求示例 1 2 3 4 5 6 DELETE /?replication HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Wed, 27 Jun 2018 13:45:50 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:3ycNYD0CfMf0gOmmXzdGJ58KjHU=

请求示例 1 2 3 4 5 6 GET /?quota HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 03:27:45 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:8m4bW1gFCNeXQlfu45uO2gpo7l8=

错误响应消息 如果AccessKey或签名无效，OBS返回403 Forbidden，错误码为AccessDenied。 如果请求的桶不存在，OBS返回404 Not Found，错误码为NoSuchBucket。 用户执行取消多段上传任务操作时判断用户是否是任务初始化者或是桶的所有者，如果不是则OBS则返回403 Forbidden。 操作成功，OBS向用户返回204 No Content。 其他错误已包含在表2中。

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 8DF400000163D463E02A07EC2295674C x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTp5YDlzn0UgqG3laRfkHLGyz7RpR9ON Date: WED, 01 Jul 2015 05:28:27 GMT

请求示例 1 2 3 4 5 6 DELETE /object02?uploadId=00000163D46218698DF407362295674C HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 05:28:27 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:QmM2d1DBXZ/b8drqtEv1QJHPbM0=

请求示例 1 2 3 4 5 6 GET /?storageClass HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 03:20:28 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:0zVTSdKG6OFCIH2dKvmsVGYCQyw=

请求示例 1 2 3 4 5 6 7 PUT /?customdomain=obs.ccc.com HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Mon, 14 Jan 2019 08:31:36 +0000 Authorization: OBS UDSIAMSTUBTEST000094:u2kJF4kENs6KlIDcAZpAKSKPtnc= Content-Length: 0

请求消息样式 1 2 3 4 5 6 7 PUT /?customdomain=domainname HTTP/1.1 User-Agent: curl/7.29.0 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: date Authorization: authorization string Content-Length: 0

响应示例 1 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: 000001697692CC5380E9D272E6D8F830 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSsfu2GXj9gScHhFnrrTPY2cFOEZuvta Date: Wed, 13 Mar 2019 10:22:05 GMT Content-Length: 0

请求消息元素 表1 请求消息元素表 名字 描述 是否必选 RestoreRequest 恢复信息的容器 类型：Container 是 Days 恢复对象的保存时间，最小值为1，最大值为30。 类型：Integer 是 RestoreJob 恢复选项的容器 类型：Container 否 Tier 恢复选项，支持两种取值：[Expedited|Standard]。 Expedited表示快速恢复对象，归档存储恢复耗时1~5 min，深度归档（受限公测）存储恢复约耗时3~5 h。 Standard表示标准恢复对象，归档存储恢复耗时3~5 h，深度归档（受限公测）存储恢复约耗时5~12 h。 说明： 对于深度归档对象，大批量恢复建议使用标准恢复，且对象最终恢复时间受对象大小以及取回数据量的影响。 默认取值为Standard。 类型：String 否

响应示例 1 2 3 4 5 6 HTTP/1.1 202 Accepted Server: OBS x-obs-request-id: A2F500000163F374CCBB2063F834C6C4 x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCSLbWIs23RR95NVpkbWlJdlm8Dq+wQBw Date: WED, 01 Jul 2015 04:39:46 GMT Content-Length: 0

响应示例 1 2 3 4 5 6 7 HTTP/1.1 200 Date: Wed, 08 Jul 2015 06:57:02 GMT ETag: "d41d8cd98f00b204e9800998ecf8427e" Content-Length: 0 Server: OBS x-obs-request-id: 8DF400000163D3F0FD2A03D2D30B0542 x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCTjCqTmsA1XRpIrmrJdvcEWvZyjbztd

请求示例 PUT /ObjectName?modify&position=Position HTTP/1.1 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Date: Wed, 08 Jul 2015 06:57:01 GMT Content-Type: image/jpg Content-Length: 1458 Authorization: OBS H4IPJX0TQTHTHEBQQCEC:kZoYNv66bsmc10+dcGKw5x2PRrk= [1458 bytes of object data]

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 000001697694073F80E9D3D43BB10B8F x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSyjWyXNRPSnFymJW0AI59GKpW0Qm9UJ Date: Wed, 13 Mar 2019 10:23:26 GMT

请求示例 1 2 3 4 5 6 DELETE /?customdomain=obs.ccc.com HTTP/1.1 User-Agent: curl/7.29.0 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Mon, 14 Jan 2019 08:27:50 +0000 Authorization: OBS UDSIAMSTUBTEST000094:ACgHHA1z+dqZhqS7D2SbU8ugluw=

响应示例 1 2 3 4 5 6 7 HTTP/1.1 100 Continue HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016435E09A2BCA388688AA08 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSHbmBecv7ohDSvqaRObpxzgzJ9+l8xT Date: WED, 01 Jul 2015 03:24:37 GMT Content-Length: 0

功能介绍 桶空间配额值必须为非负整数，单位为Byte（字节），能设的最大值为263-1。桶的默认配额为0，表示没有限制桶配额。 桶配额设置后，如果想取消配额限制，可以把配额设置为0。 由于桶配额的校验依赖于桶存量，而桶存量是后台计算，因此桶配额可能不会及时生效，存在滞后性。可能会出现桶存量超出配额或者删除数据后存量未能及时回落的情况。 桶存量查询接口请参见获取桶存量信息。 桶存量超出配额后再上传对象，会返回HTTP状态码403 Forbidden，错误码InsufficientStorageSpace。请扩大配额，或取消配额限制（设置为0），或删除不需要的对象。

请求示例 1 2 3 4 5 6 GET /?lifecycle HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 03:06:56 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:/Nof9FCNANfzIXDS0NDp1IfDu8I=

响应消息元素 在此请求返回的响应消息体中包含的配置元素如下表1描述。 表1 生命周期配置元素 名称 描述 Date 指定OBS对该日期之前的对象执行生命周期规则。日期格式必须为ISO8601的格式，并且为UTC的零点。 例如：2018-01-01T00:00:00.000Z，表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型，等于或晚于这个时间的对象不会被删除或转储。 类型：String 父节点：Expiration, Transition Days 指定在对象最后修改时间的多少天后执行生命周期规则（仅针对对象的最新版本）。 类型：Integer 父节点：Expiration, Transition StorageClass 表示对象将被修改成存储级别。 类型：String 取值范围：WARM或COLD 父节点：Transition, NoncurrentVersionTransition Transition 生命周期配置中表示迁移时间和迁移后对象存储级别的元素（仅针对对象的最新版本） 类型：XML 子节点：Date或Days 父节点：Rule Expiration 生命周期配置中表示过期时间的Container。 类型：XML 子节点：Date或Days 父节点：Rule ID 一条Rule的标识，由不超过255个字符的字符串组成。 类型：String 父节点：Rule LifecycleConfiguration 生命周期配置Rule的Container。可以配置多条Rule，但需保证整个配置消息体总大小不超过20KB。 类型：XML 子节点：Rule 父节点：无 NoncurrentDays 表示对象在成为历史版本之后第几天时规则生效。 类型：Integer 父节点：NoncurrentVersionExpiration, NoncurrentVersionTransition NoncurrentVersionTransition 生命周期配置中表示对象的历史版本迁移时间和迁移后对象存储级别的元素。 类型：XML 子节点：NoncurrentDays, StorageClass 父节点：Rule NoncurrentVersionExpiration 生命周期配置中表示历史版本过期时间的Container。您可以将该动作设置在已启用多版本（或暂停）的桶，来让系统删除对象的满足特定生命周期的历史版本。 类型：XML 子节点：NoncurrentDays 父节点：Rule AbortIncompleteMultipartUpload 生命周期配置中表示未合并的多段任务（碎片）的过期属性Container 类型：XML 子节点：DaysAfterInitiation 父节点：Rule DaysAfterInitiation 指定未合并的多段任务（碎片）的生命周期规则，在多段任务初始化过后多少天生效。 类型：Integer 父节点：AbortIncompleteMultipartUpload Prefix 对象名前缀，用以标识哪些对象可以匹配到当前这条Rule。 类型：String 父节点：Rule Rule 具体某一条生命周期配置的Container。 类型：Container 父节点：LifecycleConfiguration Status 标识当前这条Rule是否启用。 类型：String 父节点：Rule 有效值：Enabled，Disabled

响应消息元素 该请求的响应中以消息元素的形式返回桶的归档对象直读状态，元素的具体意义如表1所示。 表1 响应消息元素 名字 描述 DirectColdAccessConfiguration 归档对象直读状态信息的元素。 类型：Container Status 标识桶的归档对象直读状态。如果从未设置桶的归档对象直读状态，或者已经删除桶的归档对象直读状态，则不会返回桶的归档对象直读状态。 类型：String 有效值：Enabled，Disabled

请求示例 1 2 3 4 5 6 GET /?directcoldaccess HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 03:15:20 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:4N5qQIoluLO9xMY0m+8lIn/UWXM=

响应消息元素 该响应以消息元素的形式返回桶的自定义域名，元素的具体意义如表1响应消息元素所示。 表1 响应消息元素 元素名称 描述 ListBucketCustomDomainsResult 自定义域名返回结果容器。 类型：Container 子节点：Domains 父节点：无 Domains 自定义域名元素。 类型：Container 子节点：DomainName、CreateTime 父节点：ListBucketCustomDomainsResult DomainName 自定义域名。 类型：String 子节点：无 父节点:：Domains CreateTime 自定义域名创建时间。 类型：String，UTC时间 子节点：无 父节点:：Domains

请求示例 1 2 3 4 5 6 GET /?customdomain HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Mon, 14 Jan 2019 08:31:45 +0000 Authorization: OBS UDSIAMSTUBTEST000094:veTm8B18MPLFqNyGh2wmQqovZ2U=

重命名并行文件系统中文件 您可以通过API、SDK、OBS Browser+三种方式对重命名并行文件系统中文件。 通过API重命名对象 重命名对象Java SDK 使用OBS Browser+： 登录OBS Browser+。 若未安装OBS Browser+，请先下载并安装。 在并行文件系统列表中，单击目标并行文件系统。 在文件列表中，单击需要重命名文件操作列的。 单击“重命名”。 在弹出窗口中输入新的文件名，单击“确定”。

接口约束 桶版本限制： 只有OBS 3.0的桶支持配置清单，目标桶无OBS版本限制。 清单数量限制： 一个桶最多支持10条桶清单。 源桶和目标桶限制： 桶清单配置的源桶和目标桶必须归属同一个账号。 桶清单配置的源桶和目标桶必须归属同一个区域。 桶清单中配置的目标桶不能开启桶默认加密。 功能限制： 只支持生成CSV格式的清单文件。 桶清单筛选条件目前仅支持设置为所有对象或指定前缀的对象。 同一个桶中多条清单规则的筛选条件不能彼此包含： 如果已经存在针对桶中所有对象的规则，则无法再创建按对象名前缀筛选的规则。如需创建，要先删除针对所有对象的规则。 如果已经存在按对象名前缀筛选的规则，则无法再创建针对桶中所有对象的规则。如需创建，要先删除所有按对象名前缀筛选的规则。 如果已经存在某个按对象名前缀筛选的规则（如前缀ab），则无法再创建与其存在包含或被包含关系的规则（如前缀a或前缀abc）。如需创建，要先删除存在包含或被包含关系的规则。 桶清单加密方式目前只支持SSE-KMS。 权限限制： 清单文件使用OBS系统用户上传到目标桶，目标桶必须给OBS系统用户写权限。 其他： 暂不对桶清单功能收费，桶清单生成后只按照存量计费。