您可以使用 AzCopy 來變更一或多個 Blob 的 存取層 ,並取代 (覆寫) 一或多個 Blob 的中繼資料和索引標籤。
開始
請參閱開始使用 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 設定為 standard 或 high。 根據預設,此參數設定為 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 標籤許可權的共用存取簽章 (tSAS 許可權) 的任何人都可以設定 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
下一步
如需更多範例,請參閱以下文章:
請參閱下列文章,以進行設定、將效能最佳化,以及針對問題進行疑難排解: