以 AzCopy v10 取代 Blob 屬性和中繼資料 (預覽)

您可以使用 AzCopy 來變更一或多個 Blob 的存取層,並取代 (覆寫) 中繼資料,以及一或多個 Blob 的索引標籤。

重要

這項功能目前為預覽狀態。 請參閱 Microsoft Azure 預覽版增補使用規定,以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版,或尚未正式發行的版本) 的法律條款。

開始使用

請參閱開始使用 AzCopy (部分機器翻譯) 一文來下載 AzCopy,並了解如何提供授權認證給儲存體服務。

注意

本文中的範例假設您已使用 Microsoft Entra ID 提供授權認證。

如果您想改為使用 SAS 權杖來授權存取 Blob 資料,則可將該權杖附加至每個 AzCopy 命令中的資源 URL。 例如: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'

變更存取層

若要變更 Blob 的存取層,請使用 azcopy set-properties 命令,並將 -block-blob-tier 參數設定為存取層的名稱。

提示

此範例會以單引號 ('') 括住路徑引數。 除了 Windows 命令殼層 (cmd.exe) 以外,在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe),請使用雙引號 ("") 括住路徑引數,而非單引號 ('')。

語法

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot

若要變更虛擬目錄中所有 Blob 的存取層,請參閱虛擬目錄名稱,而不是 Blob 名稱,然後將 --recursive=true 附加至命令。

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true

若要將 Blob 從封存層解除凍結至線上層,請將 --rehydrate-priority 設定為 standardhigh。 根據預設,此參數設定為 standard。 若要深入了解每個選項的取捨,請參閱解除凍結優先順序

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high

取代中繼資料

若要取代 Blob 的中繼資料,請使用 azcopy set-properties 命令,並將 --metadata 參數設定為一或多個索引鍵/值組。

提示

此範例會以單引號 ('') 括住路徑引數。 除了 Windows 命令殼層 (cmd.exe) 以外,在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe),請使用雙引號 ("") 括住路徑引數,而非單引號 ('')。

語法

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2

若要取代虛擬目錄中所有 Blob 的中繼資料,請參閱虛擬目錄名稱,而不是 Blob 名稱,然後將 --recursive=true 附加至命令。

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true

若要清除中繼資料,請省略標記並附加 --metadata=clear 至命令結尾。

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear

取代索引標籤

若要取代 Blob 的索引標記,請使用 azcopy set-properties 命令,並將 --blob-tags 參數設定為一或多個索引鍵/值組。 儲存體 Blob 資料擁有者,以及具有共用存取簽章且擁有存取 Blob 標籤權限 (t SAS 權限) 的任何人都可以設定 Blob 索引標籤。 此外,具有 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write 權限的 RBAC 使用者也可以執行這項作業。

提示

此範例會以單引號 ('') 括住路徑引數。 除了 Windows 命令殼層 (cmd.exe) 以外,在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe),請使用雙引號 ("") 括住路徑引數,而非單引號 ('')。

語法

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

若要取代虛擬目錄中所有 Blob 的索引標記,請參閱虛擬目錄名稱,而不是 Blob 名稱,然後將 --recursive=true 附加至命令。

範例

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

下一步

如需更多範例,請參閱以下文章:

請參閱下列文章,以進行設定、將效能最佳化,以及針對問題進行疑難排解: