存储清单（Python）

设置清单配置规则

以下代码用于设置清单配置规则：

import time

from ks3.connection import Connection
from ks3.xmlParsers.bucketInventory import BucketInventory, Destination, Schedule, Filter as InventoryFilter

# 金山云主账号 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>')

# 添加清单规则，规则名为inventory1，状态为开启
# 清单报告以CSV的格式存储，存储路径为<yourTargetAccountId>账号下的<yourTargetBucketName>桶，前缀为a的文件
# 报告生成频率为每周一次
# 扫描指定前缀和最后修改时间范围的对象
# 清单结果中包含 文件大小 和 最后修改时间 的信息
inventory = BucketInventory(id='inventory1', is_enabled=True,
                            destination=Destination(Destination.FORMAT_CSV, account_id='<yourTargetAccountId>',
                                                    bucket='<yourTargetBucketName>', prefix='a'),
                            schedule=Schedule(Schedule.WEEKLY),
                            filter=InventoryFilter(prefix='b', last_modify_begin_time_stamp=int(time.time())),
                            optional_fields=[BucketInventory.OPTIONAL_FIELD_SIZE,
                                             BucketInventory.OPTIONAL_FIELD_LAST_MODIFIED_DATE])

b.set_bucket_inventory(inventory)

有关设置清单规则详情，请参见PUT Bucket Inventory。

查看清单配置规则

以下代码用于查看清单配置规则：

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>')

inventory = b.get_bucket_inventory(inventory_id='inventory1')
print(inventory.to_xml())

有关查看清单规则详情，请参见GET Bucket Inventory。

列举清单配置规则

以下代码用于列举清单配置规则：

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>')

result = b.list_bucket_inventory()
for inventory in result.inventory_configurations:
    print(inventory.to_xml())

有关列举清单规则详情，请参见List Bucket Inventory。

删除清单配置

以下代码用于删除清单配置规则：

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>')

b.delete_bucket_inventory(inventory_id='inventory1')

有关删除清单规则详情，请参见DELETE Bucket Inventory。