update-bucket-metadata-journal-table-configuration-对象存储(OSS)-阿里云帮助中心

update-bucket-metadata-journal-table-configuration命令用于更新Bucket的变更日志表（Journal Table）配置，例如设置日志记录的过期策略。

注意事项

重要

元数据管理（Metadata）当前为邀测功能，尚未对所有用户开放，且仅在已开放Table Bucket的地域提供。如需使用，请联系技术支持申请。此外，您也可以通过OSS控制台开启、修改或关闭元数据管理功能。

阿里云账号默认拥有更新Bucket变更日志表配置的权限。如果您需要通过RAM用户或者STS的方式进行操作，您必须拥有oss:UpdateBucketMetadataJournalTableConfiguration权限。具体操作，请参见为RAM用户授予自定义的权限策略。

命令格式

ossutil api update-bucket-metadata-journal-table-configuration --bucket examplebucket --journal-table-configuration file://journal-table-configuration.xml

参数	类型	说明
--bucket	string	目标Bucket的名称。
--journal-table-configuration	string	元数据表配置容器，支持XML和JSON格式。当选项值包含`file://`前缀时，表示从文件中读取配置。

--journal-table-configuration

--journal-table-configuration配置选项支持XML和JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。示例配置文件journal-table-configuration.xml的内容如下：

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

等效的JSON语法如下：

{
  "RecordExpiration": {
    "Expiration": "ENABLED",
    "Days": 7
  }
}

参数	类型	是否必填	说明
RecordExpiration	Container	是	变更日志表记录的过期配置。
RecordExpiration.Expiration	String	是	记录过期开关。取值：ENABLED、DISABLED。
RecordExpiration.Days	Integer	条件必填	记录过期天数。Expiration 为 ENABLED 时必填，取值为正整数。

说明

本命令需要ossutil 2.4.1及以上版本。更低版本请通过泛化命令invoke-operation调用对应接口。

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

为Bucket examplebucket 更新变更日志表配置：启用记录过期并将过期时间设置为7天。配置文件 journal-table-configuration.xml 的内容如下：

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

也可以改用JSON格式的配置文件 journal-table-configuration.json，内容如下：

{
  "RecordExpiration": {
    "Expiration": "ENABLED",
    "Days": 7
  }
}

命令示例如下：

ossutil api update-bucket-metadata-journal-table-configuration --bucket examplebucket --journal-table-configuration file://journal-table-configuration.xml

ossutil api update-bucket-metadata-journal-table-configuration --bucket examplebucket --journal-table-configuration file://journal-table-configuration.json