全部文档
当前文档
最近更新时间：2025-06-11 14:15:56
只有Bucket的拥有者或具有ks3:PutBucketLogging权限的用户才能设置存储空间日志。
以下代码用于设置存储空间日志：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
# 通过指定host(Endpoint)，您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
# 获取存储空间实例
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 开启日志设置
from ks3.xmlParsers.bucketLogging import BucketLogging
# 第一个参数为目标桶实例或者目标桶的名称；target_prefix 为日志文件的前缀
resp = b.enable_logging(b, target_prefix='test')
print("enable_logging, request_id: ", resp.response_metadata.request_id)
# 或者
# target为目标桶实例或者目标桶的名称；target_prefix 为日志文件的前缀
blogging = BucketLogging(target=b.name, target_prefix='test_log')
resp = b.set_bucket_logging(blogging.to_xml())
print("set_bucket_logging, request_id: ", resp.response_metadata.request_id)1. 存放日志文件的Bucket必须与开启日志的Bucket属于同一个Region。
2. 开启日志的Bucket和存放日志文件的Bucket可以是同一个Bucket，但是为了方便用户管理，建议使用两个不同的Bucket。
3. 有关设置存储空间日志相关API，请参见PUT Bucket Logging。
以下代码用于获取存储空间日志：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
# 通过指定host(Endpoint)，您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
# 获取存储空间实例
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 查看日志设置
resp = b.get_bucket_logging()
print("got bucket logging, request_id: ", resp.response_metadata.request_id)
print("got bucket logging, xml: ", resp.to_xml())有关获取存储空间日志规则API，请参见GET Bucket Logging。
以下代码用于关闭存储空间日志：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
# 通过指定host(Endpoint)，您可以在指定的地域创建新的存储空间。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
# 获取存储空间实例
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 关闭日志设置
resp = b.disable_logging()
print("disable_logging, request_id: ", resp.response_metadata.request_id)有关删除存储空间日志，请参见PUT Bucket Logging。
纯净模式