华为云用户手册

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

响应消息元素 在此请求返回的响应消息体中包含的配置元素如下表1描述。 表1 Notification配置元素 名称 描述 NotificationConfiguration 配置桶事件通知的元素，如果此项内容为空，说明通知功能处于关闭状态。 类型：Container 父节点：无 子节点：一个或多个FunctionStageConfiguration FunctionStageConfiguration 配置函数服务的元素。 类型：Container 父节点：NotificationConfiguration 子节点：Id，Filter，FunctionStage，一个或多个Event FunctionStage 函数服务中函数的URN，当OBS检测到桶中发生特定的事件后，将会调用执行该函数。 类型：String 父节点：FunctionStageConfiguration Id 每项事件通知配置的唯一标识，若是用户未指定ID，系统将自动分配一个ID。 类型：String 父节点：FunctionStageConfiguration Filter Object的元素，用以保存过滤对象名的一组规则。 类型：Container 父节点：FunctionStageConfiguration 子节点: Object Object Object的元素，用以保存过滤对象名的一组规则。 类型：Container 父节点：FunctionStageConfiguration FilterRule 定义过滤规则键值对的元素。 类型：Container 父节点：Object 子节点：Name，Value Name 指定规则按对象名前缀或后缀进行过滤。 类型：String 父节点：FilterRule 合法值：prefix或者suffix Value 指定的对象名关键字，用以按照前缀或后缀过滤对象。 类型：String 父节点：FilterRule Event 需要发布通知消息的事件类型。 说明： 在一个FunctionStageConfiguration配置项中可以添加多个事件类型。 类型：String 合法值： 上传对象操作可以取以下值： ObjectCreated:Put ObjectCreated:Post ObjectCreated:Copy ObjectCreated:CompleteMultipartUpload 或者使用通配符支持所有上传操作 ObjectCreated:* 删除对象操作可以取以下值： ObjectRemoved:Delete ObjectRemoved:DeleteMarkerCreated 或者使用通配符支持所有删除操作 ObjectRemoved:* 父节点：FunctionStageConfiguration

响应示例 1 2 3 4 5 6 7 8 9 10 11 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF26000001643632D12EFCE1C1294555 Access-Control-Allow-Origin: www.example.com Access-Control-Allow-Methods: POST,GET,HEAD,PUT,DELETE Access-Control-Max-Age: 100 Access-Control-Expose-Headers: ExposeHeader_1,ExposeHeader_2 Access-Control-Allow-Credentials: true x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAA BCS +DXV4zZetbTqFehhEcuXywTa/mi3T3 Date: WED, 01 Jul 2015 04:02:19 GMT Content-Length: 0

响应消息样式 1 2 3 4 5 6 7 8 9 HTTP/1.1 status_code Content-Type: type Access-Control-Allow-Origin: origin Access-Control-Allow-Methods: method Access-Control-Allow-Header: header Access-Control-Max-Age: time Access-Control-Expose-Headers: header Date: date Content-Length: length

响应消息头 该请求使用的消息头如下表2所示。 表2 CORS请求消息头 消息头名称 描述 Access-Control-Allow-Origin 如果请求的Origin满足服务端的CORS配置，则在响应中包含这个Origin。 类型：String Access-Control-Allow-Headers 如果请求的headers满足服务端的CORS配置，则在响应中包含这个headers。 类型：String Access-Control-Max-Age 服务端CORS配置中的MaxAgeSeconds。 类型：Integer Access-Control-Allow-Methods 如果请求的Access-Control-Request-Method满足服务端的CORS配置，则在响应中包含这条rule中的Methods。 类型：String 有效值：GET、PUT、HEAD、POST 、DELETE Access-Control-Expose-Headers 服务端CORS配置中的ExposeHeader。 类型：String

请求示例 1 2 3 4 5 6 7 8 OPTIONS /object_1 HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 04:02:19 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:bQZG9c2aokAJsHOOkuVBK6cHZZQ= Origin: www.example.com Access-Control-Request-Method: PUT

请求消息头 该请求使用的消息头如下表1所示。 表1 OPTIONS请求消息头 消息头名称 描述 是否必选 Origin 预请求指定的跨域请求Origin（通常为域名）。 类型：String 是 Access-Control-Request-Method 实际请求可以带的HTTP方法，可以带多个方法头域。 类型：String 有效值：GET、PUT、HEAD、POST 、DELETE 是 Access-Control-Request-Headers 实际请求可以带的HTTP头域，可以带多个头域。 类型：String 否

错误响应消息 此请求可能的特殊错误如下表3描述。 表3 特殊错误 错误码 描述 HTTP状态码 Bad Request Invalid Access-Control-Request-Method: null 桶配置了CORS，OPTIONS桶时，没有加入method头域。 400 BadRequest Bad Request Insufficient information. Origin request header needed. 桶配置了CORS，OPTIONS桶时，没有加入origin头域。 400 BadRequest AccessForbidden CORSResponse: This CORS request is not allowed. This is usually because the evalution of Origin, request method / Access-Control-Request-Method or Access-Control-Requet-Headers are not whitelisted by the resource's CORS spec. 桶配置了CORS，OPTIONS桶时，Origin、method、Headers与任一rule匹配不上。 403 Forbidden 其余错误已经包含在表2中。

请求示例 1 2 3 4 5 6 DELETE /?tagging HTTP/1.1 User-Agent: curl/7.19.7 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Wed, 27 Jun 2018 13:46:58 GMT Authorization: authorization string

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content x-obs-request-id: 0002B7532E0000015BEB2C212E53A17L x-obs-id-2: CqT+86nnOkB+Cv9KZoVgZ28pSgMF+uGQBUC68flvkQeq6CxoCz65wWFMNBpXvea4 Content-Length: 0 Date: Wed, 27 Jun 2018 13:46:58 GMT

响应消息元素 在此请求返回的响应消息体中包含的配置元素如下表1描述。 表1 CORS配置元素 名称 描述 CORSConfiguration CORSRules的根节点，最大不超过64 KB。 类型：Container 父节点：无。 CORSRule CORS规则，CORSConfiguration下可最多包含100个规则。 类型：Container 父节点：CORSConfiguration。 ID 一条Rule的标识，由不超过255个字符的字符串组成。 类型：String 父节点：CORSRule。 AllowedMethod CORS规则允许的Method。 类型：String 有效值：GET、PUT、HEAD、POST 、DELETE 父节点：CORSRule。 AllowedOrigin CORS规则允许的Origin（表示域名的字符串），可以带一个匹配符”*”。每一个AllowedOrigin可以带最多一个“*”通配符。 类型：String 父节点：CORSRule。 AllowedHeader 配置CORS请求中允许携带的“Access-Control-Request-Headers”头域。如果一个请求带了“Access-Control-Request-Headers”头域，则只有匹配上AllowedHeader中的配置才认为是一个合法的CORS请求。每一个AllowedHeader可以带最多一个“*”通配符，不可出现空格。 类型：String 父节点：CORSRule。 MaxAgeSeconds 客户端可以缓存的CORS响应时间，以秒为单位。 每个CORSRule可以包含至多一个MaxAgeSeconds，可以设置为负值。 类型：Integer 父节点：CORSRule。 ExposeHeader CORS响应中带的附加头域，给客户端提供额外的信息，不可出现空格。 类型：String 父节点：CORSRule。

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

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 000001682D993B666808E265A3F6361D x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAAB CS 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: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSFUG4fEyDRgzUiEY2i71bJndBCy+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=

请求示例 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=

错误响应消息 如果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 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

请求示例 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 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