put-bucket-overwrite-config-对象存储(OSS)-阿里云帮助中心

设置存储空间（Bucket）的禁止覆盖写规则，用于防止指定对象被覆盖写入。

注意事项

请求者需要拥有 oss:PutBucketOverwriteConfig 权限。

命令格式

ossutil api put-bucket-overwrite-config --bucket value --overwrite-configuration value [flags]

参数	类型	说明
--bucket	string	Bucket名称。
--overwrite-configuration	string	存储空间覆盖写配置规则的容器。

说明

put-bucket-overwrite-config命令对应API接口PutBucketOverwriteConfig。关于API中的具体参数含义，请参见PutBucketOverwriteConfig。
关于支持的全局命令行选项，请参见支持的全局命令行选项。

--overwrite-configuration

--overwrite-configuration 配置选项既支持XML语法也支持JSON语法：

XML语法：

<OverwriteConfiguration>
  <Rule>
    <Prefix>string</Prefix>
    <Suffix>string</Suffix>
    <Principals>
      <Principal>string</Principal>
      ...
    </Principals>
    <ID>string</ID>
    <Action>string</Action>
  </Rule>
  ...
</OverwriteConfiguration>

JSON语法：

{
  "Rule": [
    {
      "Prefix": "string",
      "Suffix": "string",
      "Principals": {
        "Principal": ["string", ...]
      },
      "ID": "string",
      "Action": "string"
    },
    ...
  ]
}

使用示例

设置存储空间 examplebucket 的禁止覆盖写规则。

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

<?xml version="1.0" encoding="UTF-8"?>
<OverwriteConfiguration>
   <Rule>
      <ID>rule-001</ID>
      <Action>forbid</Action>
      <Suffix>.txt</Suffix>
      <Principals>
          <Principal>277379621561571234</Principal>
      </Principals>
   </Rule>
</OverwriteConfiguration>

命令示例如下：

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

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

{
    "Rule": {
      "ID": "rule-001",
      "Action": "forbid",
      "Suffix": ".txt",
      "Principals": {
        "Principal": "277379621561571234"
      }
    }
}

命令示例如下：

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

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

ossutil api put-bucket-overwrite-config --bucket examplebucket --overwrite-configuration "{\"Rule\":{\"ID\":\"rule-001\",\"Action\":\"forbid\",\"Suffix\":\".txt\",\"Principals\":{\"Principal\":\"277379621561571234\"}}}"