匯出自訂鏡像到OSS並下載到本地 - Elastic Compute Service

建立自訂鏡像後，可將自訂鏡像匯出至Object Storage Service（Object Storage Service）後，下載鏡像檔案到本地，用於本地鏡像分析、備份、遷移等。

適用範圍

需在目標自訂鏡像相同地區下準備一個OSS Bucket，用於中轉儲存匯出的自訂鏡像。匯出時，僅支援選擇標準儲存或低頻訪問儲存類型的OSS Bucket，不支援歸檔類型。如需建立，請參見建立儲存空間。

訪問ECS控制台-鏡像，在頁面左側頂部，選擇目標資源所在的資源群組和地區。
在自訂鏡像頁簽，找到目標鏡像，單擊操作列中的匯出鏡像。
仔細查看匯出前準備事項，單擊下一步。再次確認已完成前提條件所述配置，單擊繼續匯出。
配置匯出鏡像檔案的參數。
- 鏡像格式：預設為自動檢測，支援選擇RAW、VHD、QCOW2、VDI和VMDK格式。
- 鏡像儲存空間（OSS Bucket）：選擇與自訂鏡像所屬地區相同的OSS Bucket。
- 鏡像檔案名首碼：以將Demo設為首碼為例，匯出自訂鏡像檔案後，在OSS Bucket中的名稱即為Demo-[系統自動產生的檔案名稱]。
單擊確定匯出，開始匯出自訂鏡像。匯出時間取決於鏡像檔案的大小和當前置出任務隊列的繁忙程度，請耐心等待。
可前往ECS控制台-任務管理，通過任務ID查詢任務即時進度，或中斷取消匯出自訂鏡像任務，也可以登入OSS控制台查詢任務結果。

可以調用API介面ExportImage匯出自訂鏡像。若需中斷匯出任務，可以調用API介面CancelTask取消正在啟動並執行匯出鏡像任務。

鏡像成功匯出到OSS後，可將其下載到本地進行進一步處理。

下載鏡像檔案至本地
- 鏡像檔案不超過5GB：可登入 OSS管理主控台，在目標OSS Bucket中找到鏡像檔案，並單擊操作列的下載。
- 鏡像檔案大於5GB：推薦使用命令列工具ossutil進行下載。該工具支援斷點續傳、批量下載和多線程，更穩定高效。
解壓鏡像檔案
若匯出鏡像時選擇RAW作為鏡像格式，匯出後鏡像檔案副檔名預設為.raw.tar.gz，解壓後副檔名為.raw。
- 在Linux系統下，使用命令 tar -xzf <鏡像檔案名>.raw.tar.gz 進行解壓。
- 在macOS系統下，推薦使用 gnu-tar 工具進行解壓，以避免相容性問題。
（可選）轉換鏡像格式
若匯出的RAW格式鏡像需轉換為其他格式，可使用開源工具 qemu-img，參見轉換鏡像格式進行操作。

匯出自訂鏡像至OSS過程中，依賴的OSS資源會產生費用，主要包括：

OSS儲存費用：匯出的鏡像檔案作為對象（Object）儲存在OSS Bucket中，按儲存時間長度和檔案大小計費。
OSS請求費用：匯出過程中，系統調用OSS API進行檔案讀寫，產生API請求費用。
在匯出時，選擇不同鏡像格式會導致訪問OSS API的讀取次數不同，產生請求費用差異，建議選擇讀取次數較少的VHD格式。
OSS流量費用：將鏡像檔案從OSS Bucket下載到本地時，會產生外網流出費用。在阿里雲同地區ECS執行個體內通過內網訪問則免費。

匯出鏡像遇到任務失敗的問題後，可通過ECS控制台-任務管理介面或調用API介面DescribeTaskAttribute查看錯誤碼，根據錯誤碼確認問題詳情並進行修複。

錯誤碼	錯誤原因	原因定位	修複建議
IMAGE_ALREADY_EXIST	OSS Bucket中存在同名檔案（Object）。	確認匯出的OSS Bucket中是否存在同名檔案（Object）。	建議更換匯出的OSS Bucket。建議更換匯出的鏡像檔案名稱。

若資料盤容量超過2 TiB，需將資料分散拷貝到多塊小於2 TiB的新資料盤上，再建立自訂鏡像進行匯出。具體操作如下：

使用自訂鏡像建立隨用隨付執行個體。
遠程登入建立的ECS執行個體，執行df -h命令查看資料盤實際容量，根據實際容量建立新的空資料盤（可按需建立多個），並掛載資料盤，然後將原資料盤的資料拷貝到新的資料盤。
使用新的資料盤和系統硬碟建立快照。
使用快照建立自訂鏡像，然後匯出自訂鏡像。

若自訂鏡像包含資料盤快照，匯出的結果中會有多個檔案。檔案名稱中帶有 system 的為系統硬碟快照，帶有 data 的為資料盤快照。資料盤檔案通常還會包含掛載點標識（如 xvdb、xvdc），以便區分。

加密是無法復原的操作，不支援對加密鏡像進行解密匯出，資料在加密狀態下儲存，即使匯出後也無法解密其內容。

若需匯出加密鏡像中的資料，可使用加密鏡像建立ECS執行個體，在執行個體中完成必要的配置和資料移轉，基於該執行個體建立一個新的未加密自訂鏡像後匯出。