put-bucket-logging

注意事项

在开启日志转存之前，请确保您已了解该功能。详情请参见日志转存。

权限说明

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

命令格式

ossutil api put-bucket-logging --bucket value --bucket-logging-status value [flags]

--bucket-logging-status

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

• XML语法：

  <BucketLoggingStatus>
    <LoggingEnabled>
      <TargetBucket>string</TargetBucket>
      <TargetPrefix>string</TargetPrefix>
    </LoggingEnabled>
  </BucketLoggingStatus>

• JSON语法：

  {
    "LoggingEnabled": {
      "TargetBucket": "string",
      "TargetPrefix": "string"
    }
  }

使用示例

以下示例展示了如何为名为examplebucket的存储空间开启日志转存功能，日志文件前缀为MyLog-，存储访问日志的Bucket为dest-bucket。

• 使用XML配置文件，bucket-logging-status.xml内容如下：

  <?xml version="1.0" encoding="UTF-8"?>
  <BucketLoggingStatus>
    <LoggingEnabled>
      <TargetBucket>dest-bucket</TargetBucket>
      <TargetPrefix>MyLog-</TargetPrefix>
    </LoggingEnabled>
  </BucketLoggingStatus>

命令示例如下：

ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.xml

• 使用JSON配置文件，bucket-logging-status.json内容如下：

  {
    "LoggingEnabled": {
      "TargetBucket": "destBucket",
      "TargetPrefix": "MyLog-"
    }
  }

  命令示例如下：

  ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status file://bucket-logging-status.json

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

  ossutil api put-bucket-logging --bucket examplebucket --bucket-logging-status "{\"LoggingEnabled\":{\"TargetBucket\":\"destBucket\",\"TargetPrefix\":\"MyLog-\"}}"