put-bucket-rtc开启或关闭数据复制时间控制功能_对象存储(OSS)-阿里云帮助中心

为已有的跨区域复制规则开启或关闭数据复制时间控制（RTC）功能。

注意事项

阿里云账号默认拥有为已有的跨区域复制规则开启或关闭数据复制时间控制的权限。如果您需要通过RAM用户或者STS的方式进行添加修改，您必须拥有oss:PutBucketRtc权限。具体操作，请参见为RAM用户授权自定义的权限策略。

命令格式

ossutil api put-bucket-rtc --bucket value --rtc-configuration value [flags]

参数	类型	说明
--bucket	string	Bucket名称。
--rtc-configuration	string	RTC配置规则。

说明

put-bucket-rtc命令对应API接口PutBucketRTC。关于API中的具体参数含义，请参见PutBucketRTC。

--rtc-configuration

--rtc-configuration配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

XML语法：

<RtcConfiguration>
  <RTC>
    <Status>string</Status>
  </RTC>
  <ID>string</ID>
</RtcConfiguration>

JSON语法：

{
  "RTC": {
    "Status": "string"
  },
  "ID": "string"
}

说明

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

使用示例

为存储空间examplebucket复制规则ID为rtc-configuration数据复制规则开启RTC功能。

使用xml 配置文件，rtc-configuration.xml 内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<RtcConfiguration>
    <RTC>
        <Status>enabled</Status>
    </RTC>
    <ID>rtc-configuration</ID>
</RtcConfiguration>

ossutil api put-bucket-rtc --bucket examplebucket --rtc-configuration file://rtc-configuration.xml

使用JSON配置文件，rtc-configuration.json 内容如下：

{
    "RTC": {
        "Status": "enabled"
    },
    "ID": "rtc-configuratione"
}

ossutil api put-bucket-rtc --bucket examplebucket --rtc-configuration file://rtc-configuration.json

使用JSON配置参数，命令示例如下：

ossutil api put-bucket-rtc --bucket examplebucket --rtc-configuration "{\"RTC\":{\"Status\":\"enabled\"},\"ID\":\"rtc-configuration\"}"