Azure Storage Mover 代理程式使用字串狀態碼來表示傳達給終端使用者的狀態。 所有的狀態碼都以 AZSM 為前置詞，後面接著四個十進位的數字。 第一個十進位的數字表示狀態的高階範圍。 每個狀態碼都應屬於下列其中一個範圍：
- 套用至整個代理程式的狀態。
這些代碼使用範圍數字0，因此其前置詞為AZSM0。 - 套用至代理程式所執行之特定作業的狀態。
這些代碼使用範圍數字1，因此其前置詞為AZSM1。 - 代理程式可能在其執行的作業傳輸的特定檔案或目錄上設定的狀態。
這些代碼使用範圍數字2，因此其前置詞為AZSM2。
這些每個範圍都會進一步將狀態劃分為類別和子類別。 每個子類別通常會保留 20 個狀態碼，以便未來擴充使用。
秘訣
AZSM0000 是與範圍無關的特殊狀態碼，表示成功操作，應該用來表示在任何範圍/層級成功操作。
| 錯誤碼 | 錯誤訊息 | 詳細資料/疑難排解步驟/風險降低 |
|---|---|---|
| AZSM1001 | 無法掛接來源路徑 | 驗證所提供的伺服器名稱或 IP 位址是否有效，或來源位置是否正確。 如果使用 SMB，請驗證所提供的使用者名稱和密碼是否正確。 |
| AZSM1002 | 掃描來源時發生了錯誤 | 請重試或建立支援票證。 |
| AZSM1003 | 因權限問題而無法存取來源資料夾 | 驗證代理程式是否已獲授與對來源檔案共用的權限。 |
| AZSM1004 | 所提供的來源路徑無效 | 請使用有效的來源共用路徑來建立新的端點，並更新作業定義，然後重試。 |
| AZSM1020 | 存取來源時發生各種錯誤 | 此錯誤會因任何導致來源檔案/資料夾讀取失敗的原因而報告。 有些錯誤可能是「沒有這樣的檔案或目錄」、「權限被拒絕」、「輸入/輸出錯誤」等。請確定代理程式與來源共用之間的網路連線運作良好。 來源共用/資料夾/檔案必須存在，且代理程式應該具有來源共用的讀取權限。 |
| AZSM1021 | 因權限問題而無法存取目標資料夾 | 請重試或建立支援票證。 |
| AZSM1022 | 所提供的目標路徑無效 | 請使用有效的目標容器和路徑來建立新的端點，並更新作業定義，然後重試。 |
| AZSM1023 | 此代理程式在目標容器上的租用已過期 | 請重試或建立支援票證。 |
| AZSM1024 | 存取目標位置時授權失敗 | 代理程式沒有足夠的權限可以存取目標位置。 使用 Azure 入口網站建立資源時，會自動執行 RBAC (角色型存取控制) 角色指派。 如果您正在使用 API、PowerShell Cmdlet 或 SDK，請手動為代理程式的受控識別建立角色指派，以存取目標位置。 對於儲存體 Blob 容器目標，請使用儲存體 Blob 資料參與者角色指派。 對於 Azure 檔案共用目標，請使用儲存體檔案資料特殊權限參與者。 例如，若要指派 RBAC 角色，請參閱 指派 Azure 角色以存取 Blob 資料 一文。 |
| AZSM1025 | 存取來源位置時驗證失敗 | 確認代理程式具有來源位置的權限。 |
| AZSM1026 | 代理程式不支援目標類型 | 目前的 Storage Mover 代理程式不支援此目標類型。 |
| AZSM1027 | 目標位置忙碌中 | 代理程式無法取得目標共用或容器的控制權，因為目前存在一個作用中的租用。 這個租用可能是由於另一個移轉作業，或先前中止的作業仍然持有對檔案“AZURE_STORAGE_MOVER_MARKER”的控制權而存在。 請確定此目標沒有其他作業正在執行。 如果沒有執行中，請重新啟動代理程式，然後重試;如果問題持續發生，請聯絡支援人員。 |
| AZSM1028 | Key Vault 存取失敗 | 如果代理程式的受控識別缺少「金鑰保存庫秘密使用者」RBAC 存取權、防火牆或網路 ACL 封鎖金鑰保存庫端點的連線，或遺失秘密，則可能會發生此錯誤。 針對「RESPONSE 403」錯誤，請檢查密鑰保管庫上的角色指派和任何防火牆規則，以確定是否有限制流量的問題。 對於其他錯誤，請使用「2）網路組態」下的xdmsh功能表選項「5）測試單一端點連線能力」來驗證端點連線能力。 |
| AZSM1029 | 此代理程式版本不支援來源端點類型 | 目前的 Storage Mover 代理程式不支援此來源類型。 |
| AZSM1030 | 無法驗證儲存體帳戶類型 | 請驗證儲存體帳戶和容器是否存在，以及代理程式是否已獲授與對它們的權限。 |
| AZSM1031 | 無法解析目標主機 | 檢查網路設定以確認防火牆，或 ACL 未封鎖儲存體帳戶端點的存取。 使用「2）網路設定」下的xdmsh功能表選項「5）測試單一端點連線能力」來驗證端點連線能力。 |
| AZSM1040 | 存取目標時發生各種錯誤 | 此錯誤可能是暫時性的。 請再次重試移轉作業。 如果問題仍然存在，請建立支援票證以獲得進一步協助。 |
| AZSM1041 | 無法傳送作業進度 | 此錯誤可能是暫時性的。 請再次重試移轉作業。 如果問題仍然存在，請建立支援票證以獲得進一步協助。 |
| AZSM1042 | 無法建立作業 | 此錯誤可能是因為各種原因，例如代理程式無法連線到儲存體帳戶端點、防火牆或封鎖連線的網路 ACL、在儲存體帳戶上設定私人端點時，來自代理程式的流量會透過公用 IP 路由傳送，或 Proxy 修改憑證。 若要確認儲存體帳戶端點連線能力，請使用 [2） 網路設定] 底下的 xdmsh 功能表選項 [5） 測試單一端點連線]。 如果報告的錯誤為「x509：由未知授權單位簽署的憑證」，則表示內部部署網路正在攔截和更改 SSL 憑證 （SSL 攔截） 以取得所需端點的流量，導致代理程式無法辨識收到的憑證。 雖然將憑證新增至代理程式通常會解決此問題，但目前不支援此功能。 若要讓代理程式存取這些端點，請考慮將它們新增至允許清單以略過 SSL 攔截。 |
| AZSM1043 | 無法繼續作業 | 請重試或建立支援票證。 |
| AZSM1044 | 無法完成作業。 | 請重試或建立支援票證。 |
| AZSM1045 | 作業仍在執行時被中止。 | 請重試或建立支援票證。 |
| AZSM1060 | 作業執行期間發生各種錯誤。 | 此錯誤可能由於各種原因而發生。 檢閱報告的錯誤，並根據其詳細資料採取更正措施，如下所述。 如果錯誤指出：1） “InvalidResourceName”：檢查資料夾和檔案名稱是否遵循支援的命名慣例。 例如，「con」不是有效的目錄名稱。 2）「指定份額已滿」：驗證目標份額的容量。 3） 「錯誤的檔案描述元」：確認代理程式與來源之間的 SMB 網路連線正常運作，以及 SMB 伺服器回應讀取要求。 4） 「403 此要求未獲授權執行此作業」：如果已針對目標儲存體帳戶設定私人端點，請檢查 DNS 是否已正確設定，並確認沒有 DNS 錯誤路由或負載平衡器設定導致不正確的 IP 解析。 5）對於其他錯誤，請重試作業，如果問題仍然存在，請建立客服工單。 |
| AZSM2021 | 目標不支援檔案類型。 | 此目標類型不支援此類型的檔案。 如需其他資訊，請參閱 Azure 檔案儲存體和 Azure Blob 儲存體的可擴縮性和效能目標。 |
| AZSM2024 | 來源路徑長度超過目標所支援的最大長度。 | 請參閱命名和參考共用、目錄、檔案和中繼資料 (部分機器翻譯) 一文中的指導。 |
| AZSM2026 | 來源檔案的大小大於目標所支援的最大大小。 | 請參閱命名和參考共用、目錄、檔案和中繼資料 (部分機器翻譯) 一文中的指導。 |
| AZSM2027 | 來源檔案安全性描述元具有不受支援的屬性 | 檢閱檔案或資料夾的權限。 |
| AZSM2061 | 掃描來源時發生了未知的錯誤。 | 可能是暫時性錯誤。 請重新執行移轉作業。 |
| AZSM2062 | 因權限問題而無法讀取來源檔案。 | 確認代理程式具有來源位置的權限。 |
| AZSM2063 | 讀取來源檔案時發生了 I/O 錯誤。 | 此錯誤可能是暫時性的。 請再次重試移轉作業。 如果問題仍然存在，請建立支援票證以獲得進一步協助。 |
| AZSM2069 | 因權限問題而無法讀取目標檔案。 | 驗證代理程式是否已獲授與對目標位置的權限。 |
| AZSM2070 | 無法寫入 Blob，因為它具有作用中的租用 | 此錯誤可能是由另一個寫入位置的代理程式所造成。 確保沒有其他作業正在針對目標執行。 請重試或建立支援票證。 |
| AZSM2071 | 傳輸期間修改了來源檔案 | 此錯誤可能是暫時性的。 請再次重試移轉作業。 如果問題仍然存在，請建立支援票證以獲得進一步協助。 |
| AZSM2080 | 因未知的錯誤而複製失敗 | 此錯誤可能是暫時性的。 請再次重試移轉作業。 如果問題仍然存在，請建立支援票證以獲得進一步協助。 |
針對 Storage Mover RBAC 問題進行疑難排解
在作業執行期間，會進行自動 RBAC 指派。 如果指派失敗，請手動新增所需的角色指派。
- 流覽至適當的資源 - 金鑰保存庫、檔案共用或 Blob 容器。
- 瀏覽至 [存取控制 (IAM)]。
- 新增角色指派： 使用 Azure 入口網站指派 Azure 角色 - Azure RBAC |Microsoft 學習。
- 在 [新增角色指派精靈] 中，在下表中針對步驟 1 中選取的資源類型搜尋適當的角色。 在下列範例中，資源會是 Key Vault。
| 資源類型 | 所需角色 |
|---|---|
| 金鑰保存庫 | 金鑰庫密鑰使用者 |
| 檔案共用 | 儲存體檔案資料特殊權限參與者 |
| Blob 容器 | 儲存體 Blob 資料特殊權限參與者 |
一。 指派存取權應針對「受控識別」。
二. 在右側窗格中，選取 [管理的身分識別類型] 為 [電腦 – Azure Arc]。
iii. 從清單中選取機器弧。 其名稱與代理程式相同。
四。 完成作業。