共用方式為


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-tierstring 使用這個 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 網域。 使用分號分隔多個專案。

另請參閱