华为云用户手册

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: 000001697694073F80E9D3D43BB10B8F x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAA BCS yjWyXNRPSnFymJW0AI59GKpW0Qm9UJ 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 UDS IAM STUBTEST000094:ACgHHA1z+dqZhqS7D2SbU8ugluw=

响应消息元素 该响应以消息元素的形式返回桶的自定义 域名 ，元素的具体意义如表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=

请求示例 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: 32AAAQAAEAABSAAgAAEAABAAAQAAEAAB CS sfu2GXj9gScHhFnrrTPY2cFOEZuvta Date: Wed, 13 Mar 2019 10:22:05 GMT Content-Length: 0

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

请求示例 DELETE /test?inventory&id=id1 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 UDSIAMSTUBTEST000001:UT9F2YUgaFu9uFGMmxFj2CBgQHs=

请求示例 1 2 3 4 5 6 GET /?inventory HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Tue, 08 Jan 2019 09:32:24 +0000 Authorization: OBS UDSIAMSTUBTEST000001:ySWncC9M08jNsyXdJLSMJkpi7XM=

请求示例 GET /?inventory&id=id1 HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Tue, 08 Jan 2019 09:32:24 +0000 Authorization: OBS UDSIAMSTUBTEST000001:ySWncC9M08jNsyXdJLSMJkpi7XM=

响应消息元素 在此请求返回的响应消息体中包含的配置元素如表2。 表2 桶清单响应消息元素 名称 描述 InventoryConfiguration 清单配置。 类型：Container 父节点：无 子节点：Id、IsEnabled、Filter、Destination、Schedule、IncludedObjectVersions以及OptionalFields Id 清单配置的id，必须和请求参数中的清单配置id一致。 类型：String 规格：最长64字节 默认值：无 有效字符："a-z"、"A-Z"、"0-9"、"-"、"_"和"." 父节点：InventoryConfiguration IsEnabled 规则是否启用，如果设置为true，则生成清单，反之不生成。 类型：Boolean 有效值：true、false 父节点：InventoryConfiguration Filter 清单过滤器配置，清单只包含符合过滤器规则的对象（只支持按对象名前缀进行过滤），如果没有配置过滤器，则包含所有对象。 类型：Container 父节点：InventoryConfiguration 子节点：Prefix Prefix 前缀过滤条件，清单文件中只生成以此前缀开头的对象列表。 类型：String 父节点：Filter Schedule 清单文件的生成周期。 类型：Container 父节点：InventoryConfiguration 子节点：Frequency Frequency 清单文件的生成周期，只支持按天和按周生成清单，第一次配置完桶清单，任务会在一个小时内启动，之后每隔一个周期启动一次。 类型：String 父节点：Schedule 有效值：Daily、Weekly Destination 清单的目标配置。 类型：Container 父节点：InventoryConfiguration Format 生成的清单文件的格式，现只支持CSV格式。 类型：String 父节点：Destination 有效值：CSV Bucket 存放清单文件的目标桶的桶名。 类型：String 父节点：Destination Prefix 生成的清单文件对象名会以此前缀开头，如果不配置前缀，则生成的清单文件对象名默认以BucketInventory开头。 类型：String 父节点：Destination IncludedObjectVersions 清单文件中包含对象的多版本配置。 如果设置为All，清单会包含对象所有的版本，清单中会增加版本相关的字段：VersionId、IsLatest、和DeleteMarker。 如果设置为Current，则清单文件中只会列出当前版本信息，不会出现版本相关字段。 类型：String 父节点：InventoryConfiguration 有效值：All、Current OptionalFields 在此选项中可以添加一些额外的对象元数据字段，生成的清单文件中会包含OptionalFields中配置的字段。 类型：Container 父节点：InventoryConfiguration 子节点：Field Field 可选字段类型，OptionalFields可以包含多个Field元素。 类型：String 父节点：OptionalFields 有效值：Size、LastModifiedDate、StorageClass、ETag、IsMultipartUploaded、ReplicationStatus、EncryptionStatus。

响应示例 1 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: 000001682C8545B0680893425D60AB83 x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSIGTuRtBfo7lpHSt0ZknhdDHmllwd/p Date: Tue, 08 Jan 2019 08:12:38 GMT Content-Length: 0

功能介绍 OBS使用PUT操作为一个桶配置清单规则，每个桶最多可以配置10条清单规则，有关更多桶清单的介绍和使用限制，请参考《 对象存储服务 用户指南》的桶清单章节。 要使用此操作，需确保执行者有PutBucketInventoryConfiguration操作的权限 。桶拥有者默认具有此权限，并且可以将此权限授予其他人。 有关权限控制的更多信息请参考《对象存储服务权限配置指南》的OBS权限控制概述章节。

错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误，以及可能原因，如表3。 表3 设置桶清单错误码列表 错误码 描述 HTTP状态码 MalformedXML 清单的XML配置格式错误。 400 Bad Request InvalidArgument 无效参数。 400 Bad Request InventoryCountOverLimit 配置清单数量超过最大限制。 400 Bad Request PrefixExistInclusionRelationship 清单配置中的前缀存在包含关系。 400 Bad Request

请求消息元素 在此请求中，需要在请求的消息体中配置桶的清单。清单的配置信息以XML格式上传。具体的配置元素如表2。 表2 桶的清单配置元素 名称 描述 是否必选 InventoryConfiguration 清单配置。 类型：Container 父节点：无 子节点：Id、IsEnabled、Filter、Destination、Schedule、IncludedObjectVersions以及OptionalFields 是 Id 清单配置的id，必须和请求参数中的清单配置id一致。 类型：String 规格：最长64字节 默认值：无 有效字符："a-z"、"A-Z"、"0-9"、"-"、"_"和"." 父节点：InventoryConfiguration 是 IsEnabled 规则是否启用，如果设置为true，则生成清单，反之不生成。 类型：Boolean 有效值：true、false 父节点：InventoryConfiguration 是 Filter 清单过滤器配置，清单只包含符合过滤器规则的对象（只支持按对象名前缀进行过滤），如果没有配置过滤器，则包含所有对象。 类型：Container 父节点：InventoryConfiguration 子节点：Prefix 否 Prefix 前缀过滤条件，清单文件中只生成以此前缀开头的对象列表。 类型：String 父节点：Filter 否 Schedule 清单文件的生成周期。 类型：Container 父节点：InventoryConfiguration 子节点：Frequency 是 Frequency 清单文件的生成周期，只支持按天和按周生成清单，第一次配置完桶清单，任务会在一个小时内启动，之后每隔一个周期启动一次。 类型：String 父节点：Schedule 有效值：Daily、Weekly 是 Destination 清单的目标配置。 类型：Container 父节点：InventoryConfiguration 是 Format 生成的清单文件的格式，现只支持CSV格式。 类型：String 父节点：Destination 有效值：CSV 是 Bucket 存放清单文件的目标桶的桶名。 类型：String 父节点：Destination 是 Prefix 生成的清单文件对象名会以此前缀开头，如果不配置前缀，则生成的清单文件对象名默认以BucketInventory开头。 类型：String 父节点：Destination 否 IncludedObjectVersions 清单文件中包含对象的多版本配置。 如果设置为All，清单会包含对象所有的版本，清单中会增加版本相关的字段：VersionId、IsLatest、和DeleteMarker。 如果设置为Current，则清单文件中只会列出当前版本信息，不会出现版本相关字段。 类型：String 父节点：InventoryConfiguration 有效值：All、Current 是 OptionalFields 在此选项中可以添加一些额外的对象元数据字段，生成的清单文件中会包含OptionalFields中配置的字段。 类型：Container 父节点：InventoryConfiguration 子节点：Field 否 Field 可选字段类型，OptionalFields可以包含多个Field元素。 类型：String 父节点：OptionalFields 有效值：Size、LastModifiedDate、StorageClass、ETag、IsMultipartUploaded、ReplicationStatus、EncryptionStatus。 否

响应消息元素 该响应中将桶存量信息以消息元素的形式返回，元素的具体含义如表1所示。 表1 响应消息元素 元素名称 描述 GetBucketStorageInfoResult 保存桶存量请求结果，包含存量大小和对象个数。 类型：XML Size 返回存量大小。 类型：Long ObjectNumber 返回对象个数。 类型：Integer StandardSize 返回STANDARD存储类型的存量大小。当无STANDARD存储类型对象时不返回此字段。 类型：Long StandardObjectNumber 返回STANDARD对象个数。当无STANDARD存储类型对象时不返回此字段。 类型：Integer WarmSize 返回WARM存储类型的存量大小。当无WARM存储类型对象时不返回此字段。 类型：Long WarmObjectNumber 返回WARM对象个数。当无WARM存储类型对象时不返回此字段。 类型：Integer ColdSize 返回COLD存储类型的存量大小。当无COLD存储类型对象时不返回此字段。 类型：Long ColdObjectNumber 返回COLD对象个数。当无COLD存储类型对象时不返回此字段。 类型：Integer DeepArchiveSize 返回DEEP_ARCHIVE存储类型的存量大小。当无DEEP_ARCHIVE存储类型对象时不返回此字段。 类型：Long DeepArchiveObjectNumber 返回DEEP_ARCHIVE对象个数。当无DEEP_ARCHIVE存储类型对象时不返回此字段。 类型：Integer

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

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

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

响应示例 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

请求示例 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 2 3 4 5 6 GET /?tagging HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: Wed, 27 Jun 2018 13:25:44 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:H1INcyc5i0XlHqYTfuzkPxLZUPM=

响应消息元素 在此请求返回的响应消息体中包含的配置元素如下表1。 表1 桶标签配置元素 名称 描述 Tagging TagSet和Tag的元素 类型：Container 父元素：无 TagSet Tag的集合元素 类型：Container 父元素：Tagging Tag Tag信息的元素 类型：Container 父元素：TagSet Key Tag的名字 类型：String 父元素：Tag Value Tag的值 类型：String 父元素：Tag

功能介绍 OBS使用PUT操作为一个已经存在的桶添加标签。 为桶添加标签后，该桶上所有请求产生的计费话单里都会带上这些标签，从而可以针对话单报表做分类筛选，进行更详细的成本分析。例如：某个应用程序在运行过程会往桶里上传数据，我们可以用应用名称作为标签，设置到被使用的桶上。在分析话单时，就可以通过应用名的标签来分析此应用的成本。 要正确执行此操作，需要确保执行者有PutBucketTagging权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。

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

请求消息头 该请求使用的消息头如下表1所示。 表1 请求消息头 消息头名称 描述 是否必选 Content-MD5 按照RFC 1864标准计算出消息体的MD5摘要字符串，即消息体128-bit MD5值经过base64编码后得到的字符串。也支持设置Content-SHA256头域，其值为消息体256-bit SHA256值经过base64编码后得到的字符串，Content-MD5和Content-SHA256二选一。 类型：String 示例：n58IG6hfM7vqI4K0vnWpog== 是

响应示例 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=