注意事項

使用在線遷移服務遷移數據時需要注意以下事項：

• 創建目的數據地址時，待遷移目錄請使用絕對路徑，必須以正斜線（/）開頭和結尾，不支持環境變量和特殊字符。

• 創建目的數據地址時，需確保待遷移目錄存在且正確有效。

• 在線遷移服務使用源站存儲服務提供商公開的標準接口來訪問源數據，其行為依賴于源站存儲服務提供商的具體實現。

• 在線遷移會占用源地址和目的地址的資源。若您的業務比較重要，建議您對遷移任務設置限速，或在空閑時間啟動遷移任務。

• 在線遷移前會檢查源地址和目的地址的文件。如果您源地址和目的地址有相同文件名的文件，且在遷移任務中配置了覆蓋方式為覆蓋，則遷移時會直接覆蓋目的地址的文件。若兩個文件內容不同，必須更改文件名或做好備份。

遷移限制說明

• 若您遷移的源地址中設置了靜態網站托管，數據遷移時會額外掃描出實際不存在的目錄。例如，上傳文件myapp/resource/1.jpg，開啟靜態網站托管后，遷移服務掃描會得到3個對象，分別為myapp/、myapp/resource/和myapp/resource/1.jpg，其中myapp/和myapp/resource/會遷移失敗，但不影響myapp/resource/1.jpg的正常遷移。

• 若您源bucket中存在以'/'結尾的對象，在遷移該對象時，會忽略任務覆蓋方式，該對象的屬性總是會設置到目的LocalFs對應的目錄屬性中。

• 若您的源地址中有以正斜線（/）結尾的文件，遷移到目的地址后 ，會以目錄形式展示，如源端存在a/、a/b/和a/b/c/三個文件，遷移到目的地址后會展示為a/b/c/的目錄形式。

• 目前僅支持單次遷移單個Bucket數據，無法將整個賬號的數據一次性遷移。

• 不支持金融云、政務云的數據遷移。

• 遷移阿里云OSS數據至LocalFS的屬性說明如下所示：

  • 支持遷移的屬性：LastModifyTime -> ModifyTime（LocalFS）。

  • 不支持遷移的屬性（包括但不限于）：x-oss-meta-*、Content-Type，Cache-Control，Content-Encoding，Content-Disposition、Content-Language 、Expires、StorageClass、Acl、服務端加密、標簽Tagging、用戶自定義header x-oss-persistent-header等。

    說明

    不支持遷移的屬性包括但不限于以上列舉的內容，其他未列舉的屬性行為暫無法確定，以實際遷移完成的內容為準。

步驟一：選擇地域

1. 使用創建的RAM用戶登錄阿里云在線遷移服務管理控制臺。

2. 在頂部菜單欄左上角處，選擇代理所在的地域，如下圖所示。

   

   重要

   • 不同地域內的通道、代理、數據地址和遷移任務不通用，請謹慎選擇。

   • 優先選擇代理所在的地域。如果沒有代理所在地對應的地域，請盡可能選擇接近代理所在的地域創建遷移任務。

步驟二：創建通道

1. 在左側導航欄，選擇在線遷移服務>通道管理，單擊新建通道。

2. 在新建通道對話框，配置如下參數，然后單擊確定。

   參數	是否必填	說明
   名稱	是	通道的名稱。 通道名稱不能為空，最大長度為100個字符。 支持英文大小寫字母、數字和特殊字符短劃線（-）和下劃線（_）。
   帶寬上限	是	通道可以使用的帶寬上限。 不填寫：默認值為0，表示不限制帶寬。 設置該值：取值范圍請參考控制臺提示。 重要 可用帶寬取決于網絡鏈路的實際帶寬。
   請求數/秒	是	通道每秒請求數上限。 不填寫：默認值為0，表示不限制每秒請求數。 設置該值：取值范圍請參考控制臺提示。 警告 請根據數據源存儲系統的能力認真評估，過大會影響業務正常運行，建議根據控制臺提示設置。

步驟三：創建代理

1. 在左側導航欄，選擇在線遷移服務>代理管理，單擊新建代理。

2. 在新建代理對話框，配置如下參數，然后單擊確定。

   參數	是否必填	說明
   名稱	是	代理名稱。 代理名稱不能為空，長度為3~63個字符。 支持英文小寫字母、數字和特殊字符短劃線（-）和下劃線（_），且區分大小寫。 UTF-8編碼并且不能以短劃線（-）和下劃線（_）開頭。
   網絡類型	是	代理的網絡連接方式，包含如下兩種： 公網（公網）：此代理通過公網進行數據遷移。此方式要求代理機器必須可以訪問與遷移服務部署地域的在線遷移服務公網域名。例如，您當前控制臺在華北2（北京）地域，則此代理機器必須可以訪問在線遷移服務華北2（北京）地域的公網域名cn-beijing.mgw-tc.aliyuncs.com。 專線/VPN（VPC）：此代理通過專線進行數據遷移。此方式要求代理機器必須可以訪問與遷移服務部署地域的在線遷移服務內網域名。例如，您當前控制臺在華北2（北京）地域，則此代理必須可以訪問在線遷移服務華北2（北京）地域的內網域名cn-beijing.mgw-tc-internal.aliyuncs.com。建議您使用與遷移服務部署地域的ECS部署代理。
   部署方式	是	代理的部署方式。目前只支持獨立進程部署方式。
   通道	是	代理所屬的通道，一個代理只允許關聯一個通道，代理的帶寬受通道總帶寬影響。 例如：名稱為tunnel-1的通道，設置最高帶寬為10 Gbit/s，tunnel-1關聯3個代理，分別為agent-1，agent-2和agent-3，則3個代理的總帶寬之和最高為10 Gbit/s。如果agent-1設置3 Gbit/s的帶寬，則agent-2和agent-3僅有7 Gbit/s的帶寬可用，請提前規劃并謹慎分配帶寬。

3. 生成部署代理腳本。具體操作，請參見生成部署代理腳本。

步驟四：創建源地址

1. 在左側導航欄，選擇在線遷移服務>地址管理，單擊新建地址。

2. 在新建地址面板，配置如下參數，然后單擊確定。

   參數	是否必選	說明
   名稱	是	輸入源數據地址名稱。名稱命名規則如下： 名稱不能為空，長度為3~63個字符。 支持英文小寫字母、數字和特殊字符短劃線（-）和下劃線（_），且區分大小寫。 UTF-8編碼不能以短劃線（-）和下劃線（_）開頭。
   類型	是	選擇Alibaba OSS。
   區域	是	選擇源地址所在的地域，例如華東1（杭州）。
   授權角色	是	源Bucket歸屬于在線遷移控制臺賬號 遷移控制臺自動授權角色（推薦）。 遷移控制臺手動授權（備用）。 源Bucket不歸屬于在線遷移控制臺賬號 OSS控制臺授權角色。
   存儲桶（Bucket）	是	輸入當前控制臺所在賬號下待遷移數據所在的存儲桶（Bucket）名稱。
   代理	否	選擇需要使用的代理名稱。 重要 僅通過專線或VPN遷移數據上云、自建存儲數據遷移上云需要使用該參數。 指定通道下，最多可同時選擇30個代理。

步驟五：創建目的地址

1. 在左側導航欄，選擇在線遷移服務 > 地址管理，單擊新建地址。

2. 在新建地址面板，配置如下參數，然后單擊確定。

   參數	是否必選	說明
   名稱	是	輸入目的數據地址名稱。名稱命名規則如下： 名稱不能為空，長度為3~63個字符。 支持英文小寫字母、數字和特殊字符短劃線（-）和下劃線（_），且區分大小寫。 UTF-8編碼不能以短劃線（-）和下劃線（_）開頭。
   類型	是	選擇LocalFS。
   待遷移目錄	是	您可以指定數據路徑前綴將源數據遷移至指定目錄下。 請使用絕對路徑，必須以正斜線（/）開頭和結尾，不支持環境變量和特殊字符。 例如，設置源數據地址前綴為/example/src/，此路徑下有文件example.jpg，設置目的數據地址前綴為example/dest/，則遷移后文件example.jpg的完整路徑為example/dest/example.jpg。
   通道	是	選擇需要使用的通道名稱。 重要 僅通過專線或VPN遷移數據上云、自建存儲數據遷移上云需要使用該參數。 目的數據地址是LOCALFS的以及需要走專線（金融云、專有云等）的場景需要關聯代理。
   代理	是	選擇需要使用的代理名稱。 重要 僅通過專線或VPN遷移數據上云、自建存儲數據遷移上云需要使用該參數。 指定通道下，最多可同時選擇30個代理。

步驟六：創建遷移任務

1. 在左側導航欄，選擇在線遷移服務 > 遷移任務，單擊新建任務。

2. 在選擇地址頁面，配置如下參數，然后單擊下一步。

   參數	是否必選	說明
   名稱	是	輸入遷移任務名稱。名稱命名規則如下： 名稱不能為空，長度為3~63個字符。 支持英文小寫字母、數字和特殊字符短劃線（-）和下劃線（_），且區分大小寫。 UTF-8編碼不能以短劃線（-）和下劃線（_）開頭。
   源地址	是	選擇已創建的源地址。
   目的地址	是	選擇已創建的目的地址。

3. 在配置任務頁面，配置如下參數。

   參數	是否必選	說明
   遷移帶寬	否	選擇遷移帶寬。 默認：默認最大帶寬，實際速度取決于文件大小和文件數量。 指定上限：根據控制臺提示指定具體的帶寬上限。 重要 實際遷移帶寬與數據源、網絡、目的限流、文件大小等因素有關，不一定能達到指定上限。 請您評估數據源、遷移目的、業務情況、網絡帶寬等，并根據實際情況選擇合理數值，限流不恰當可能會影響業務的正常運行。
   每秒遷移文件數	否	選擇每秒遷移文件數。 默認：每秒遷移文件數。 指定上限：根據控制臺提示指定具體的每秒遷移文件數。 重要 實際遷移帶寬與數據源、網絡、目的限流、文件大小等因素有關，不一定能達到指定上限。 請您評估數據源、遷移目的、業務情況、網絡帶寬等，并根據實際情況選擇合理數值，限流不當可能會影響業務的正常運行。
   覆蓋方式	否	選擇同名文件的覆蓋方式。 不覆蓋：不遷移該文件。 全部覆蓋：源地址中的文件會覆蓋目的地址中的文件。 根據最后修改時間覆蓋： 當源地址中的文件最后修改時間晚于目的地址中的文件最后修改時間時，目的地址中的文件會被覆蓋。 當源地址中的文件最后修改時間與目的地址中的文件最后修改時間相同時，若二者的Size和Content-Type有一項不同，則目的地址中的文件會被覆蓋。 警告 根據最后修改時間覆蓋無法嚴格保證一定不會覆蓋更新的文件，存在舊文件覆蓋新文件的風險。 若您選擇根據最后修改時間覆蓋的覆蓋方式，請務必確保源端文件能返回最后修改時間、Size、Content-Type等信息，否則覆蓋策略可能失效，產生非預期的遷移結果。 選擇不覆蓋或根據最后修改時間覆蓋時，為執行后續覆蓋判斷，會分別請求源端和目的端meta信息一次，因此會在源端和目的端產生對應的請求費用。
   遷移報告	是	遷移報告推送方式。 不推送（默認）：不推送遷移報告至目的LocalFS。 推送：將遷移報告推送至目的LocalFS，詳細路徑請參考后續操作。 重要 遷移報告推送會占用目的端一定的存儲空間。 遷移報告的推送存在一定的時間延時，請您耐心等待遷移報告的生成。 每個任務執行記錄都有一個唯一的ID，請注意，遷移報告只會推送一次，請謹慎刪除！
   遷移日志	是	遷移日志推送方式。 不推送（默認）：不推送遷移日志。 推送：將遷移日志推送至日志服務SLS，可在SLS上查看遷移日志。 僅推送文件錯誤日志：僅將錯誤遷移日志推送至日志服務SLS，可在SLS上查看錯誤遷移日志。 當選擇推送或僅推送文件錯誤日志時，在線遷移服務會在日志服務SLS中創建名稱為aliyun-oss-import-log-阿里云賬號ID-當前遷移服務部署地域的Project，例如aliyun-oss-import-log-137918634953****-cn-hangzhou。 重要 請務必完成以下操作后，再選擇推送或僅推送文件錯誤日志，否則可能會導致遷移任務異常。 已開通SLS服務。 已在日志服務授權項授權頁面中同意授權。
   日志服務授權	否	當遷移日志選擇推送或僅推送文件錯誤日志時出現該選項。 單擊授權進入云資源訪問授權頁面，頁面會對應創建AliyunOSSImportSlsAuditRole角色，并對角色做授權，請單擊同意授權完成授權。
   文件名	否	文件名過濾器。 支持包含和排除兩種過濾規則，請參見RE2庫的正則表達式語法（僅支持部分表達式語法）。例如： .*\.jpg$表示以.jpg結尾的所有文件。 ^file.*默認表示根目錄下以file開頭的所有文件。 如果源數據地址設置了前綴，例如源數據地址前綴為data/to/oss/，則需要使用^data/to/oss/file.*來匹配指定前綴下以file開頭的所有文件。 .*/picture/.*表示匹配某一級為picture的子目錄。 重要 當過濾規則為包含時，符合規則的文件都會被遷移，如果有多條規則，符合任意一個條件的文件都會被遷移。 例如2個文件picture.jpg和picture.png，設置一條包含規則過濾.*\.jpg$，此時只會遷移picture.jpg文件，如果同時也設置了包含規則過濾.*\.png$，則2個文件都會被遷移。 當過濾規則為排除時，符合規則的文件都不會被遷移，如果有多條規則，符合任意一個條件的文件都不會被遷移。 例如2個文件picture.jpg和picture.png，設置一條排除規則過濾.*\.jpg$，此時只會遷移picture.png，如果同時也設置了排除規則過濾.*\.png$，則2個文件都不會被遷移。 排除規則優先。當一個文件既在排除規則中又在包含規則中，則文件不會被遷移。 例如文件file.txt，設置排除規則過濾.*\.txt$文件，并同時設置包含規則過濾file.*，則此時file.txt文件不會被遷移。
   文件修改時間	否	文件最后一次修改時間過濾器。 可指定文件最后一次修改時間作為過濾規則。如果指定了時間范圍，則只遷移文件最后一次修改時間在指定時間范圍內的文件，具體規則如下。 當僅指定開始時間為2019年01月01日，不指定結束時間時，則只遷移文件最后一次修改時間晚于等于2019年01月01日的文件。 當僅指定結束時間為2022年01月01日，不指定開始時間時，則只遷移文件最后一次修改時間早于等于2022年01月01日的文件。 當指定開始時間為2019年01月01日，結束時間為2022年01月01日，則遷移文件最后一次修改時間范圍在晚于等于2019年01月01日，且早于等于2022年01月01日的文件。
   是否遷移	否	是否遷移特殊類型的實體。勾選表示啟用遷移，不勾選表示禁用。 軟鏈接： 啟用時，源地址中所有的Symlink對象也會被加入待遷移隊列，同時會被統計到遷移任務的【文件數】、【存儲量】字段。會在目的地址中創建對應的軟鏈接文件，并將源Symlink對象的UserMeta中（支持遷移）的屬性設置到軟鏈接文件的屬性中，軟鏈接文件的Target屬性值取決于【是否轉換Target】選項。 禁用時，源地址中所有的Symlink對象將會被忽略，不會被統計到遷移任務的【文件數】、【存儲量】字段。 重要 任何情況下，都不會額外遷移源地址中Symlink對象所指向的目標對象（除非該目標對象也在本次遷移范圍內）。
   是否轉換Target	否	對源地址中軟鏈接文件的Target屬性進行轉換，以盡可能使遷移后的軟鏈接文件仍可正常指向其目標文件。勾選表示啟用轉換，不勾選表示禁用轉換。 重要 此選項僅在啟用遷移軟鏈接時才生效。 無論是否轉換Target，遷移總是不會檢查目標文件是否存在、目標文件類型是否合法以及目標文件是否有訪問權限等。 啟用時，執行字符串替換操作，將源軟鏈接的Target屬性中的SrcPrefix（若匹配）替換成DestPrefix，并將替換后的結果值設置到目的軟鏈接文件的Target屬性上。 說明 示例：假設遷移任務配置的SrcPrefix="cloud_base/"，DestPrefix="/mnt/nas1/"，cloud_base/links/a.lnk是源地址下的一個Symlink對象，假設其Target屬性： 為"cloud_base/data/a.txt"。則替換后的最終Target結果值為"/mnt/nas1/data/a.txt"。 為"cloud_outer/data/a.txt"。則替換未能匹配，最終Target結果值仍為"cloud_outer/data/a.txt"。 禁用時：不轉換，將源軟鏈接的Target屬性原始值設置到目的軟鏈接文件的Target屬性上。
   執行時間	否	重要 正在遷移中的任務，在下一個指定時間前仍未結束本輪遷移，則會在本輪遷移結束后，自動順延至下一個指定時間啟動任務，直至完成指定次數的遷移。 遷移任務并發數量限制：遷移服務部署地域選擇中國香港或中國內地時最多支持10個任務并發，選擇海外地域時最多支持5個，超出限制后可能導致定時任務調度無法按預期執行。 確定遷移任務的執行時間。 立即執行：立即執行當前任務。 指定執行時間：指定任務執行期間每天的執行時間段。默認情況下，任務將在指定的起始時間啟動，在指定的停止時間暫停。 周期調度：通過調整執行頻率和執行次數來啟動任務。 執行頻率：支持以每小時、每天、每周、一周中某些天、自定義等5種頻率，具體請查看執行頻率參考。 執行次數：指定任務的執行次數，如不設置則默認執行一次，最大執行次數請參考控制臺提示。 重要 可隨時手動啟動和暫停任務，不受自定義執行時間的影響。

4. 閱讀在線遷移服務協議，選中我已理解并確認，合規承諾聲明且當遷移任務完成時，我有確認遷移數據一致性的義務和責任，然后單擊下一步。

5. 檢查配置信息，確認無誤后，單擊確定，等待遷移任務執行。

執行頻率參考

步驟七：校驗數據