摘要：介紹因產(chǎn)品升級(jí)，將暫停維護(hù)。只能依賴于工具進(jìn)行相關(guān)操作。下載存檔下載一個(gè)激活的存檔，必須指定。請(qǐng)注意，在當(dāng)前版本參數(shù)不能省略，這是一個(gè)，我們將在稍后的版本修正它刪除存檔刪除一個(gè)存檔必須指定。

介紹(Introduction)

因產(chǎn)品升級(jí)，UArchive 將暫停維護(hù)。
請(qǐng)使用 US3 對(duì)象存儲(chǔ)歸檔類型，以獲取更優(yōu)惠更可靠的歸檔存儲(chǔ)服務(wù)：US3 產(chǎn)品價(jià)格

UArchive是UCLOUD公司的歸檔存儲(chǔ)產(chǎn)品，你可以把本地的任意文件，壓縮包，或者文件夾上傳到Uarchive。
稍后在您需要時(shí)可以從Uarchive下載指定的文件。Uarchive和Ufile不同，它無(wú)法在UCLOUD官方控制臺(tái)上進(jìn)行文件的上傳，下載動(dòng)作。
只能依賴于uarchivemgr工具進(jìn)行相關(guān)操作。你可以從下面這個(gè)地址獲取這個(gè)工具。

Linux 64位操作系統(tǒng)請(qǐng)下載

http://tools.ufile.ucloud.cn/uarchivemgr-linux64.tar.gz

Windows 32位操作系統(tǒng)請(qǐng)下載

http://tools.ufile.ucloud.cn/uarchivemgr-win32.tar.gz

Windows 64位操作系統(tǒng)請(qǐng)下載

http://tools.ufile.ucloud.cn/uarchivemgr-win64.tar.gz

MacOS 操作系統(tǒng)請(qǐng)下載

http://tools.ufile.ucloud.cn/uarchivemgr-mac.tar

# 名詞定義(Definition) 這里我們將介紹一些名詞，稍后在使用uarchivemgr工具的過(guò)程中，您將會(huì)看到他們。
工具中將只顯示英文，為了方便您的理解，我們特別將關(guān)鍵詞都以中文對(duì)照以及解釋的方式列在下面這里，方便參考。

# 工具配置(Configuration)
下載工具并解壓縮之后，您需要編輯config.cfg文件并指定正確的公鑰(PublicKey)和私鑰(PrivateKey)。如果您不知道什么是公鑰和私鑰，請(qǐng)聯(lián)系技術(shù)支持。

# 工作流程(Workflow)

開(kāi)始(Start) ---> 創(chuàng)建倉(cāng)庫(kù)(Create Vault)
                        |--> 上傳文件或目錄存檔(Put File or Dir to Uarchive)
                        |
                        |--> 獲取存檔列表(Get Archive List)
                        |
                        |--> 激活存檔(Activate Archive)
                                      |---> 下載存檔(Download Archive)
                        |--> 刪除存檔(Delete Archive)

結(jié)束(End) ---> 刪除倉(cāng)庫(kù)(Delete Vault)

# 選項(xiàng)和示例(Options and Examples)
基本的工具選項(xiàng)將被列在下面，當(dāng)您理解了這些選項(xiàng)之后，可以通過(guò)幫助(Help)來(lái)獲取高級(jí)選項(xiàng)信息。

# 獲取工具版本(Version)

./uarchivemgr-linux64 version

# 倉(cāng)庫(kù)管理(Vault Management)

# 創(chuàng)建一個(gè)倉(cāng)庫(kù)(Vault) 必須要指定--vault 其后是該倉(cāng)庫(kù)的名稱 這個(gè)名稱在后面操作會(huì)被作為參數(shù)傳遞給這個(gè)工具
./uarchivemgr-linux64 CreateVault --vault test-u2

# 刪除一個(gè)倉(cāng)庫(kù)(Vault) 必須要指定--vault 當(dāng)您不再需要這個(gè)倉(cāng)庫(kù)時(shí) 可以使用下面這行命令來(lái)執(zhí)行刪除 現(xiàn)在先跳過(guò)這個(gè)命令
# ./uarchivemgr-linux64 DeleteVault --vault test-u2

# 獲取倉(cāng)庫(kù)(Vault)信息 可以選擇指定--vault或不指定，如果指定，則顯示某一個(gè)倉(cāng)庫(kù)(Vault)的信息，如果不指定，則顯示全部。只會(huì)顯示用戶自己的倉(cāng)庫(kù)(Vault)信息。備注: 當(dāng)前版本 指定倉(cāng)庫(kù)(--vault)選項(xiàng)無(wú)法正常工作
./uarchivemgr-linux64 DescribeVault [--vault test-u2]

# 上傳存檔(PutArchive)

# 上傳一個(gè)文件(File)，必須要指定--vault --file --archive三個(gè)參數(shù)，其中--file后面是一個(gè)合法的本地文件路徑，--archive后面是您指定的存檔名稱，這個(gè)參數(shù)在當(dāng)前版本的工具中不可以省略，您可以將它指定為文件的名字
./uarchivemgr-linux64 PutArchive --vault test-u2 --file /root/config.cfg --archive config.cfg

# 上傳一個(gè)文件夾(Dir) 必須指定--vault --dir兩個(gè)參數(shù) 多余的參數(shù)將會(huì)被忽略. 其中--dir后面是一個(gè)合法的本地文件夾的地址 該文件夾下所有的文件(File)會(huì)被上傳到歸檔存儲(chǔ) 請(qǐng)參考--trimpath的說(shuō)明來(lái)獲取更多信息
./uarchivemgr-linux64 PutArchive --vault test-u2 --dir /home/marvin/uarchive-test

# 獲取存檔列表(GetArchiveList)

使用這個(gè)功能，您可以獲取一個(gè)倉(cāng)庫(kù)的存檔列表。也就是您上傳的文件的列表，如果一個(gè)文件的多個(gè)版本在上傳的時(shí)候指定了不同的存檔名稱，那么您將看到它們。
# test-u2是一個(gè)合法且存在的倉(cāng)庫(kù)(Vault)名稱，您需要將它替換為您自己的倉(cāng)庫(kù)名稱，在后續(xù)的所有例子中，都會(huì)使用"test-u2"作為測(cè)試倉(cāng)庫(kù)。必須指定--vault選項(xiàng)，該選項(xiàng)后面是倉(cāng)庫(kù)的名稱，下面的例子里面也會(huì)使用這個(gè)參數(shù)將不再多帶帶解釋
./uarchivemgr-linux64 GetArchiveList --vault test-u2
# 這個(gè)命令會(huì)輸出下面這樣的一個(gè)輸出， 其中Key的值是后面激活存檔(ActivateArchive)功能需要的參數(shù)
{
        VaultName:    test-u2
        Key:          config.cfg
        Hash:         AQAAALYX2XqoLlhkvFiBes1z04GAXbT0
        MimeType:     application/octet-stream
        Size:         278
        Created:      1556435482
        Modified:     1556435482
}

# 激活存檔(ActivateArchive)

# 激活一個(gè)存檔(Archive)，必須指定--vault和--archive，其中--archive后面指定存檔(Archive)的Key 這個(gè)Key可以在GetArchiveList的返回列表中看到。
./uarchivemgr-linux64 ActivateArchive --vault test-u2 --archive config.cfg

# 下載存檔(DownloadArchive)

# 下載一個(gè)激活的存檔(Archive)，必須指定--vault --archive --saveas。其中--archive后面指定一個(gè)已經(jīng)被激活的存檔的Key，和上面一條命令中輸入的參數(shù)相同；--saveas參數(shù)后面指定您期望將這個(gè)存檔保存到本地的文件路徑。請(qǐng)確定您輸入的文件路徑在本地不存在，如果是本地已存在的文件，這個(gè)文件將會(huì)被覆蓋
./uarchivemgr-linux64 DownloadArchive --vault test-u2 --archive config.cfg --saveas ./config.cfg.bk
# 如果您不是想下載這個(gè)存檔(Archive)，而只想獲得這個(gè)存檔(Archive)的URL，您可以使用如下命令，會(huì)顯示它的URL，文件并不會(huì)被下載。請(qǐng)注意，在當(dāng)前版本--saveas參數(shù)不能省略，這是一個(gè)BUG，我們將在稍后的版本修正它
./uarchivemgr-linux64 DownloadArchive --vault test-u2 --archive config.cfg --saveas ./config.cfg --showurl

# 刪除存檔(DownloadArchive)

# 刪除一個(gè)存檔(Archive) 必須指定--vault --archive。
./uarchivemgr-linux64 DeleteArchive --vault test-u2 --archive config.cfg

#同步文件夾(Sync)

# 同步一個(gè)文件夾下的所有內(nèi)容到服務(wù)器端，必須指定--vault和--dir，其中--dir后面指定一個(gè)本地的文件夾路徑，可以是相對(duì)路徑也可以是絕對(duì)路徑。另外，由于在同步文件夾過(guò)程中，無(wú)法為每一個(gè)文件指定對(duì)應(yīng)的存檔名稱(Archive Key)，工具會(huì)默認(rèn)為文件夾中的每一個(gè)文件使用該文件的絕對(duì)路徑作為對(duì)應(yīng)的存檔名稱(Archive Key)
./uarchivemgr-linux64 Sync --vault test-u2 --dir /root/testdir/
# 執(zhí)行該命令之后得到的列表是下面這個(gè)樣子，其中每個(gè)存檔(Archive)的Key都是該文件在本地的絕對(duì)路徑。注意: 服務(wù)端只使用這個(gè)路徑字符串作為標(biāo)識(shí)符，并不會(huì)真的用這個(gè)路徑來(lái)保存存檔(Archive)。
{
        VaultName:    test-u2
        Key:          /home/marvin/uarchieve/uarchivemgr_linux64.elf/config.cfg
        Hash:         AQAAALYX2XqoLlhkvFiBes1z04GAXbT0
        MimeType:     application/octet-stream
        Size:         278
        Created:      1556440367
        Modified:     1556440367
}

{
        VaultName:    test-u2
        Key:          /home/marvin/uarchieve/uarchivemgr_linux64.elf/uarchivemgr-linux64
        Hash:         AwAAAEBBQhnkmBulZ0iKMnslstJQ-qat
        MimeType:     application/octet-stream
        Size:         9456469
        Created:      1556440370
        Modified:     1556440370
}

# 電子簽名(ETag)

# 這個(gè)功能用來(lái)計(jì)算本地文件的電子簽名(ETag)，通過(guò)對(duì)比GetArchiveList中得到的已上傳存檔的電子簽名(ETag)，可以方便的知道文件上傳過(guò)程中有沒(méi)有出錯(cuò)。必須指定--file選項(xiàng)，其后為本地文件路徑
./uarchivemgr-linux64 ETag --file ./config.cfg

# 獲得幫助(Help)

# 對(duì)于所有的命令，您都可以使用help來(lái)獲取對(duì)應(yīng)的幫助信息，目前只支持英文版本
./uarchivemgr-linux64 version --help
./uarchivemgr-linux64 GetArchiveList --help
./uarchivemgr-linux64 DeleteVault --help
./uarchivemgr-linux64 DescribeVault --help
./uarchivemgr-linux64 CreateVault --help
./uarchivemgr-linux64 DeleteArchive --help
./uarchivemgr-linux64 ActivateArchive --help
./uarchivemgr-linux64 DownloadArchive --help
./uarchivemgr-linux64 MDownloadArchive --help
./uarchivemgr-linux64 PutArchive --help
./uarchivemgr-linux64 MputArchive --help
./uarchivemgr-linux64 Sync --help
./uarchivemgr-linux64 ETag --help

# 高級(jí)功能(Advanced Function)

# 在使用Put或Sync功能上傳文件夾時(shí)，可以通過(guò)指定--prefix來(lái)指定文件前綴，只有文件的前綴與該選項(xiàng)所指定的前綴相同的文件會(huì)被上傳。例如下面的命令，會(huì)上傳/home/marvin/uarchive-test文件夾下所有前綴為demo的文件
./uarchivemgr-linux64 PutArchive --vault test-u2 --dir /home/marvin/uarchive-test --prefix demo

# 在使用Put或Sync功能上傳文件夾時(shí)，可以使用--followsym選項(xiàng)來(lái)上傳符號(hào)鏈接(Symbol link)所指向的文件，而不是符號(hào)鏈接本身
./uarchivemgr-linux64 PutArchive --vault test-u2 --dir /home/marvin/uarchive-test --followsym

# 在使用Put或Sync功能上傳文件夾時(shí)，默認(rèn)會(huì)使用文件的全路徑作為存檔名(Archive Key)，可以使用--trimpath來(lái)修改這個(gè)行為。如果附帶了--trimpath這個(gè)選項(xiàng)，那么將會(huì)使用文件的名字(File Name)而不是全路徑(Full Path)作為存檔名(Archive Key)
./uarchivemgr-linux64 PutArchive --vault test-u2 --dir /home/marvin/uarchive-test --trimpath

# 更多其他功能請(qǐng)參考幫助(Help)

實(shí)施文檔歡迎https://docs.ucloud.cn/uarchive/quick