腾讯云对象存储列出对象

简介

本文档提供关于列出对象操作相关的 API 概览以及 SDK 示例代码。

查询对象列表

功能说明

查询存储桶下的部分或者全部对象。

示例代码一: 获取第一页数据

// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucketString bucket = "examplebucket-1250000000";try {  BucketContents bucketContents = await Cos().getDefaultService().getBucket(      bucket,      prefix: "dir/", // 前缀匹配，用来规定返回的对象前缀地址      maxKeys: 100 // 单次返回最大的条目数量，默认1000  );  // 表示数据被截断，需要拉取下一页数据  var isTruncated = bucketContents.isTruncated;  // nextMarker 表示下一页的起始位置  var nextMarker = bucketContents.nextMarker;} catch (e) {  // 失败后会抛异常 根据异常进行业务处理  print(e);}

示例代码二：请求下一页数据

// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucketString bucket = "examplebucket-1250000000";// prevPageBucketContents 是上一页的返回结果，这里的 nextMarker 表示下一页的起始位置String prevPageMarker = prevPageBucketContents.nextMarker;try {  BucketContents bucketContents = await Cos().getDefaultService().getBucket(      bucket,      prefix: "dir/", // 前缀匹配，用来规定返回的对象前缀地址      marker: prevPageMarker, // 起始位置      maxKeys: 100 // 单次返回最大的条目数量，默认1000  );  // 表示数据被截断，需要拉取下一页数据  var isTruncated = bucketContents.isTruncated;  // nextMarker 表示下一页的起始位置  var nextMarker = bucketContents.nextMarker;} catch (e) {  // 失败后会抛异常 根据异常进行业务处理  print(e);}

示例代码三：获取对象列表与子目录

// 存储桶名称，由 bucketname-appid 组成，appid 必须填入，可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucketString bucket = "examplebucket-1250000000";// 定界符为一个符号，如果有 Prefix，// 则将 Prefix 到 delimiter 之间的相同路径归为一类，定义为 Common Prefix，// 然后列出所有 Common Prefix。如果没有 Prefix，则从路径起点开始var delimiter = "/";try {  BucketContents bucketContents = await Cos().getDefaultService().getBucket(      bucket,      prefix: "dir/", // 前缀匹配，用来规定返回的对象前缀地址      delimiter: delimiter,      maxKeys: 100 // 单次返回最大的条目数量，默认1000  );  // 表示数据被截断，需要拉取下一页数据  var isTruncated = bucketContents.isTruncated;  // nextMarker 表示下一页的起始位置  var nextMarker = bucketContents.nextMarker;} catch (e) {  // 失败后会抛异常 根据异常进行业务处理  print(e);}

参数说明

返回结果说明

成功：返回 BucketContents 包含：对象列表和列表信息。失败：发生错误（如身份认证失败），抛出异常 CosXmlClientException 或者 CosXmlServiceException。详情请参见 异常处理。BucketContents 响应包体具体数据内容如下：

对象（Content）中包含如下内容：

持有者信息（Owner） 中包含如下内容：

CommonPrefixes 中包含如下内容：



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠