全部文档
当前文档
最近更新时间：2026-06-03 21:32:11
以下代码用于新建合规保留策略（WORM）：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
# 获取存储空间实例
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 新建合规保留策略，指定保留天数为30天
# 策略创建后处于 InProgress 状态，可以取消；锁定后不可删除，只能延长保留期
result = b.initiate_bucket_worm(retention_period_days=30)
worm_id = result.worm_id
print("WORM ID:", worm_id)
有关新建合规保留策略的API，请参见PUT Bucket Worm。
以下代码用于查看合规保留策略：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 查看合规保留策略
worm_config = b.get_bucket_worm()
print("WORM ID:", worm_config.worm_id)
print("状态:", worm_config.state) # InProgress 或 Locked
print("保留天数:", worm_config.retention_period_days)
print("创建时间:", worm_config.creation_date)有关查看合规保留策略的API，请参见GET Bucket Worm。
以下代码用于锁定合规保留策略：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 锁定合规保留策略
# 锁定后策略不可删除，保留期内对象无法修改或删除，只能延长保留期
worm_id = '<YOUR_WORM_ID>'
b.complete_bucket_worm(worm_id)有关锁定合规保留策略的API，请参见POST Bucket Worm (Lock)。
以下代码用于延长已锁定合规保留策略的保留期：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 延长保留期
# retention_period_days 为延长后的总保留天数，必须大于当前保留天数
worm_id = '<YOUR_WORM_ID>'
new_retention_days = 60
b.extend_bucket_worm(worm_id, retention_period_days=new_retention_days)有关延长合规保留策略保留期的API，请参见POST Bucket Worm (Extend)。
以下代码用于取消未锁定的合规保留策略：
from ks3.connection import Connection
# 金山云主账号AccessKey拥有所有API的访问权限，风险很高。
# 强烈建议您创建并使用子账号进行API访问或日常运维，请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
c = Connection('<YOUR_ACCESS_KEY>', '<YOUR_SECRET_KEY>', host='<YOUR_REGION_ENDPOINT>')
b = c.get_bucket('<YOUR_BUCKET_NAME>')
# 取消合规保留策略（仅 InProgress 状态可取消）
b.abort_bucket_worm()有关取消合规保留策略的API，请参见DELETE Bucket Worm。
纯净模式