tencent cloud

智能媒资托管

产品简介
产品概述
功能介绍
产品优势
应用场景
基本概念
购买指南
快速入门
创建媒体库
发起请求
服务级 API 文档
History
Introduction
API Category
Making API Requests
PaaS Service APIs
Official Cloud Disk APIs
Data Types
Error Codes
业务级 API 文档
简介
访问令牌操作接口
租户空间操作接口
文件操作接口
目录或相簿操作接口
回收站操作接口
配额操作接口
查询任务操作接口
搜索操作接口
历史版本操作接口
目录和文件批量操作接口
收藏操作接口
Error Codes
SDK 文档
Android SDK
iOS SDK
鸿蒙 SDK
常见问题
企业网盘
产品简介
购买指南
快速入门
常见问题
Service Level Agreement
词汇表

列出内容

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 11:03:09

简介

本文档提供关于列出目录或相簿内容的 API 概览以及 SDK 示例代码。
API
操作描述
用于列出目录或相簿内容

列出目录或相簿

功能说明

用于列出目录或相簿内容。

示例代码

列出文件列表
//目标文件夹
val targetDir = Directory()
try {
val directoryContents: DirectoryContents = smh.list(
//目标目录
dir = targetDir,
//页码
page = 1,
//每页拉取的数量
pageSize = 100,
//排序方式
orderType = OrderType.NAME,
//排序方向
orderDirection = OrderDirection.ASC,
//过滤类型
directoryFilter = DirectoryFilter.ONLY_FILE
)
//文件/目录列表 其他数量等内容请查看 DirectoryContents 实体内容
val contents = directoryContents.contents
} catch (e: Exception) {
e.printStackTrace()
}
通过 marker + limit 的方式列出文件列表
//目标文件夹
val targetDir = Directory()
try {
val directoryContents: DirectoryContents = smh.listWithMarker(
//目标目录
dir = targetDir,
//用于顺序列出分页的标识
marker = 100,
//用于顺序列出分页时本地列出的项目数限制
limit = 100,
//当前目录的 ETag
eTag = "eTag",
//排序方式
orderType = OrderType.NAME,
//排序方向
orderDirection = OrderDirection.ASC,
//过滤类型
directoryFilter = DirectoryFilter.ONLY_FILE
)
//文件/目录列表 其他数量等内容请查看DirectoryContents实体内容
val contents = directoryContents.contents
} catch (e: Exception) {
e.printStackTrace()
}
通过 offset + limit 的方式来列出文件列表
//目标文件夹
val targetDir = Directory()
try {
val directoryContents: DirectoryContents = smh.listWithOffset(
//目标目录
dir = targetDir,
//文件偏移量
offset = 100,
//列出的数量
limit = 100,
//排序方式
orderType = OrderType.NAME,
//排序方向
orderDirection = OrderDirection.ASC,
//过滤类型
directoryFilter = DirectoryFilter.ONLY_FILE
)
//文件/目录列表 其他数量等内容请查看 DirectoryContents 实体内容
val contents = directoryContents.contents
} catch (e: Exception) {
e.printStackTrace()
}
列出所有的文件列表
//目标文件夹
val targetDir = Directory()
try {
val directoryContents: DirectoryContents = smh.listAll(
//目标目录
dir = targetDir,
//每页拉取的数量
pageSize = 100,
//排序方式
orderType = OrderType.NAME,
//排序方向
orderDirection = OrderDirection.ASC,
//过滤类型
directoryFilter = DirectoryFilter.ONLY_FILE
)
//文件/目录列表 其他数量等内容请查看 DirectoryContents 实体内容
val contents = directoryContents.contents
} catch (e: Exception) {
e.printStackTrace()
}
通过 marker + limit 的方式列出所有的文件列表
//目标文件夹
val targetDir = Directory()
try {
val directoryContents: DirectoryContents = smh.listAllWithMarker(
//目标目录
dir = targetDir,
//每次拉取的数量
limit = 100
)
//文件/目录列表 其他数量等内容请查看 DirectoryContents 实体内容
val contents = directoryContents.contents
} catch (e: Exception) {
e.printStackTrace()
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈