UpdateBucketMetadataJournalTableConfiguration-对象存储(OSS)-阿里云帮助中心

调用UpdateBucketMetadataJournalTableConfiguration接口更新元数据管理（Metadata）配置中变更日志表（Journal Table）的记录过期（Record Expiration）策略。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的 RAM 用户或 RAM 角色默认没有任何权限，需要阿里云账号或账号管理员授予操作权限。

API	Action	说明
UpdateBucketMetadataJournalTableConfiguration	`oss:UpdateBucketMetadataJournalTableConfiguration`	更新变更日志表的记录过期策略。

请求语法

PUT /?metadataJournalTable HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Length: ContentLength
Content-MD5: MD5Value
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<JournalTableConfiguration>
   <RecordExpiration>
      <Expiration>ENABLED</Expiration>
      <Days>30</Days>
   </RecordExpiration>
</JournalTableConfiguration>

请求头

名称	类型	是否必选	描述
Content-MD5	字符串	否	请求体的 MD5 校验值。
x-oss-expected-bucket-owner	字符串	否	预期的 Bucket 拥有者账号 ID。

请求元素

名称	类型	是否必选	描述
RecordExpiration	容器	是	记录过期配置。父节点：JournalTableConfiguration
RecordExpiration.Expiration	字符串	是	记录过期开关。取值：ENABLED、DISABLED。父节点：RecordExpiration
RecordExpiration.Days	整数	条件必选	记录过期天数，为正整数。当 Expiration 为 ENABLED 时必选。父节点：RecordExpiration

响应

操作成功时返回 HTTP 状态码 200，响应体为空。

使用说明

仅在变更日志表状态为 ACTIVE 时可调用（CREATING 或 FAILED 时不允许修改）。
Disable 操作是幂等的：已为 DISABLED 时再次 Disable 仍返回 200。
实际的记录过期由后台异步任务根据配置周期性执行。

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

请求示例

PUT /?metadataJournalTable HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 16 Sep 2026 12:00:00 GMT
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<JournalTableConfiguration>
   <RecordExpiration>
      <Expiration>ENABLED</Expiration>
      <Days>30</Days>
   </RecordExpiration>
</JournalTableConfiguration>

返回示例
```
HTTP/1.1 200 OK
```

SDK

UpdateBucketMetadataJournalTableConfiguration 接口所对应的各语言 SDK 如下：

命令行工具ossutil

UpdateBucketMetadataJournalTableConfiguration 接口所对应的 ossutil 命令，请参见update-bucket-metadata-journal-table-configuration。