# 修復實例：會清空磁碟的破壞性操作

修復實例會清空當前實例的全部磁碟資料且無法恢復。本文說明適用場景、二次確認流程、哪些內容會保留，以及實例從未建立成功時的例外分支。

> [!CAUTION]
> 修復會銷毀當前實例的底層資源及其全部磁碟資料，且無法恢復，然後按實例保存的配置重新建立。這不是重新啟動，也不是重灌——它是一次徹底的銷毀再重建。

修復實例（Repair）的入口在實例詳細資料頁的「高級」面板。按下按鈕前，先確認這臺實例上沒有尚未備份、又不能遺失的資料。

## 什麼時候用修復

修復適用於底層資源異常或實例無法正常啟動的情況，例如實例所在的主機資源損壞、系統磁碟開機失敗且重新啟動無效。主控台上的說明原文是：

> 使用當前儲存的映像、規格、網路和登入配置修復實例，適用於底層資源異常或無法正常啟動的情況。

如果實例只是執行異常但仍能開關機，先嘗試[重新啟動](/zh-tw/compute/instances/management/power/)，而不是直接修復。重新啟動保留磁碟資料，修復不保留。

_介面示意圖：實例詳細資料頁「高級」面板中的「修復實例」區塊：標題、說明文字、下方的保留/刪除/影響三行提示，以及右側的修復實例按鈕_

## 會發生什麼，不會發生什麼

「修復」這個名字聽起來像是打補丁，實際行為是先刪除再重建整臺實例：

| 會發生什麼                                                           | 不會發生什麼                                                                                                       |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 若實例仍在執行，平台先強制停止，再銷毀底層資源                       | 不會保留舊磁碟上的任何資料——是徹底清空，不是格式化後複用同一顆磁碟                                                 |
| 徹底刪除該實例在虛擬化層的全部儲存卷                                 | 不會修改實例身分、網路配置、計費關係，也不會影響已有的備份記錄                                                     |
| 按實例當前保存的鏡像、規格、網路和登入配置，從範本重新建立一臺新實例 | 不會略過二次確認——前後端都會校驗你輸入的實例名稱是否準確                                                           |
| 實例狀態變為「正在修復」，期間暫時離線                               | 不會在資源已經不可用時才失敗——修復前會重新校驗規格、鏡像和節點配置是否仍然可用，任一失效就直接拒絕，不會動現有實例 |

當前實例只有一顆系統磁碟，沒有獨立的資料磁碟概念，因此「清空全部磁碟資料」就是清空這唯一的系統磁碟。修復不會自動為你產生快照——如果你此前對這臺實例做過整機備份，磁碟資料可以從備份恢復；如果沒有，磁碟資料無法找回。

## 開始之前

- **權限**：你的角色必須包含實例操作權限。專案成員及以上預設擁有；專案檢視者沒有，按鈕會是停用狀態。
- **實例狀態必須允許修復**：已交付的實例（已完成首次佈建）僅「正在執行」、「已停止」、「錯誤」、「失敗」四種狀態允許修復；尚未交付的實例僅「正在等待」、「正在預配」、「錯誤」、「失敗」允許。其餘狀態下按鈕保持停用。
- **實例沒有處於維護鎖定**：主機維護期間無法修復。
- **沒有進行中的工作要求**：建立、重灌、升級、遷移、刪除等工作處於等待或執行中時，修復會遭拒。

## 修復實例

1. 開啟「運算 > 實例」，進入目標實例的詳細資料頁，切換到「高級」面板。
2. 在「修復實例」區塊，核對下方列出的三行提示：**保留**——「實例身分、網路、計費關係和備份記錄」；**刪除**——「當前實例的全部磁碟資料，且無法恢復」；**影響**——「修復期間實例將暫時離線」。
3. 按一下**修復實例**，開啟確認對話方塊。
4. 對話方塊要求輸入實例名稱以確認：

   > 請輸入實例名稱「`{{name}}`」以確認清空當前磁碟並修復實例：

   `{{name}}` 會替換為這臺實例的實際名稱。在輸入框中準確輸入當前實例的名稱。

   _介面示意圖：修復實例確認對話方塊：標題、保留/刪除/影響三行提示列表、要求輸入實例名稱的說明文字、名稱輸入框，以及底部的取消和確認按鈕_

5. 輸入的名稱與實例名稱不一致時，輸入框下方會顯示：「輸入的名稱與實例名稱不一致」，確認按鈕保持停用。名稱完全相符後，確認按鈕才會點亮為**清空磁碟並修復實例**。
6. 按一下**清空磁碟並修復實例**送出。

送出後實例狀態變為「正在修復」，可以在實例詳細資料的「工作要求」中追蹤進度。修復完成後狀態恢復為「正在執行」或「已停止」，視重建後的開機結果而定。

## 特殊情況：實例從未建立成功

如果這臺實例此前的建立流程中途失敗、平台還沒有成功把它建立出來，按下「修復實例」走的是完全不同的路徑：**平台會恢復原本未完成的建立要求，繼續把這臺實例佈建出來，不會觸發任何磁碟銷毀**，因為根本沒有舊資源可刪。

這種情況通常發生在實例仍處於「正在等待」、「正在預配」、「錯誤」或「失敗」狀態、且從未成功開過機的時候。對這類實例來說，「修復」實際上等同於「繼續建立」，是安全操作。危險的銷毀行為只發生在實例已經真實建立成功時。

## 動作遭拒時

修復會在送出前做一輪檢查。主控台會原樣顯示平台傳回的訊息，下面依訊息分類說明。

### 有工作要求正在進行

> 此实例正有工作请求正在进行，因此您无法操作此实例。请等待最长 15 分钟，然后重试。如果您遇到问题，请联系 Cypacky Support 以获取帮助。

實例上有建立、重灌、升級、遷移或刪除工作處於等待或執行中。開啟實例詳細資料的「工作要求」，等最後一筆工作結束後再重試。

### 實例正在維護

> 此实例正在维护，当前无法修复。

實例所在的主機處於維護狀態。這條提示是修復功能獨立的檢查，與電源動作顯示的維護提示文字不同。維護結束後再重試。

### 實例當前狀態不允許修復

> 实例当前状态不允许修复

實例的狀態不在允許修復的範圍內，參考「開始之前」裡列出的狀態清單。多數情況下按鈕已經處於停用狀態，不會走到這一步。

### 輸入的名稱不相符

> 输入的名称与实例名称不一致

確認對話方塊裡輸入框中的文字必須與實例名稱逐字相同，確認按鈕才會點亮。就算繞過前端直接呼叫介面送出，後端也會用同樣的規則再校驗一次，傳回「实例名称不匹配」。

### 實例配置已不可用

> 实例配置已不可用，无法修复

實例當前使用的規格已經下架或失效。修復前會重新校驗規格是否仍然可用，失效時直接拒絕，不會動現有實例。

### 實例鏡像已不可用

> 实例映像已不可用，无法修复

實例當前使用的鏡像版本已經下架或失效，修復無法重新複製出實例，直接拒絕。

### 節點配置不可用

> 节点 PVE 配置不可用，无法修复

實例所在節點的底層虛擬化配置不可用，多為節點側問題，此時不會執行任何刪除操作。稍後重試，或聯絡 Cypacky Support。

### 實例正在等待付款啟用或已欠費

> 此实例正在等待支付激活，当前无法执行该操作。

> 此实例当前处于欠费状态，当前无法执行该操作。

完成付款或結清欠費後，修復才能執行。

### 有未付款或正在兌現的帳單

> 此实例有待支付的升级或流量重置账单，当前操作可能与付款兑现冲突。

> 此实例有已支付账单正在兑现，请等待账单动作完成后再操作。

先完成或取消對應帳單，或等待帳單動作執行完畢再修復。

### 實例因安全投訴遭鎖定

> 此实例因安全投诉已被锁定。当前操作不可用，请联系 Cypacky Support。

透過支援單聯絡 Cypacky Support 了解原因和解鎖條件。

## 相關文件

- [實例高級設定](/zh-tw/compute/instances/detail/advanced/)
- [啟動、停止與重新啟動實例](/zh-tw/compute/instances/management/power/)
- [刪除實例](/zh-tw/compute/instances/management/delete/)
- [工作要求](/zh-tw/compute/operations/work-requests/)