接口描述

PutBucketInventory 用于为源bucket中创建清单任务，您可以对清单任务命名后，使用该请求创建清单任务。

Bos建议用户创建一个生命周期策略，用于删除旧的清单列表文件。

注意：

• 用户必须是源Bucket的owner且拥有FULL_CONTROL权限，且是目标Bucket的owner。
• 目的Bucket和源Bucket必须存在，目的Bucket和源Bucket必须是同账号下的Bucket，且是同region下的Bucket，不支持跨账号输出。
• BOS支持在每个存储桶中创建最多20条清单任务。
• 清单列表提供了新对象和覆盖的 PUT 的最终一致性，并提供了 DELETE 的最终一致性。清单列表是Bucket的滚动快照，内容最终是一致的 ，清单可能不包含最近添加或删除的对象。

请求

• 请求语法

  PUT /?inventory&id=inventory-configuration-ID HTTP/1.1
  Host: <BucketName>.bj.bcebos.com
  x-bce-date: date
  Content-Length: request-body length
  Content-Type: application/json; charset=utf-8
  Authorization: AuthorizationString
  {
     "id": "inventory-configuration-ID", 
     "status": "enabled", 
     "resource": [
         "bucket/prefix/*"
     ], 
     "schedule": "Weekly", 
     "destination": {
         "targetBucket": "destBucketName", 
         "targetPrefix": "destination-prefix", 
         "format": "CSV"
     }
  }

• 请求头域

  无

• 请求参数

响应

• 响应头域

  无特殊元素

• 响应元素

  无特殊头域

示例

• 请求示例

  PUT /?inventory&id=inventory-configuration-ID HTTP/1.1
  Host: <BucketName>.bj.bcebos.com
  x-bce-date: date
  Content-Length: request-body length
  Content-Type: application/json; charset=utf-8
  Authorization: AuthorizationString
  {
      "id": "inventory-configuration-ID", 
      "status": "enabled", 
      "resource": [
          "bucket/prefix/*"
      ], 
      "schedule": "Weekly", 
      "destination": {
          "targetBucket": "destBucketName", 
          "targetPrefix": "destination-prefix", 
          "format": "CSV"
      }
  }

• 响应示例

  HTTP/1.1 200 OK
  x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409
  Date: Wed, 31 May 2018 08:34:40 GMT
  Server: BceBos