描述： 管理 bucket 的对象锁定配置。对象锁定开启后，在保留期内 bucket 中的对象不可被删除或覆盖。

命令格式：

1bcecmd bosapi bucket-object-lock --bucket-name BUCKET-NAME --method METHOD [--retention-days DAYS] [--extend-retention-days DAYS]

说明：

• --method 支持以下 5 种：

  • init : 初始化对象锁定配置，需配合 --retention-days 使用，此时处于 IN_PROGRESS 状态，可删除。
  • get : 获取对象锁定配置。
  • delete : 删除对象锁定配置，仅在 IN_PROGRESS 状态下可用。
  • complete : 锁定生效，状态变为 LOCKED，之后不可删除。
  • extend : 延长保留天数，需配合 --extend-retention-days 使用，仅在 LOCKED 状态下可用。
• --retention-days 指定保留天数，须为正整数。
• --extend-retention-days 指定延长后的保留天数，须为正整数且大于当前保留天数。

示例：

• 初始化对象锁定

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-object-lock --bucket-name bucket1 --method init --retention-days 30

  返回示例： 无

• 获取对象锁定配置

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-object-lock --bucket-name bucket1 --method get

  返回示例：

  Plain Text 复制

  1{
  2  "lockStatus": "IN_PROGRESS",
  3  "retentionDays": 30,
  4  "createDate": "2024-01-01T00:00:00Z"
  5}

• 锁定生效

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-object-lock --bucket-name bucket1 --method complete

  返回示例： 无

• 延长保留天数

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-object-lock --bucket-name bucket1 --method extend --extend-retention-days 60

  返回示例： 无

  注意： extend 仅在对象锁定处于 LOCKED 状态（即执行过 complete）后才可用，否则返回 The object lock is not locked, can not extend retentionday。

• 删除对象锁定配置

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-object-lock --bucket-name bucket1 --method delete

  返回示例： 无