华为云用户手册

响应消息元素 在此请求返回的响应消息体中包含的配置元素如下描述。 表1 桶的复制配置元素 名称 描述 ReplicationConfiguration 复制规则的容器，最多可以达到100条规则，所有的复制配置大小可达到50KB 。 类型：Container 子节点：Rule 父节点：无 Agency 用户创建的委托名字，最大长度为64字符。 类型：String 父节点：ReplicationConfiguration Rule 一条特定复制规则信息的容器。 复制配置必须至少配置一条规则，最多能达到100条规则。 类型：Container 父节点：ReplicationConfiguration ID 规则的特殊辨识符，最大长度为255字符。 类型：String 父节点：Rule Status 如果Status为Disabled，这条规则会被忽略。 类型：String 父节点：Rule 有效值：Enabled，Disabled Prefix 对象键值名的前缀，适配于一个或者多个对象。如果前缀配置为空，则跨区域复制规则将作用于整个桶。 经过UTF-8编码的长度大于0且不超过1024的字符序列，不支持重叠的前缀。 类型：String 父节点：Rule Destination 目标桶信息的容器。 类型：Container 父节点：Rule Bucket 存储被规则标识的对象副本的桶名称。 如果在复制配置中有多条规则，这些规则必须都要标识同一个桶作为目标桶。 类型：String 父节点：Destination StorageClass 对象的存储类型。 类型：String 父节点：Destination 有效值：STANDARD|WARM|COLD DeleteData 删除同步复制关键字，如果为Enabled，源桶的对象删除操作会复制到目标端。 类型：String 父节点：Destination 有效值：Enabled,Disabled（如果不设置，则默认为Disabled） HistoricalObjectReplication 历史对象复制关键字，如果为Enabled，会复制符合这条规则的历史对象。 类型：String 父节点：Rule 有效值：Enabled,Disabled（如果不设置，则默认为Disabled）

响应示例 1 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: B59500000164417839932E5A2295674C x-obs-id-2: 32AAAQAAEAABKAAQAAEAABAAAQAAEAA BCS tv51t2NMMx+Ou+ow7IWV4Sxo231fKe Date: Wed, 27 Jun 2018 13:39:15 GMT Content-Length: 0

功能介绍 跨区域复制是指跨不同区域中的桶自动、异步地复制对象。通过激活跨区域复制，OBS可将新创建的对象及修改的对象从一个源桶复制到不同区域中的目标桶。 配置跨区域复制需要选择 IAM 委托，配置方法请参见创建IAM委托。 设置桶的跨区域复制，需要满足以下两个要求： 要求源桶和目标桶多版本状态保持一致，否则不能设置replication。如何设置桶的多版本，请参见设置桶的多版本状态。 源桶的拥有者和代理人（OBS）必须要有目标桶的写权限（目标桶需要配置BucketPolicy），同时代理人（OBS）还要有源桶的读权限。这需要通过“BucketPolicy”来实现这个权限委托。 如何设置桶策略，请参见设置桶策略。设置桶策略后，代理人（OBS）就有权限可以读取源桶的对象，也有权限将对象复制到目标桶中。

请求消息头 该请求使用的消息头如下所示。 表1 设置桶的复制配置请求消息头 名称 描述 是否必选 Content-MD5 按照RFC 1864标准计算出消息体的MD5摘要字符串，即消息体128-bit MD5值经过base64编码后得到的字符串。如何计算Content-MD5可参考Java中Content-MD5的计算方法示例。也支持设置Content-SHA256头域，其值为消息体256-bit SHA256值经过base64编码后得到的字符串，Content-MD5和Content-SHA256二选一。 是

请求消息元素 在此请求中，需要在请求的消息体中配置桶的复制配置，通知的配置信息以XML格式上传。具体的配置元素如下描述。 表2 设置桶的复制配置元素 名称 描述 是否必须 ReplicationConfiguration 复制规则的容器，最多可以达到100条规则，所有的复制配置大小可达到50KB。 类型：Container 子节点:Rule 父节点:无 是 Agency 用户创建的委托名字，最大长度为64字符。 类型：String 父节点：ReplicationConfiguration 是 Rule 一条特定复制规则信息的容器。 复制配置必须至少配置一条规则，最多能达到100条规则。 类型：Container 父节点: ReplicationConfiguration 是 ID 规则的特殊辨识符，最大长度为255字符。 类型：String 父节点:Rule 否 Status 如果Status为Disabled，这条规则会被忽略。 类型：String 父节点：Rule 有效值：Enabled,Disabled 是 Prefix 对象键值名的前缀，适配于一个或者多个对象。如果前缀配置为空，则跨区域复制规则将作用于整个桶。 经过UTF-8编码的长度大于0且不超过1024的字符序列，不支持重叠的前缀。 类型：String 父节点:Rule 是 Destination 目标桶信息的容器。 类型：Container 父节点:Rule 是 Bucket 存储被规则标识的对象副本的桶名称。 如果在复制配置中有多条规则，这些规则必须都要标识同一个桶作为目标桶。 类型：String 父节点：Destination 是 StorageClass 对象的存储类型。 类型：String 父节点：Destination 有效值：STANDARD|WARM|COLD 否 DeleteData 删除同步复制关键字，如果为Enabled，源桶的对象删除操作会复制到目标端。 类型：String 父节点：Destination 有效值：Enabled,Disabled（如果不设置，则默认为Disabled） 否 HistoricalObjectReplication 历史对象复制关键字，如果为Enabled，会复制符合这条规则的历史对象。 类型：String 父节点：Rule 有效值：Enabled, Disabled（如果不设置，则默认为Disabled） 否

请求示例 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。 表1 附加请求消息元素 元素名称 描述 是否必选 StorageClass 指定桶默认存储类型。 类型：String 取值范围： STANDARD | WARM | COLD | DEEP_ARCHIVE 存储类型有4种：STANDARD（标准存储）、WARM（低频访问存储）、COLD（归档存储）、DEEP_ARCHIVE（深度归档存储）。因此这里可配置的值有：STANDARD、WARM和COLD、DEEP_ARCHIVE（受限公测） 是

功能介绍 本接口实现为桶创建或更新桶的默认存储类型配置信息。 要正确执行此操作，需要确保执行者有PutBucketStoragePolicy权限。默认情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。 设置了桶的默认存储类型之后，如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类型，则该对象的存储类型取桶的默认存储类型。 未配置桶的默认存储类型时，桶的默认存储类型为STANDARD（标准存储）。

响应示例 1 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF2600000164368E704B571F328A8797 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAAB CS Isw3tPtUn6damTI5acQmQAcEfmTwl3 Date: WED, 01 Jul 2015 03:18:19 GMT Content-Length: 0

请求示例 1 2 3 4 5 6 GET /?versioning 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=

功能介绍 多版本功能可在用户意外覆盖或删除对象的情况下提供一种恢复手段。用户可以使用多版本功能来保存、检索和还原对象的各个版本，这样用户能够从意外操作或应用程序故障中轻松恢复数据。多版本功能还可用于数据保留和存档。 默认情况下，桶没有设置多版本功能。 当开启WORM开关后，桶默认开启了多版本功能，并且无法暂停。 本接口设置桶的多版本状态，用来开启或暂停桶的多版本功能。 设置桶的多版本状态为Enabled，开启桶的多版本功能： 上传对象时，系统为每一个对象创建一个唯一版本号，上传同名的对象将不再覆盖旧的对象，而是创建新的不同版本号的同名对象 可以指定版本号下载对象，不指定版本号默认下载最新对象； 删除对象时可以指定版本号删除，不带版本号删除对象仅产生一个带唯一版本号的删除标记，并不删除对象； 列出桶内对象列表时默认列出最新对象列表，可以指定列出桶内所有版本对象列表； 除了删除标记外，每个版本的对象存储均需计费（不包括对象元数据）。 设置桶的多版本状态为Suspended，暂停桶的多版本功能： 旧的版本数据继续保留 ； 上传对象时创建对象的版本号为null，上传同名的对象将覆盖原有同名的版本号为null的对象； 可以指定版本号下载对象，不指定版本号默认下载最新对象； 删除对象时可以指定版本号删除，不带版本号删除对象将产生一个版本号为null的删除标记，并删除版本号为null的对象； 除了删除标记外，每个版本的对象存储均需计费（不包括对象元数据）。 只有桶的所有者可以设置桶的多版本状态。

响应示例：暂停版本控制 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSjqfl2JttwovZb7kTM+xkyQQyhNyOOC x-obs-request-id: 0000018A2C044BC6D24722440C5EC81C Server: OBS Content-Length: 0 Date: WED, 01 Jul 2015 02:37:22 GMT

请求消息元素 在此请求中，需要在请求的消息体中配置桶的多版本状态，配置信息以XML格式上传。具体的配置元素如表1描述。 表1 桶的多版本状态配置元素 名称 描述 是否必选 VersioningConfiguration 多版本配置的根节点。 父节点：无 是 Status 标识桶的多版本状态。 类型：String 父节点：VersioningConfiguration 有效值：Enabled，Suspended 是

响应示例 1 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF26000001643672B973EEBC5FBBF909 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSH6rPRHjQCa62fcNpCCPs7+1Aq/hKzE Date: Date: WED, 01 Jul 2015 03:14:18 GMT Content-Length: 0

响应示例 1 2 3 4 5 HTTP/1.1 204 No Content Server: OBS x-obs-request-id: BF260000016436C2550A1EEA97614A98 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSB7A0KZEBOCutgcfZvaGVthTGOJSuyk Date: WED, 01 Jul 2015 03:12:22 GMT

请求示例 1 2 3 4 5 6 DELETE /?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:12:22 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:5DGAS7SBbMC1YTC4tNXY57Zl2Fo=

请求示例 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 ExpiredObjectDeleteMarker 表示是否删除过期删除标记，可以配置true和false。当配置true时，生命周期才会删除，当配置false时，不会删除。 类型：Boolean 父节点：Expiration StorageClass 表示对象将被修改成存储级别。 类型：String 取值范围：WARM或COLD 父节点：Transition, NoncurrentVersionTransition Transition 生命周期配置中表示迁移时间和迁移后对象存储级别的元素（仅针对对象的最新版本） 类型：XML 子节点：Date或Days 父节点：Rule Expiration 生命周期配置中表示过期时间的Container。 类型：XML 子节点：Date或Days或ExpiredObjectDeleteMarker 父节点：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 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF26000001643670AC06E7B9A7767921 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSvK6z8HV6nrJh49gsB5vqzpgtohkiFm Date: WED, 01 Jul 2015 03:05:34 GMT Content-Length: 0

响应示例：基于最后一次修改时间策略仅执行删除文件操作 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSfpG6nArWY7cM7rB3+GbvO13XJPx9g4 x-obs-request-id: 0000018A2BD6BB02D30426F6E4A1FBA2 Server: OBS Content-Length: 0 Date: WED, 01 Jul 2015 02:37:22 GMT

响应示例：执行删除碎片操作 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCTlN+glNMVGtTicAnVXkTVDjR5xKSLuH x-obs-request-id: 0000018A2BE86742D2C6989CA79E136C Server: OBS Content-Length: 0 Date: WED, 01 Jul 2015 02:37:22 GMT

响应示例：基于最后一次修改时间策略仅执行转换文件存储类型操作 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSZbDadL1f7fYU44bvRLvc0l6D10+wzG x-obs-request-id: 0000018A2BCBB3ABD3046B99E3ED2E30 Server: OBS Content-Length: 0 Date: WED, 01 Jul 2015 02:37:22 GMT

响应示例：基于最后一次修改时间执行转换文件存储类型以及删除操作 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSMYkLcGTyUsgSJe2Rdsg2P8JwMsJV6n x-obs-request-id: 0000018A2BDA0816D2877F5D5622F0BA Server: OBS Content-Length: 0 Date: WED, 01 Jul 2015 02:37:22 GMT

响应示例：基于最后一次修改时间执行删除历史版本文件及清理删除标记的操作 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSZbDadL1f7fYU44bvRLvc0l6D10+wzG x-obs-request-id: 0000018A2BCBB3ABD3046B99E3ED2E30 Server: OBS Content-Length: 0 Date: WED, 01 Jul 2015 02:37:22 GMT

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

请求消息元素 在此请求中，需要在请求的消息体中配置桶的生命周期配置信息。配置信息以XML格式上传，具体的配置元素如表2描述。 如果桶的多版本是Enabled或者Suspended，那么可以设置NoncurrentVersionTransition或NoncurrentVersionExpiration来控制对象的历史版本的生命周期。一个历史版本的生命周期，取决于它成为历史版本的时刻（即被新版本覆盖的那个时刻）和NoncurrentDays。对于删除来说，例如NoncurrentDays配置为1的话，表示当一个版本成为历史版本之后，再过1天才能删除。对象A的版本V1创建于1号，5号的时候又上传新的版本V2，此时V1成为历史版本，那么再过1天，7号的0点，V1就过期了。如果该版本不满足删除，迁移配置NoncurrentDays为1，StorageClass为WARM的话，表示当一个版本成为历史版本之后，再过1天转为低频访问对象。对象A的版本V1创建于1号，5号的时候又上传新的版本V2，此时V1成为历史版本，那么再过1天，7号的0点，V1就会迁移成低频访问对象了。（备注：对象过期后被删除或对象迁移的时间可能会有一定的延迟，一般不超过48小时。） 如果桶的多版本是Enabled或者Suspended，且最新版本对象满足Expiration规则时的处理： 桶当前的多版本状态为Enabled： 如果对象的最新版本不是deletemarker，则该对象会产生一个新的deletemarker； 如果最新版本是deletemarker，且该对象只有这一个版本，则这个版本会被删除； 如果最新版本是deletemarker，且对象还有其他版本，则该对象的所有版本维持不变，没有新增和删除，也不会被修改（即无任何变化）。 桶当前的多版本状态为Suspended： 如果对象的最新版本不是deletemarker，且版本不是null版本，则会产生一个新的null版本的deletemarker； 如果对象的最新版本不是deletemarker，且版本是null版本，则这个null版本会被新产生的null版本的deletemarker覆盖； 如果最新版本是deletemarker，且该对象只有这一个版本，则这个版本会被删除； 如果最新版本是deletemarker，且对象还有其他版本，则该对象的所有版本维持不变，没有新增和删除，也不会被修改（即无任何变化）。 如果桶的多版本是Enabled或者Suspended，且最新版本对象满足Transition规则时的处理： 如果对象的最新版本是deletemarker，则这个版本不被迁移； 如果最新版本不是deletemarker，且该对象满足迁移条件，则这个版本会被迁移。 表2 生命周期配置元素 名称 描述 是否必选 Date 指定OBS对该日期之前的对象执行生命周期规则。日期格式必须为ISO8601的格式，并且为UTC的零点。 例如：2018-01-01T00:00:00.000Z，表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型，等于或晚于这个时间的对象不会被删除或转储。 类型：String 父节点：Expiration, Transition 当对象转储时，如果没有Days元素，则必选； 当删除对象时，如果没有Days或ExpiredObjectDeleteMarker元素，则必选。 Days 指定生命周期规则在对象最后更新过后多少天生效（仅针对对象的最新版本）。 类型：Integer 父节点：Expiration, Transition 当对象转储时，如果没有Date元素，则必选； 当删除对象时，如果没有Date或ExpiredObjectDeleteMarker元素，则必选。 ExpiredObjectDeleteMarker 表示是否删除过期删除标记，可以配置true和false。当配置true时，生命周期才会删除，当配置false时，不会删除。如果生命周期规则里配置了tag时，不可配置该规则。 类型：Boolean 父节点：Expiration 如果没有Days或Date元素，则必选。 StorageClass 表示对象将被修改成存储级别。 类型：String 取值范围： WARM、COLD或DEEP_ARCHIVE 父节点：Transition, NoncurrentVersionTransition 如果有Transition或NoncurrentVersionTransition元素，则必选 Transition 生命周期配置中表示迁移时间和迁移后对象存储级别的元素（仅针对对象的最新版本） 类型：XML 子节点：Date或Days,StorageClass 父节点：Rule 如果没有NoncurrentVersionTransition, Expiration, NoncurrentVersionExpiration, AbortIncompleteMultipartUpload则必选 Expiration 生命周期配置中表示过期时间的Container（仅针对对象的最新版本）。 类型：XML 子节点：Date或Days或ExpiredObjectDeleteMarker 父节点：Rule 如果没有Transition, NoncurrentVersionTransition, NoncurrentVersionExpiration, AbortIncompleteMultipartUpload则必选 ID 一条Rule的标识，由不超过255个字符的字符串组成。 类型：String 父节点：Rule 否 LifecycleConfiguration 生命周期配置Rule的Container。可以配置多条Rule，但需保证整个配置消息体总大小不超过20KB。 类型：XML 子节点：Rule 父节点：无 是 NoncurrentDays 表示对象在成为历史版本之后第几天时规则生效（仅针对历史版本）。 类型：Integer 父节点：NoncurrentVersionExpiration, NoncurrentVersionTransition 如果有NoncurrentVersionExpiration或NoncurrentVersionTransition元素，则必选 NoncurrentVersionTransition 生命周期配置中表示对象的历史版本迁移时间和迁移后对象存储级别的元素。 类型：XML 子节点：NoncurrentDays, StorageClass 父节点：Rule 如果没有Transition, Expiration, NoncurrentVersionExpiration, AbortIncompleteMultipartUpload则必选 NoncurrentVersionExpiration 生命周期配置中表示历史版本过期时间的Container。您可以将该动作设置在已启用多版本（或暂停）的桶，来让系统删除对象的满足特定生命周期的历史版本（仅针对历史版本）。 类型：XML 子节点：NoncurrentDays 父节点：Rule 否 AbortIncompleteMultipartUpload 生命周期配置中表示未合并的多段任务（碎片）的过期属性Container。 类型：XML 子节点：DaysAfterInitiation 父节点：Rule 说明： AbortIncompleteMultipartUpload不支持基于标签（Tag）的筛选条件。 如果没有Transition, Expiration, NoncurrentVersionExpiration, NoncurrentVersionTransition则必选 DaysAfterInitiation 指定未合并的多段任务（碎片）的生命周期规则，在多段任务初始化过后多少天生效。 类型：Integer 父节点：AbortIncompleteMultipartUpload 如果有AbortIncompleteMultipartUpload则必选 Prefix 对象名前缀，用以标识哪些对象可以匹配到当前这条Rule。 类型：String 父节点：Rule 约束： 当按前缀配置时，如果指定的前缀名与某条已配置的生命周期规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为“abc”的规则，则不允许再配置指定前缀以“abc”字段开头的规则。 如果已存在按前缀配置的生命周期规则，则不允许再新增配置到整个桶的规则。 是 Rule 具体某一条生命周期配置的Container。 类型：Container 父节点：LifecycleConfiguration 是 Status 标识当前这条Rule是否启用。 类型：String 父节点：Rule 有效值：Enabled，Disabled 是

功能介绍 OBS系统支持指定规则来实现定时删除或迁移桶中对象，这就是生命周期配置。典型的应用场景如： 周期性上传的日志文件，可能只需要保留一个星期或一个月，到期后要删除它们。 某些文档在一段时间内经常访问，但是超过一定时间后就可能不会再访问了。这种文档您可能会先选择归档，然后在一定时间后删除。 桶的最低转低频访问和转归档的时间可以配置，取值范围为24~8640。 本接口实现为桶创建或更新生命周期配置信息。 对象生命周期到期以后，对象将会永久删除，无法恢复。 归档存储和深度归档存储不支持多AZ，因此不支持使用生命周期的存储类别转换功能，将多AZ的桶或对象转化为归档或深度归档存储。 要正确执行此操作，需要确保执行者有PutLifecycleConfiguration权限。默认情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。 生命周期配置实现了定时删除对象和定时迁移对象的功能，所以如果想要阻止用户删除或迁移对象，以下几项操作的权限都应该被禁止： DeleteObject DeleteObjectVersion PutLifecycleConfiguration 如果想要阻止用户管理桶的生命周期配置，应该禁止PutLifecycleConfiguration权限。

请求示例 1 2 3 4 5 6 GET /?logging HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.cn-north-4.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 02:42:46 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:hUk+jTnR07hcKwJh4ousF2E1U3E=

响应消息元素 该请求的响应中以消息元素的形式返回桶的日志信息，元素的具体意义如表1所示。 表1 响应消息元素 名字 描述 BucketLoggingStatus logging状态信息的容器。 类型：Container Agency 产生logging日志桶Owner创建委托OBS上传logging日志的委托名。 类型：String LoggingEnabled 用于logging信息的容器。并且该元素起到对logging配置管理的使能作用（呈现此元素则打开logging配置，否则关闭）。 类型：Container Grant 是被授权者及其权限的容器。 类型：Container Grantee 作为被授权logging权限用户的容器。 类型：Container ID 被授权用户的Domain Id，全局唯一标识。 类型：String Permission 对于一个桶的logging权限来说，owner在创桶时将自动获得对源桶的FULL_CONTROL权限。不同的权限决定了对不同日志的访问限制。 类型：String 权限有效值：FULL_CONTROL | READ | WRITE TargetBucket 在生成日志时，源桶的owner可以指定一个目标桶，将生成的所有日志放到该桶中。在OBS系统中，支持多个源桶生成的日志放在同一个目标桶中，如果这样做，就需要指定不同的TargetPrefix以达到为来自不同源桶的日志分类的目的。 类型：String TargetPrefix 通过该元素可以指定一个前缀给一类日志生成的对象。 类型：String TargetGrants 授权信息的容器。 类型：Container

响应示例 1 2 3 4 5 6 HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF26000001643663CE53B6AF31C619FD x-obs-id-2: 32AAAQAAEAABSAAkpAIAABAAAQAAEAABCT9CjuOx8cETSRbqkm35s1dL/tLhRNdZ Date: WED, 01 Jul 2015 02:40:06 GMT Content-Length: 0