access-monitor（访问跟踪）

注意事项

• 要设置访问跟踪配置，您必须具有oss:PutBucketAccessMonitor权限；要获取访问跟踪配置，您必须具有oss:GetBucketAccessMonitor权限。具体操作，请参见为RAM用户授权自定义的权限策略。

• 从ossutil 1.6.16版本开始，命令行中Binary名称支持直接使用ossutil，您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16，则需要根据系统刷新Binary名称。更多信息，请参见命令行工具ossutil命令参考。

• 仅1.7.15及以上版本支持access-monitor命令。

设置访问跟踪

• 命令格式

  ossutil access-monitor --method put oss://bucketname/ local_xml_file

  参数说明如下：

  参数	说明
  bucketname	待设置访问跟踪状态的Bucket名称。
  local_xml_file	用于设置访问跟踪状态的本地文件名称，例如config.xml。

• 使用示例

  1. 在本地XML文件中配置开启或关闭访问跟踪。

     • 开启访问跟踪状态

       <?xml version="1.0" encoding="UTF-8"?>
       <AccessMonitorConfiguration>
           <Status>Enabled</Status>
       </AccessMonitorConfiguration>

     • 关闭访问跟踪状态

       <?xml version="1.0" encoding="UTF-8"?>
       <AccessMonitorConfiguration>
           <Status>Disabled</Status>
       </AccessMonitorConfiguration>

  2. 通过以下示例为examplebucket设置访问跟踪状态。

     ossutil access-monitor --method put oss://examplebucket/ config.xml

     输出结果如下：

     0.299514(s) elapsed

获取访问跟踪配置

• 命令格式

  ossutil access-monitor --method get oss://bucketname [local_xml_file]

  参数说明如下：

  参数	说明
  bucketname	待获取访问跟踪状态的Bucket名称。
  local_xml_file	用于存放访问跟踪状态的本地文件名称，例如local.xml。如果未指定此参数，访问跟踪状态结果将直接输出到屏幕。

• 使用示例

  • 以下示例用于获取examplebucket的访问跟踪状态，并将结果输出到屏幕上。

    ossutil access-monitor --method get oss://examplebucket

    输出结果如下：

    <?xml version="1.0" encoding="UTF-8"?>
    <AccessMonitorConfiguration>
      <Status>Enabled</Status>
    </AccessMonitorConfiguration>
    
    0.154689(s) elapsed

  • 以下示例用于获取examplebucket的访问跟踪状态，并将结果写入local.xml文件。

    ossutil access-monitor --method get oss://examplebucket/ local.xml

    输出结果如下：

    • 屏幕显示

      0.214483(s) elapsed

    • 文件内容

      <?xml version="1.0" encoding="UTF-8"?>
      <AccessMonitorConfiguration>
        <Status>Enabled</Status>
      </AccessMonitorConfiguration>

后续操作

开启访问跟踪后，您需要配置基于最后一次访问时间的生命周期规则对冷数据存储类型进行转换，最终降低存储成本。具体操作，请参见lifecycle（生命周期）。