GetBucketInventory
所有文档

          对象存储 BOS

          GetBucketInventory

          接口描述

          GetBucketInventory 使用GET操作来获取指定桶的某个清单配置。用户在发起该请求时,需要用户提供清单任务的名称

          请求

          • 请求语法

            GET /?inventory&id=inventory-configuration-ID HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            x-bce-date: date
            Content-Length: 0
          • 请求头域

            无特殊请求头域

          • 请求query参数

          名称 类型 描述 是否必须
          id string inventory规则名

          响应

          • 响应头域

            无特殊响应头域

          • 响应元素

          名称 类型 描述 是否必须
          id string inventory规则名。规格:最长64字节。合法字符:"a-z"、"A-Z"、"0-9"、"-"、"_"和"." 。
          status string 清单是否生效的标识。如果设置为 “enabled”,清单功能将生效;如果设置为"disabled",将不生成任何清单
          resource list,子元素为string 生效前缀,resource的配置形式为bucket_name/<生效的对象前缀>,必须要以bucket_name/开头.对整个bucket生效的时候,使用bucket_name/*
          schedule string 清单任务周期,可选项为每三日或者每周,可选值:ThreeDaily、Weekly。
          destination object 描述存放清单结果的信息。
          +targetBucket string 指定存放清单文件的Bucket。
          +targetPrefix string 指定最终被保存的清单文件前缀。
          +format string 清单分析结果的文件形式,当前支持格式:CSV。

          示例

          • 请求示例

            GET /?inventory&id=inventory-configuration-ID HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            x-bce-date: date
            Content-Length: 0
          • 响应示例

            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
            Authorization: AuthorizationString
            {
                "id": "inventory-configuration-ID", 
                "status": "enabled", 
                "resource": [
                    "bucket/prefix/*"
                ], 
                "schedule": "Weekly", 
                "destination": {
                    "targetBucket": "destBucketName", 
                    "targetPrefix": "destination-prefix", 
                    "format": "CSV"
                }
            }
          上一篇
          PutBucketInventory
          下一篇
          ListBucketInventory