tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
对象存储
    文档
    Download PDF

    GET Bucket inventory

    最后更新时间：2023-12-21 12:32:26
    下载PDF

      功能描述

      GET Bucket inventory 接口用于查询存储桶中用户的清单任务信息。用户在发起该请求时，需要用户提供清单任务的名称，发起该请求时需获得请求签名，表明该请求已获得许可。有关清单的详细特性，请参见 清单功能概述。
      注意
      调用该请求时，请确保您有足够的权限对存储桶的清单任务进行操作。
      存储桶所有者默认拥有该权限，若您无该项权限，请先向存储桶所有者申请该项操作的权限。
      如果您指定了清单投递的前缀，COS 后端会自动在您指定的前缀后边加上/。如您指定了Prefix作为前缀，则 COS 后端投递的清单报告路径为Prefix/inventory_report。
      

      请求

      请求示例

      GET /?inventory&id=inventory-configuration-ID HTTP/1.1
      Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
      Date: GMT Date
      Authorization: Auth String
      说明
      Host: <BucketName-APPID>.cos.<Region>.myqcloud.com，其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字，例如 examplebucket-1250000000，可参阅 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档；<Region> 为 COS 的可用地域，可参阅 地域和访问域名 文档。
      Authorization: Auth String（详情请参见 请求签名 文档）。

      请求参数

      调用 GET Bucket inventory 需要使用清单任务名称的参数。该参数格式如下：
      参数
      描述
      类型
      是否必选
      id
      清单任务的名称。缺省值：None
      合法字符：a-z，A-Z，0-9，-，_，.
      String
      是

      请求头

      此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

      请求体

      该请求的请求体为空。

      响应

      响应头

      此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

      响应体

      该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
      <InventoryConfiguration>
          <Id>list1</Id>
          <IsEnabled>true</IsEnabled>
          <Destination>
              <COSBucketDestination>
                  <Format>CSV</Format>
                  <AccountId>1250000000</AccountId>
                  <Bucket>qcs::cos:ap-guangzhou::examplebucket-1250000000</Bucket>
                  <Prefix>list1</Prefix>
                  <Encryption>
                      <SSE-COS></SSE-COS>
                  </Encryption>
              </COSBucketDestination>
          </Destination>
          <Schedule>
              <Frequency>Daily</Frequency>
          </Schedule>
          <Filter>
              <Prefix>myPrefix</Prefix>
          </Filter>
          <IncludedObjectVersions>All</IncludedObjectVersions>
          <OptionalFields>
              <Field>Size</Field>
              <Field>LastModifiedDate</Field>
              <Field>ETag</Field>
              <Field>StorageClass</Field>
              <Field>IsMultipartUploaded</Field>
              <Field>ReplicationStatus</Field>
              <Field>Tag</Field>
              <Field>Crc64</Field>
              <Field>x-cos-meta-*</Field>
          </OptionalFields>
      </InventoryConfiguration>
      具体的节点描述如下：
      节点名
      父节点
      描述
      类型
      Inventory Configuration
      无
      包含清单的配置参数
      Container
      Id
      Inventory Configuration
      清单的名称，与请求参数中的 ID 对应
      Container
      IsEnabled
      Inventory Configuration
      清单是否启用的标识：
      如果设置为 true，清单功能将生效
      如果设置为 false，将不生成任何清单
      String
      IncludedObject Versions
      Inventory Configuration
      是否在清单中包含对象版本：
      如果设置为 All ，清单中将会包含所有对象版本，并在清单中增加 VersionId， IsLatest， DeleteMarker 这几个字段
      如果设置为 Current，则清单中不包含对象版本信息
      String
      Filter
      Inventory Configuration
      筛选待分析对象。清单功能将分析符合 Filter 中设置的前缀的对象
      Container
      And
      Filter
      筛选待分析对象时，如果同时需要前缀与对象标签条件，需要用 And 包装
      Container
      Prefix
      And
      需要分析的对象的前缀
      String
      Tag
      And
      筛选待分析对象时，可以用对象标签（支持多个）作为过滤条件
      Container
      Period
      Filter
      需要分析的对象的创建时间范围
      Container
      StartTime
      Period
      需要分析的对象创建的起始时间，参数为秒级时间戳，如1568688761
      String
      EndTime
      Period
      需要分析的对象创建的结束时间，参数为秒级时间戳，如1568688762
      String
      OptionalFields
      Inventory Configuration
      设置清单结果中应包含的分析维度
      Container
      Field
      OptionalFields
      清单结果中可选包含的分析项目名称，可选字段包括：Size，LastModifiedDate，StorageClass，ETag，IsMultipartUploaded，ReplicationStatus，Tag，Crc64，x-cos-meta-*
      注意，如果筛选条件里使用了对象标签，在这里也必须添加 Tag
      此外，也支持用户填写x-cos-meta-*形式的自定义头部，如x-cos-meta-testheader。清单会将相应的对象元数据输出，若对象不包含该元数据，则为空
      String
      Schedule
      Inventory Configuration
      配置清单任务周期
      Container
      Frequency
      Schedule
      清单任务周期，可选项为按日或者按周
      String
      Destination
      Inventory Configuration
      描述存放清单结果的信息
      Container
      COSBucket Destination
      Destination
      清单结果导出后存放的存储桶信息
      Container
      Bucket
      COSBucket Destination
      清单分析结果的存储桶名
      String
      AccountId
      COSBucket Destination
      存储桶的所有者 ID
      String
      Prefix
      COSBucket Destination
      清单分析结果的前缀
      String
      Format
      COSBucket Destination
      清单分析结果的文件形式，可选项为 CSV 格式和 ORC 格式
      String
      Encryption
      COSBucket Destination
      为清单结果提供服务端加密的选项
      Container
      SSE-COS
      Encryption
      COS 托管密钥的加密方式
      Container

      错误码

      此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

      实际案例

      案例一：获取指定对象前缀的清单任务

      请求

      下述请求示例展示了从存储桶examplebucket-1250000000中获取清单任务为 list1 的配置信息。
      GET /?inventory&id=list1 HTTP/1.1
      Date: Mon, 28 Aug 2018 02:53:38 GMT
      Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1503895278;1503895638&q-key-time=1503895278;1503895638&q-header-list=host&q-url-param-list=inventory&q-signature=f77900be432072b16afd8222b4b349aabd83****
      Host: examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com

      响应

      上述请求后，COS 返回以下响应，表明当前该存储桶内的清单任务 list1 处于启用状态。
      该清单任务分析存储桶examplebucket-1250000000中前缀为 myPrefix 的对象及其所有版本。
      分析频次为每天一次。
      分析维度包括 Size，LastModifiedDate， StorageClass，ETag，IsMultipartUploaded， ReplicationStatus。
      分析结果将以 CSV 格式文件存储在存储桶 examplebucket-1250000000 中，文件添加前缀 list1 且用 SSE-COS 加密。
      HTTP/1.1 200 OK
      Content-Type: application/xml
      Content-Length: 331
      Date: Mon, 28 Aug 2018 02:53:39 GMT
      Server: tencent-cos
      x-cos-request-id: NTlhMzg1ZWVfMjQ4OGY3MGFfMWE1NF84Y2M
      <?xml version = "1.0" encoding = "UTF-8">
      <InventoryConfiguration xmlns = "http://....">
          <Id>list1</Id>
          <IsEnabled>true</IsEnabled>
          <Destination>
              <COSBucketDestination>
                  <Format>CSV</Format>
                  <AccountId>1250000000</AccountId>
                  <Bucket>qcs::cos:ap-guangzhou::examplebucket-1250000000</Bucket>
                  <Prefix>list1</Prefix>
                  <Encryption>
                      <SSE-COS></SSE-COS>
                  </Encryption>
              </COSBucketDestination>
          </Destination>
          <Schedule>
              <Frequency>Daily</Frequency>
          </Schedule>
          <Filter>
              <Prefix>myPrefix</Prefix>
          </Filter>
          <IncludedObjectVersions>All</IncludedObjectVersions>
          <OptionalFields>
              <Field>Size</Field>
              <Field>LastModifiedDate</Field>
              <Field>ETag</Field>
              <Field>StorageClass</Field>
              <Field>IsMultipartUploaded</Field>
              <Field>ReplicationStatus</Field>
          </OptionalFields>
      </InventoryConfiguration>

      案例二：获取指定对象前缀和对象标签的清单任务

      请求

      下述请求示例展示了从存储桶examplebucket-1250000000中获取清单任务为 list2 的配置信息。
      GET /?inventory&id=list2 HTTP/1.1
      Date: Mon, 28 Aug 2018 02:53:38 GMT
      Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1503895278;1503895638&q-key-time=1503895278;1503895638&q-header-list=host&q-url-param-list=inventory&q-signature=f77900be432072b16afd8222b4b349aabd83****
      Host: examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com

      响应

      上述请求后，COS 返回以下响应，表明当前该存储桶内的清单任务 list2 处于启用状态。
      该清单任务分析存储桶examplebucket-1250000000中前缀为 myPrefix，且含有对象标签{age:18}的对象及其所有版本。
      分析频次为每天一次。
      分析维度包括 Size，LastModifiedDate， StorageClass，ETag，Tag。
      分析结果将以 CSV 格式文件存储在存储桶 inventorybucket-1250000000 中。
      HTTP/1.1 200 OK
      Content-Type: application/xml
      Content-Length: 331
      Date: Mon, 28 Aug 2018 02:53:39 GMT
      Server: tencent-cos
      x-cos-request-id: NTlhMzg1ZWVfMjQ4OGY3MGFfMWE1NF84Y2M
      <?xml version = "1.0" encoding = "UTF-8">
      <InventoryConfiguration xmlns = "http://....">
          <Id>list2</Id>
          <IsEnabled>true</IsEnabled>
          <Destination>
              <COSBucketDestination>
                  <Format>CSV</Format>
                  <AccountId>1250000000</AccountId>
                  <Bucket>qcs::cos:ap-guangzhou::inventorybucket-1250000000</Bucket>
              </COSBucketDestination>
          </Destination>
          <Schedule>
              <Frequency>Daily</Frequency>
          </Schedule>
          <Filter>
              <And>
                  <Prefix>myPrefix</Prefix>
                  <Tag>
                      <Key>age</Key>
                      <Value>18</Value>
                  </Tag>
              </And>
          </Filter>
          <IncludedObjectVersions>All</IncludedObjectVersions>
          <OptionalFields>
              <Field>Size</Field>
              <Field>LastModifiedDate</Field>
              <Field>StorageClass</Field>
              <Field>ETag</Field>
              <Field>Tag</Field>
          </OptionalFields>
      </InventoryConfiguration>
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款