AzCopy 上載中斷:如何以工作紀錄定位錯誤並安全恢復?

AzCopy 上載中斷:如何以工作紀錄定位錯誤並安全恢復?

Marcus Reid
2026年10月7日· 7 分鐘讀完

AzCopy 上載中斷後,先保留工作 ID、計劃檔案及紀錄,再考慮重新複製。找出首個失敗傳輸,區分身份驗證、儲存存取和網絡逾時;目的地與剩餘操作均核對過,才恢復該工作。

關鍵要點:

  • 保存計劃和來源檔案,重新執行並不等於恢復。
  • 403 先查憑證和儲存政策,不重複換路徑。
  • 最後狀態要配合 failed、skipped 數目判讀。
  • 真正傳輸後核實物件,SAS 必須私下保留。

步驟 1:AzCopy 上載中斷來自哪個執行環境?

確認執行 AzCopy 的電腦或服務,記錄版本、作業系統、工作 ID、來源與目的角色。分清本地上載、下載或服務之間複製;在筆記本啟動命令,不表示所有資料經筆記本或本機 VPN 傳送。

私下保留原命令,保護秘密資料。分享前刪去 SAS 查詢值、敏感帳戶識別資料、私人路徑及授權資料。保存來源檔案和目的地狀態;未理解工作前,不先刪除部分結果。

AzCopy 會建立紀錄與工作計劃,官方指南說明按 ID 查看及恢復。[1] 紀錄保存事件,計劃列出建立工作時發現的待處理物件。即使來源仍在,遺失計劃也可能失去原恢復程序的依據。

若多個客戶端同時出錯,先按裝置與應用連接基線檢查。使用另一工具時,另行排查 rclone 重試模型,不要把其參數及假設移植到 AzCopy。

步驟 2:紀錄和傳輸數字實際說明甚麼?

從既有工作紀錄開始,不為產生診斷而再做完整傳輸。找出對應失敗操作的第一個相關錯誤,記下時間和請求方法。Microsoft 指南分開連接、身份驗證及儲存錯誤,最後摘要未必揭示根因。[2]

把佔位值換成已保存的工作 ID,在本地執行:

azcopy --version
azcopy jobs list
azcopy jobs show YOUR-JOB-ID
azcopy jobs show YOUR-JOB-ID --with-status=Failed

文件指出 --with-status 的值區分大小寫。[1] 錯誤篩選值或 ID 可能隱藏你真正要看的工作。摘要與失敗清單一起保存,不憑單一空輸出認定沒有失敗。

記錄 total、completed、failed、skipped、實際位元組及已檢查目的地。工作顯示完成,仍可能排除了檔案或略過既有物件。狀態描述該工作本身,不能取代整個預期資料集的核實。

步驟 3:這是存取問題還是 AzCopy 網絡逾時?

結合帳戶、端點、操作和時間理解錯誤。403 可以由多種授權或儲存政策引起,不把每個 403 都當成 SAS 過期,也不據此認為另一公網出口已獲准。

證據責任分支安全的下一項檢查
403 或身份驗證被拒憑證、權限、儲存政策Token 範圍、有效期、存取條件
連接或讀取逾時路徑、代理、端點、服務中斷操作、時間、執行裝置
限流或服務錯誤儲存服務與重試政策供應方說明及事故證據
來源無法讀取本地路徑或來源存取保存的檔案與權限
傳輸被略過既有物件或選取規則工作意圖和目的地
要求私有端點組織網絡獲准私有連接及 DNS 負責人

按正常安全程序核對憑證有效時段,以及操作需要的權限。不要把完整 SAS 放入網上解碼工具、支援討論區或截圖;短期令牌同樣要保護。

儲存防火牆或 IP 限制,應由管理員確認允許的路徑。消費 VPN 可以產生明確不獲准的公網地址。保留 TLS 驗證,憑證錯誤交信任設定或攔截調查,不以取消安全檢查換取成功摘要。

步驟 4:是否能安全恢復這項工作?

選擇 AzCopy 恢復工作前,確認來源仍是預期資料,目的仍為獲准測試位置。核對計劃檔案是否在設定位置,不先移動、改名或清理計劃。

恢復依照原計劃處理先前未傳完的工作。SAS 為安全理由不存於計劃內,所以 SAS 工作可能要私下重新提供所需來源或目的端的有效令牌。[1] 這只是原授權範圍內更新憑證,並不授權擴大目的或帳戶。

azcopy jobs resume YOUR-JOB-ID

只有原工作身份驗證要求已滿足,基本形式才足夠。若要 SAS,按官方命令指引,僅私下提供需要那一端的令牌。例子不用真實秘密,也不聲稱每次上載必須同時傳入兩端 SAS。

有大量剩餘寫入的正式工作,不是無害連接測試。請擁有人批准恢復,或先建立獨立、範圍受控的測試。計劃缺失或目的地不能確認時停下,與擁有人重建獲准操作,不猜測未傳的檔案。

步驟 5:怎樣將比較限定在一項測試?

選用無敏感資料的本地檔案,以及測試容器內獲准的空目的地。啟動前核對兩端,保持 AzCopy 版本、授權範圍、檔案、工作設定和端點一致,否則難以分辨單一路徑的影響。

失敗測試可恢復時,第二次沿用該 ID 與計劃。不因逾時而對同一正式路徑重新跑大型遞迴複製。明確的小範圍恢復,比結果未知、互相重疊的工作更有診斷價值。

核對程式從 shell 或排程繼承的設定。Windows 可查看系統代理情境,再確認程式採用的獲准網絡設定。瀏覽器使用另一連接,不能代表此命令的路徑。

換路前記錄傳輸數字和目的狀態。第一輪可能已送出部分物件,因此第二輪剩餘工作較少;應標作恢復證據,不稱為公平速度比較。沒有剩餘資料可傳時,resume 成功不證明新路徑真的承載上載。

步驟 6:剩餘公網傳輸是否能經另一獲准路徑完成?

僅在逾時或連接分支,並獲准使用另一公網路徑時繼續。私有端點、強制代理和出站 IP 條件仍由儲存擁有人處理。若懷疑原 VPN 導致問題,先比較獲准直接連接,不強行推薦另一服務。

保存可恢復 AzCopy 測試工作的 Windows 電腦,可用 AethoVPN 提供出站對照:採用官方安裝包及桌面 Pro 或 Premium,選目前可用的就近位置,恢復前開啟全局模式。計劃和資源範圍保持不變,再查看剩餘傳輸和目的物件;403、過期 SAS、防火牆規則或私有端點仍要另行處理。以電郵註冊,開始 3 天免費 Pro 試用核實工作恢復;每名用戶限一次,註冊即開始計算。

Debian/Ubuntu x64 在真正執行 AzCopy 的電腦使用官方 .deb。Mac 按網站設定指南,透過 VPN 客戶端連接,需 Pro 或 Premium。不描述原生 Mac App,也不聲稱本機客戶端會改變雲端 worker 的路徑。

resume 前核實 VPN 連接。記錄兩次嘗試,不獲准路徑或再次拒絕存取便停止;一次恢復不保證日後可用,也不改變擁有人責任。

步驟 7:目的核實和測試清理是否妥當?

重新查看統計及餘下 failed,逐項解釋 skipped:物件本已正確、被工作排除,還是沒有實際傳輸?零失敗仍要與預期測試物件、大小和內容核對。

用獲准方式把安全物件讀回另一核實位置。服務和流程提供適用完整性中繼資料時也要檢查。不假設每次上載會自動儲存內容雜湊,也不以檔案名稱存在證明預期位元組到達。

保存工作 ID、端點角色、遮蔽敏感值的命令、第一個錯誤、來源狀態、前後數字、實際傳輸及目的核實。分清觀察與未測試條件,尤其服務端複製和私有存取路徑。

還原臨時診斷設定,再由擁有人決定正式工作何時重啟。保存證據後只移除批准的測試物件,不清空容器或刪去影響其它恢復的計劃。持續失敗交管理員或官方支援,只提供已審閱片段,不公開令牌。

總結

  • 保存工作 ID、計劃、紀錄及原始檔案。
  • 改憑證或路徑前分類首個錯誤。
  • 只恢復核對過的工作,記錄實際傳輸。
  • 對照目的內容及完成、失敗、略過數字。

常見問題

重新複製與恢復工作有何分別?

恢復使用原計劃與剩餘工作,新呼叫則建立新任務,可能與既有目的重疊。先核對寫入範圍,不把兩者視作等價重試。[1]

每個 403 都表示 SAS 過期嗎?

403 也可能來自權限或儲存政策。檢查操作和獲准範圍;未確定責任分支前,不隨意更新令牌或不斷更換路徑。

刪除計劃檔案後還能恢復嗎?

官方恢復依賴工作計劃,清理前須保留。計劃不可用時請擁有人另定獲准恢復,不猜測哪些檔案尚未傳送。

為何恢復成功卻沒有傳送位元組?

可能已無剩餘合資格工作,或物件被略過。這描述工作狀態,不能證明剛改變的路徑實際承載了上載資料。

求助時要提供完整 SAS 嗎?

只透過獲准支援渠道傳送已遮蔽秘密的命令和錯誤片段。紀錄及完整 URL 可能敏感,即使令牌短期有效也不公開。

本機 VPN 能處理私有儲存端點嗎?

私有端點需要組織批准的網絡和名稱設定。另一公網出口並非私有連接,更可能違反儲存防火牆或出站 IP 政策。

何時可恢復正式工作?

先確認預期物件、實際傳輸數字和修正原因,再由擁有人批准正式範圍。小測試恢復不等於整項遷移或備份通過核實。

免責聲明: 僅恢復獲准工作並保護原資料。不繞過儲存存取控制、不公開憑證,也不關閉驗證以取得成功摘要。

來源

  1. Microsoft — Find errors and resume jobs with logs in AzCopy — https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-configure
  2. Microsoft — Troubleshoot issues in AzCopy — https://learn.microsoft.com/en-us/troubleshoot/azure/azure-storage/blobs/connectivity/storage-use-azcopy-troubleshoot

Sources checked 2026 年 10 月 7 日。

延伸閱讀

開啟 3 天免費試用

註冊即可免費體驗全部高級功能。

*只限新用戶;每位用戶只可獲得一次試用。

AzCopy 上載中斷:如何以工作紀錄定位錯誤並安全恢復? | AethoVPN