建立、管理、維護：Aspose.Cells 雲端管理 API 實用指南

建立空的工作簿、重新命名工作表、壓縮過大的檔案，或修復損壞的檔案——這些都是在沒有合適工具時仍會耗費開發人員時間的小型日常工作。ManagementController 將它們變成單行程式碼。

每個使用試算表的應用程式最終都會遇到相同的乏味任務：

建立即時全新空白工作簿 — 有時來自品牌範本。
重新排列工作表 — 添加、重新命名、刪除、重新排序 — 因為資料形態自昨天以來已變化。
控制檔案大小 — 在寄送前將 40 MB 的 XLSX 壓縮至 8 MB。
拯救損壞檔案 — 使用者儲存錯誤或工具匯出不良的檔案。
檢查結構 — 在不開啟工作簿的情況下，找出其中包含哪些工作表、表格、圖表與合併儲存格區域。

Aspose.Cells Cloud 微服務中的 ManagementController（來源：src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs）在乾淨的 REST 介面背後處理所有這些功能。本文介紹了其 15 個端點，並提供可直接貼入您流水線的可執行 cURL 範例。

1. ManagementController 的功能是什麼？

ManagementController 是專門負責 工作簿生命週期和維護 的控制器。不同於 ConversionController（格式轉換）、DataProcessingController（批量合併/拆分/匯入）或 CellsController（儲存格層級的讀/寫），此控制器關注的是工作簿本身的 形狀、健康與元資料。

職責	典型端點
建立工作簿，可選擇使用範本	`spreadsheet/create`
檢查結構 — 工作表、合併儲存格、完整結構 JSON	`spreadsheet/worksheets`, `spreadsheet/mergedcells`, `spreadsheet/structure`, `{name}/worksheets/{worksheet}/mergedcells`, `{name}/structure`
修改工作表版面 — 新增、刪除、重新命名、移動	`spreadsheet/add/worksheet`, `spreadsheet/delete/worksheet`, `spreadsheet/rename/worksheet`, `spreadsheet/move/worksheet`
維護 — 壓縮、修復、接受修訂	`spreadsheet/compress`, `spreadsheet/repair`, `spreadsheet/accept-all-revisions`, `{name}/accept-all-revisions`

每個端點都接受工作簿作為多部分輸入（本地）或引用雲端儲存中已存在的工作簿（遠端），並返回修改後的工作簿流、JSON 負載或簡單的 OK。

2. 十五個端點概覽

編號	HTTP	Route	來源	功能說明
1	PUT	`/v4.0/cells/spreadsheet/create`	—	建立新的活頁簿，可選擇從範本建立
2	PUT	`/v4.0/cells/spreadsheet/worksheets`	Local	列出所有工作表（名稱 + 類型）
3	PUT	`/v4.0/cells/spreadsheet/add/worksheet`	Local	新增工作表，包含類型、名稱、位置
4	PUT	`/v4.0/cells/spreadsheet/delete/worksheet`	Local	依名稱移除工作表
5	PUT	`/v4.0/cells/spreadsheet/rename/worksheet`	Local	重新命名工作表
6	PUT	`/v4.0/cells/spreadsheet/move/worksheet`	Local	將工作表移動至新索引位置
7	PUT	`/v4.0/cells/spreadsheet/compress`	Local	壓縮活頁簿以減少檔案大小
8	PUT	`/v4.0/cells/spreadsheet/repair`	Local	修復受損的活頁簿
9	GET	`/v4.0/cells/{name}/worksheets/{worksheet}/mergedcells`	Cloud	列出遠端工作表中的合併儲存格區域
10	PUT	`/v4.0/cells/spreadsheet/mergedcells`	Local	列出本機工作表中的合併儲存格區域
11	PUT	`/v4.0/cells/spreadsheet/accept-all-revisions`	Local	接受所有已追蹤的變更
12	PUT	`/v4.0/cells/{name}/accept-all-revisions`	Cloud	接受遠端檔案中的所有已追蹤變更
13	PUT	`/v4.0/cells/spreadsheet/structure`	Local	取得完整結構的 JSON 表示
14	GET	`/v4.0/cells/{name}/structure`	Cloud	取得遠端檔案完整結構的 JSON 表示
15	PUT	`/v4.0/cells/spreadsheet/create`	—	(別名 — 請參見 #1)

路由假設主機為 https://api.aspose.cloud。實際呼叫看起來像 https://api.aspose.cloud/v4.0/cells/...。

3. 開始之前：兩個先決條件

取得認證資訊。 在 Aspose Cloud Dashboard 註冊，建立一個應用程式，取得 Client ID 和 Client Secret。SDK 會為您處理 JWT 交換；若使用 cURL，則需要手動將它們換成 bearer token。
安裝 SDK — 或直接使用 cURL。所有操作皆為純粹的 REST。

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

4. 快速入門：建立新工作簿

PUT /v4.0/cells/spreadsheet/create 是控制器執行的最簡單操作之一，也是最有用的之一。它會返回一個全新的工作簿檔案。

cURL

# 1) Get a bearer token
curl -X POST "https://api.aspose.cloud/connect/token" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

# 2) Create an empty XLSX
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output new_workbook.xlsx

Parameter	Type	Default	Meaning
`format`	string	`xlsx`	輸出檔案格式 — `xlsx`, `xlsm`, `xlsb`, `ods` 等。
`template`	string	`null`	可選的範本檔案路徑。提供時，新的活頁簿將以範本的內容和格式初始化。

使用範本

如果您有品牌化的範本 — 標頭中的標誌、主題中的品牌色彩、預先格式化的 “發票” 表格 — 只需將其上傳至雲端儲存，然後將其路徑作為 template 傳遞。

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx&template=templates/invoice_branded.xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output invoice_2026_09_001.xlsx

現在，您的應用程式可以生成已經外觀正確的全新發票，而無需嵌入任何樣式邏輯。

5. 操作說明：在活頁簿中管理工作表

這四個端點處理工作簿的日常結構。讓我們走過一個實際的流程：您已上傳工作簿，現在需要列出其工作表、添加一個新工作表、重新命名現有的工作表，並刪除第三個工作表。

5a. 列出工作表

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/worksheets" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@my_workbook.xlsx"

Response:

[
  { "WorksheetName": "Sheet1", "SheetType": "Worksheet" },
  { "WorksheetName": "Data", "SheetType": "Worksheet" },
  { "WorksheetName": "Chart1", "SheetType": "Chart" }
]

5b. 新增工作表

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet?sheetType=Worksheet&position=1&sheetName=Summary" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

參數	類型	預設值	說明
`sheetType`	string	`Worksheet`	新工作表的類型 — `Worksheet`、`Chart` 等。
`position`	int	end	插入新工作表的 0 索引位置
`sheetName`	string	auto	新工作表的名稱

5c. 重新命名工作表

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Overview" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5d. 刪除工作表

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/delete/worksheet?sheetName=Chart1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5e. 移動工作表

# Move "Data" to position 0 (front of the workbook)
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?worksheet=Data&position=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

每個端點都遵循相同的模式：以 multipart 方式上傳工作簿，然後返回已修改的工作簿。將它們串接在您的管道中，或從 UI 中即時呼叫。

6. 操作說明：壓縮過大的工作簿

使用者寄給您一個 40 MB 的 XLSX，其中有 90% 冗餘的 XML。PUT /v4.0/cells/spreadsheet/compress 可以將其壓縮。

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/compress?level=9" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@bloated.xlsx" \
  --output slim.xlsx

參數	類型	含義
`level`	int	壓縮強度。0 = 無壓縮，9 = 最大壓縮。

在典型的 40 MB 工作簿上，將等級設為 9 通常會落在 6–10 MB 的範圍內。內容保持不變；僅僅是 XLSX 容器的 ZIP 壓縮被加強。

7. 操作說明：修復受損的工作簿

有時您會收到 Excel 拒絕打開的檔案。PUT /v4.0/cells/spreadsheet/repair 會執行引擎的修復例程，並返回一個乾淨的版本。

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/repair" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@broken.xlsx" \
  --output repaired.xlsx

無參數。
控制器透過引擎重新序列化工作簿，該引擎會丟棄損壞的部分並寫入結構有效的檔案。
並非所有損壞都能復原，但此方法可處理常見情況——截斷的 ZIP 條目、無效的儲存格參照、格式錯誤的共享字串。

8. 關鍵效益摘要

單一控制器負責生命週期操作。 建立、重構、壓縮、修復、檢查——全部在同一授權模型和單一錯誤合約下完成。
具備模板感知的建立。 不要在應用程式中重新實作樣式；讓伺服器在每個新工作簿中嵌入模板。
本地與遠端變體。 無論檔案位於使用者瀏覽器中或已在雲端儲存，邏輯皆相同。
結構檢視。 structure 端點返回工作表、表格、樞紐分析表、圖表和形狀的完整 JSON 映射——非常適合驅動 UI 或驗證流程。
零基礎設施。 無需安裝 Excel，無需 COM，無需維護伺服器。

建立、管理、維護：Aspose.Cells 雲端管理 API 實用指南#

1. ManagementController 的功能是什麼？#

2. 十五個端點概覽#

3. 開始之前：兩個先決條件#

4. 快速入門：建立新工作簿#

cURL#

使用範本#

5. 操作說明：在活頁簿中管理工作表#

5a. 列出工作表#

5b. 新增工作表#

5c. 重新命名工作表#

5d. 刪除工作表#

5e. 移動工作表#

6. 操作說明：壓縮過大的工作簿#

7. 操作說明：修復受損的工作簿#

8. 關鍵效益摘要#