批量锁定 Excel 文件
Contents
[
Hide
]
此 REST API 支持对符合条件的 Excel 文件执行批量锁定操作。
REST API
POST http://api.aspose.cloud/v3.0/cells/batch/lock
安全与身份验证
Aspose.Cells Cloud API 采用安全机制，需要使用 基于 JWT 令牌的身份验证。
请求参数
| 参数名称 | 类型 | 位置 | 描述 |
|---|---|---|---|
| BatchLockRequest | BatchLockRequest | body | 包含锁定参数的 JSON 请求体。 |
BatchLockRequest 属性
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| SourceFolder | string | 包含源 Excel 文件的文件夹。 | 可选 |
| MatchCondition | MatchConditionRequest | 用于选择需锁定文件的匹配条件。 | 可选 |
| Password | string | 应用于已锁定文件的密码。 | 可选 |
| OutFolder | string | 存放已锁定文件的目标文件夹。 | 可选 |
MatchConditionRequest 属性
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
| RegexPattern | string | 用于匹配文件名的正则表达式模式。 | 可选 |
| FullMatchConditions | string[] | 用于精确匹配文件名以进行锁定的条件列表。 | 可选 |
请求体参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| data | file | 要创建的工作簿文件的二进制内容。 |
响应
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
HTTP 状态码
| 状态码 | 含义 | 返回条件 |
|---|---|---|
| 200 OK | 工作簿创建成功 | 正常流程 |
| 201 Created | 工作簿已创建（替代响应） | 当 API 返回已创建状态时 |
| 400 Bad Request | 无效参数 | 客户端错误 |
| 401 Unauthorized | 缺失或无效令牌 | 身份验证错误 |
| 409 Conflict | 文件已存在且 isWriteOver=false |
与已有文件冲突 |
如何使用 SDK 调用 PostBatchLock API
PostBatchLock API 规范
OpenAPI 规范 定义了一个公开可访问的编程接口，您可直接通过网页浏览器执行 REST 交互。
您可使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例演示了如何通过 cURL 调用云 API。
使用 Aspose.Cells Cloud SDK
使用 SDK 是开发速度最快的方式。SDK 抽象了底层细节，让您能专注于锁定任务本身。请查阅 GitHub 仓库，获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例演示了如何通过多种 SDK 调用 Aspose.Cells Web 服务：