azcopy 設定屬性
指定位置時,請變更該記憶體的所有有效系統屬性(Blob 或檔案)。
概要
azcopy set-properties [resourceURL] [flags]
設定 Blob 和檔案記憶體的屬性。 此指令目前支援的屬性如下:
- Blob -> 階層、元數據、標記
- Data Lake 儲存體 Gen2 -> 層、元數據、標記
- 檔案 -> 元數據
注意
Data Lake 儲存體 Gen2 端點將會由 Blob 儲存體 端點取代。
如需詳細資訊,請參閱範例。
相關概念性文章
範例
將 Blob 層變更為經常性存取:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
將 Blob 層變更為非經常性:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold
將 Blob 層從經常性存取變更為封存:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive
將 Blob 層從封存變更為非經常性存取,並將優先順序設定為高:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
將 Blob 層從非經常性存取變更為經常性存取,並將優先順序設定為標準:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard
將目錄中所有檔案的階層變更為封存:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
變更分頁 Blob 的階層:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]
將 Blob 的元數據變更為 {key = “abc”, val = “def”} 和 {key = “ghi”, val = “jkl”}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
將目錄中所有檔案的元數據變更為 {key = “abc”, val = “def”} 和 {key = “ghi”, val = “jkl”}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true
清除 Blob 的所有現有元資料:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
清除所有檔案中的所有現有元資料:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --metadata=clear
將 Blob 的 Blob 標記變更為 {key = “abc”, val = “def”} 和 {key = “ghi”, val = “jkl”}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
在 Blob 上設定標籤時,SAS 還有其他許可權(不適用於標籤)。 如果沒有這些標籤,服務會傳回授權錯誤。
清除 Blob 的所有現有 Blob 標記:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
在 Blob 上設定標籤時,SAS 還有其他許可權(不適用於標籤)。 如果沒有這些標籤,服務會傳回授權錯誤。
選項。
--blob-tags
string 設定 Blob 上的標記以分類記憶體帳戶中的數據(以 '&'分隔)
--block-blob-tier
string 將 Blob 的存取層變更為指定的層(預設為 “None”)
--dry-run
列印受到此命令影響的檔案路徑。 此旗標不會影響實際檔案。
--exclude-path
string 移除時排除這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如:myFolder;myFolder/subDirName/file.pdf
--exclude-pattern
string 排除名稱符合模式清單的檔案。 例如: .jpg;。Pdf;exactName
--from-to
string 選擇性地指定來源目的地組合。 有效值:BlobNone、FileNone、BlobFSNone
-h
、 --help
set-properties 的說明
--include-path
string 在設定屬性時只包含這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如:myFolder;myFolder/subDirName/file.pdf
--include-pattern
string 僅包含名稱符合模式清單的檔案。 例如: .jpg;。Pdf;exactName
--list-of-files
string 定義要複製之檔案清單的文字檔位置。
--metadata
string 使用這些索引鍵/值組(以 ';' 分隔)設定指定的位置作為元數據。
--page-blob-tier
string 使用這個 Blob 層將分頁 Blob 上傳至 Azure 儲存體。 (預設為 'None')。 (預設值“None”)
--recursive
從本機文件系統上傳時,以遞歸方式查看子目錄。
--rehydrate-priority
string 選擇性旗標,設定解除凍結的解除凍結優先順序。 有效值:標準、高。 預設值 - 標準 (預設 “Standard”)
繼承自父命令的選項
--cap-mbps float
以每秒 MB 為單位來限制傳輸速率。 暫時輸送量可能會與上限稍有不同。 如果此選項設定為零,或省略此選項,則不會限制輸送量。
--log-level
(字串)定義記錄檔的記錄詳細資訊、可用的層級:INFO(所有要求/回應)、WARNING(慢速回應)、ERROR(僅失敗的要求),以及 NONE(沒有輸出記錄)。 (預設為 'INFO')。 (預設“INFO”)
--output-type
(字串)命令輸出的格式。 選項包括:text、json。 預設值為 『text』。 (預設 “text”)
--output-level
(字串)定義輸出詳細資訊。 可用的層級:基本、無訊息。 (預設值 “default”)
--trusted-microsoft-suffixes
(字串)指定其他網域後綴,其中可能會傳送 Microsoft Entra ID 登入令牌。 預設值為 『.core.windows.net;。core.chinacloudapi.cn;。core.cloudapi.de;。core.usgovcloudapi.net;*.storage.azure.net'。 此處所列的任何專案會新增至預設值。 基於安全性,您應該只在這裡放置 Microsoft Azure 網域。 使用分號分隔多個專案。