azcopy 移除
從 Azure 儲存體帳戶中刪除 Blob 或檔案。
概要
azcopy remove [resourceURL] [flags]
相關概念性文章
範例
使用 SAS 令牌移除單一 Blob:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
使用 SAS 令牌移除整個虛擬目錄:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
只移除虛擬目錄內的 Blob,但不要移除這些子目錄中的任何子目錄或 Blob:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false
移除虛擬目錄中的 Blob 子集(例如:只移除 jpg 和 pdf 檔案,或 Blob 名稱為 “exactName”):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"
移除整個虛擬目錄,但從範圍中排除特定 Blob(例如:以 foo 開頭或以列結尾的每個 Blob):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"
從 Azure 儲存體 移除 Blob 的指定版本識別碼。 請確定來源是有效的 Blob,它會 versionidsfile
採用檔案的路徑,其中每個版本都會寫入個別行。 所有指定的版本都會從 Azure 儲存體 中移除。
azcopy rm "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/path/to/dir/[versionidsfile]"
使用 --list-of-files
旗標將特定 Blob 和虛擬目錄的相對路徑 (NOT URL 編碼) 放在文字檔中,list.txt
以移除特定 Blob 和虛擬目錄。 在文本檔中,每個 Blob 和虛擬目錄都會寫入個別行。 由於擷取物件屬性的額外交易,旗 --list-of-files
標可能會產生效能成本。 如需 AzCopy 使用和預估成本之 API 的詳細資訊,請參閱 估計使用 AzCopy 傳輸 Blob 的成本。
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/parent/dir]" --recursive=true --list-of-files=/usr/bar/list.txt
從具有階層命名空間的 Blob 儲存體 帳戶中移除單一檔案(不支援包含/排除):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
從具有階層命名空間的 Blob 儲存體 帳戶中移除單一目錄(不支援包含/排除):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
選項。
--cpk-by-name
(字串)依名稱提供的用戶端金鑰可讓客戶端針對 Azure Blob 儲存體 選項提出要求,以根據每個要求提供加密密鑰。 提供的密鑰名稱會從 Azure 金鑰保存庫 擷取,並用來加密數據。
--cpk-by-value
False 預設為 False。 依名稱提供的用戶端金鑰可讓客戶端針對 Azure Blob 儲存體 選項提出要求,以根據每個要求提供加密密鑰。 提供的密鑰及其哈希將會從環境變數 CPK_ENCRYPTION_KEY
和 CPK_ENCRYPTION_KEY_SHA256
擷取。
--delete-snapshots
(字串)根據預設,如果 Blob 有快照集,刪除作業就會失敗。 指定 'include' 以移除根 Blob 及其所有快照集;或者指定 『only』 只移除快照集,但保留根 Blob。
--dry-run
False 預設為 False。 列印命令將移除的路徑檔案。 此旗標不會觸發檔案的移除。
--exclude-path
(字串)拿掉時排除這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如:myFolder;myFolder/subDirName/file.pdf
--exclude-pattern
(字串)排除名稱符合模式清單的檔案。 例如: .jpg;。Pdf;exactName
--force-if-read-only
False 預設為 False。 刪除 Azure 檔案儲存體 檔案或資料夾時,即使現有物件已設定只讀屬性,仍強制刪除作業
--from-to
(字串)選擇性地指定來源目的地組合。 例如:BlobTrash、FileTrash、BlobFSTrash
-h
, --help
移除的說明
--include-after
(字串)只包含在指定日期和時間之後修改的檔案。 此值的格式應為 ISO8601。 如果未指定時區,則會假設值位於執行 AzCopy 之計算機的當地時區(例如:'2020-08-19T15:04:00Z',或當地時區的 '2020-08-08-19' 或 '2020-08-19'。 自 AzCopy 10.5 起,此旗標僅適用於檔案,不適用於資料夾,因此當搭配 --preserve-smb-info
或 --preserve-smb-permission
s 使用此旗標時,將不會複製資料夾屬性。
--include-before
(字串)只包含在指定日期和時間之前或修改過的檔案。 此值的格式應為 ISO8601。 如果未指定時區,則會假設值位於執行 AzCopy 之計算機的當地時區(例如:'2020-08-19T15:04:00Z',或當地時區的 '2020-08-08-19' 或 '2020-08-19'。 自 AzCopy 10.7 起,此旗標僅適用於檔案,不適用於資料夾,因此在搭配 --preserve-smb-info
或 --preserve-smb-permissions
使用此旗標時,不會複製資料夾屬性。
--include-path
(字串)拿掉時只包含這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如:myFolder;myFolder/subDirName/file.pdf
--include-pattern
(字串)只包含名稱符合模式清單的檔案。 例如: .jpg;。Pdf;exactName
--list-of-files
(字串)定義文字檔的位置,其中包含要刪除的檔案和目錄清單。 相對路徑應該以換行符分隔,而且路徑不應該以URL編碼。
--list-of-versions
(字串)指定文字檔,其中每個版本標識碼都會列在不同的行上。 請確定來源必須指向單一 Blob,而且使用此旗標在檔案中指定的所有版本識別碼都必須屬於來源 Blob。 指定的 Blob 版本識別碼將會從 Azure 儲存體 中刪除。
--permanent-delete
(字串)這是永久刪除虛刪除快照集/版本的預覽功能。 可能的值包括 'snapshots'、'versions'、'snapshotsandversions'、'none'。 (預設值 “none”)
--trailing-dot
默認啟用以安全的方式處理檔案共享相關作業。 可用選項: Enable
、 Disable
。 選擇 Disable
回到舊版 (可能不安全) 處理尾端點檔案,其中檔案服務會修剪路徑中的任何尾端點。 如果傳輸只包含尾端點不同的兩個路徑,這可能會導致數據損毀(例如 mypath
和 mypath.
)。 如果此旗標設定為 Disable
,且 AzCopy 遇到尾端的點檔案,則會警告掃描記錄中的客戶,但不會嘗試中止作業。 如果目的地不支援尾端點檔案(Windows 或 Blob 儲存體),如果尾端點檔案是傳輸的根目錄,且略過列舉期間遇到的任何尾端點路徑,AzCopy 將會失敗。
--recursive
False 預設為 False。 在目錄之間同步處理時,以遞歸方式查看子目錄。
繼承自父命令的選項
--cap-mbps float
以每秒 MB 為單位來限制傳輸速率。 暫時輸送量可能會與上限稍有不同。 如果此選項設定為零,或省略此選項,則不會限制輸送量。
--output-type
(字串)命令輸出的格式。 選項包括:text、json。 預設值為 『text』。 (預設 “text”)
--trusted-microsoft-suffixes
(字串)指定可以傳送 Microsoft Entra 登入令牌的其他網域後綴。 預設值為 『.core.windows.net;。core.chinacloudapi.cn;。core.cloudapi.de;。core.usgovcloudapi.net;*.storage.azure.net'。 此處所列的任何專案會新增至預設值。 基於安全性,您應該只在這裡放置 Microsoft Azure 網域。 使用分號分隔多個專案。
--log-level
(字串)定義記錄檔的記錄詳細資訊。 可用的層級包括:INFO(所有要求/回應)、WARNING(回應緩慢)、ERROR(僅失敗的要求),以及 NONE(沒有輸出記錄)。 (預設 'INFO')(預設“INFO”)