Excel 云文件管理 —— 高效、安全的 Excel 文件存储与智能组织解决方案

Aspose.Cells Cloud 提供了一整套便捷功能，用于操作存储于 Aspose.Cells Cloud 存储或您所选择的任意第三方云存储中的文件。有关设置第三方存储的帮助，请参阅 Aspose Cloud UI 帮助主题。

Aspose.Cells Cloud 提供一系列文件、文件夹和存储操作 API。

注意： 所有 API 调用必须使用 HTTPS。获取 JWT 令牌的详细信息，请参阅 身份验证指南。

前置条件： 使用这些 API 前，您需拥有有效的 Aspose Cloud 账户，获取 JWT 访问令牌，并配置好存储位置（可为 Aspose Cloud 存储或已连接的第三方存储）。

最后更新日期： 2024‑12‑01

如何上传文件

上传文件 API 信息

PUT https://api.aspose.cloud/v3.0/cells/storage/file/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 上传文件的路径，包含文件名及扩展名（例如：/folder1/Report.xlsx）。
file file formData 待上传的文件。
storageName string query 使用的存储名称。

HTTP 响应码

状态码 描述
200 文件上传成功。
400 请求错误 — 缺少或无效参数。
401 未授权 — JWT 令牌无效或缺失。
404 未找到指定存储。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

上传文件示例

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 上传文件。

注意：上传文件最大支持 100 MB。可能受速率限制。

如何下载文件

下载文件 API 信息

GET https://api.aspose.cloud/v3.0/cells/storage/file/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 文件路径（例如：/folder/Report.xlsx）。
storageName string query 使用的存储名称。
versionId string query 待下载的文件版本标识符（可选）。

HTTP 响应码

状态码 描述
200 文件下载成功；返回二进制流。
400 请求错误 — 参数无效。
401 未授权 — JWT 令牌缺失或无效。
404 文件未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

下载文件示例

注意：响应中包含文件的二进制流。使用 cURL 时请使用 -o filename.xlsx 将输出保存为文件。

如何删除文件

删除文件 API 信息

DELETE https://api.aspose.cloud/v3.0/cells/storage/file/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 文件路径（例如：/folder/Report.xlsx）。
storageName string query 使用的存储名称。
versionId string query 待删除的文件版本标识符（可选）。

HTTP 响应码

状态码 描述
200 文件删除成功。
400 请求错误 — 缺少或无效参数。
401 未授权 — JWT 令牌无效。
404 文件未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

删除文件示例

注意：删除文件是永久性的；如有需要，请提前备份。

如何复制文件

复制文件 API 信息

PUT https://api.aspose.cloud/v3.0/cells/storage/file/copy/{srcPath}

请求参数如下：

参数名 类型 位置 描述
srcPath string path 源文件路径（例如：/folder/Source.xlsx）。
destPath string query 目标文件路径（例如：/folder/Destination.xlsx）。
srcStorageName string query 源存储名称（可选）。
destStorageName string query 目标存储名称（可选）。
versionId string query 待复制的文件版本 ID（可选）。

HTTP 响应码

状态码 描述
200 文件复制成功。
400 请求错误 — 参数无效。
401 未授权 — JWT 令牌缺失或无效。
404 源文件未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

复制文件示例

注意：复制操作不会删除源文件。

如何移动文件

移动文件 API 信息

PUT https://api.aspose.cloud/v3.0/cells/storage/file/move/{srcPath}

请求参数如下：

参数名 类型 位置 描述
srcPath string path 源文件路径（例如：/folder/Source.xlsx）。
destPath string query 目标文件路径（例如：/folder/Destination.xlsx）。
srcStorageName string query 源存储名称（可选）。
destStorageName string query 目标存储名称（可选）。
versionId string query 待移动的文件版本 ID（可选）。

HTTP 响应码

状态码 描述
200 文件移动成功。
400 请求错误 — 参数无效。
401 未授权 — JWT 令牌缺失或无效。
404 源文件未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

移动文件示例

注意：移动文件会保留其版本历史。

如何创建文件夹

创建文件夹 API 信息

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 待创建的文件夹路径（例如：folder1/folder2/）。
storageName string query 使用的存储名称。

HTTP 响应码

状态码 描述
200 文件夹创建成功。
400 请求错误 — 路径或参数无效。
401 未授权 — JWT 令牌缺失或无效。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

创建文件夹示例

注意：文件夹路径区分大小写。

如何获取文件夹中的文件列表

获取文件列表 API 信息

GET https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 文件夹路径（例如：/folder）。
storageName string query 使用的存储名称。

HTTP 响应码

状态码 描述
200 返回文件和子文件夹列表。
400 请求错误 — 路径无效。
401 未授权 — JWT 令牌缺失或无效。
404 文件夹未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

获取文件列表示例

注意：响应中列出指定路径下的文件及子文件夹。

如何删除文件夹

删除文件夹 API 信息

DELETE https://api.aspose.cloud/v3.0/cells/storage/folder/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 文件夹路径（例如：/folder）。
storageName string query 使用的存储名称。
recursive boolean query 设置为 true 表示递归删除文件夹及其内容。

HTTP 响应码

状态码 描述
200 文件夹删除成功。
400 请求错误 — 参数无效。
401 未授权 — JWT 令牌缺失或无效。
404 文件夹未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

删除文件夹示例

注意：使用 recursive=true 删除文件夹会永久移除其全部内容。

如何复制文件夹

复制文件夹 API 信息

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/copy/{srcPath}

请求参数如下：

参数名 类型 位置 描述
srcPath string path 源文件夹路径（例如：/src）。
destPath string query 目标文件夹路径（例如：/dst）。
srcStorageName string query 源存储名称（可选）。
destStorageName string query 目标存储名称（可选）。

HTTP 响应码

状态码 描述
200 文件夹复制成功。
400 请求错误 — 参数无效。
401 未授权 — JWT 令牌缺失或无效。
404 源文件夹未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

复制文件夹示例

注意：复制操作会创建一个与源文件夹内容相同的新文件夹。

如何移动文件夹

移动文件夹 API 信息

PUT https://api.aspose.cloud/v3.0/cells/storage/folder/move/{srcPath}

请求参数如下：

参数名 类型 位置 描述
srcPath string path 源文件夹路径（例如：/folder）。
destPath string query 目标文件夹路径（例如：/dst）。
srcStorageName string query 源存储名称（可选）。
destStorageName string query 目标存储名称（可选）。

HTTP 响应码

状态码 描述
200 文件夹移动成功。
400 请求错误 — 参数无效。
401 未授权 — JWT 令牌缺失或无效。
404 源文件夹未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

移动文件夹示例

注意：移动文件夹会保留其内部结构及文件版本。

如何检查存储是否存在

存储存在性检查 API 信息

GET https://api.aspose.cloud/v3.0/cells/storage/{storageName}/exist

请求参数如下：

参数名 类型 位置 描述
storageName string path 待检查的存储名称。

HTTP 响应码

状态码 描述
200 返回存储存在性（true 或 false）。
401 未授权 — JWT 令牌缺失或无效。
404 未找到存储。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

存储存在性检查示例

如何检查文件或文件夹是否存在

对象存在性检查 API 信息

GET https://api.aspose.cloud/v3.0/cells/storage/exist/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 文件或文件夹路径（例如：/file.xlsx 或 /folder）。
storageName string query 待检查的存储名称。
versionId string query 文件版本标识符（可选）。

HTTP 响应码

状态码 描述
200 返回存在性信息。
401 未授权 — JWT 令牌缺失或无效。
404 文件或文件夹未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

对象存在性检查示例

如何获取磁盘使用情况

获取磁盘使用情况 API 信息

GET https://api.aspose.cloud/v3.0/cells/storage/disc

请求参数如下：

参数名 类型 位置 描述
storageName string query 待查询的存储名称。

HTTP 响应码

状态码 描述
200 返回磁盘使用情况信息。
401 未授权 — JWT 令牌缺失或无效。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

获取磁盘使用情况示例

如何获取文件版本列表

获取文件版本 API 信息

GET https://api.aspose.cloud/v3.0/cells/storage/version/{path}

请求参数如下：

参数名 类型 位置 描述
path string path 文件路径（例如：/file.xlsx）。
storageName string query 待查询的存储名称。

HTTP 响应码

状态码 描述
200 返回文件版本列表。
401 未授权 — JWT 令牌缺失或无效。
404 文件未找到。
500 服务器内部错误。

OpenAPI 规范 定义了一个公开可访问的编程接口，可直接通过 Web 浏览器发起 REST 调用。

获取文件版本示例

Aspose.Cells Cloud Web API – 设置/修改 Excel 文件的打开密码 Aspose.Cells Cloud 3.0 开发者指南