你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
azcopy remove
从 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 文件,或者删除名为“exactName”的 blob):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"
删除整个虚拟目录,但从范围中排除某些 blob(例如:以 foo 开头或以 bar 结尾的每个 blob):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"
从 Azure 存储 中删除 blob 的指定版本 ID。 确保源是有效的 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 和虚拟目录(非 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 存储帐户中删除单个文件(不支持 include/exclude):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
从采用分层命名空间的 Blob 存储帐户中删除单个目录(不支持 include/exclude):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
选项
--cpk-by-name
(字符串)客户端按名称提供的密钥允许客户端发出针对Azure Blob 存储请求的选项,以按请求提供加密密钥。 提供的密钥名称将从 Azure 密钥保管库提取,并用于对数据进行加密。
--cpk-by-value
- 默认值为 false。 客户端按名称提供的密钥允许客户端发出针对Azure Blob 存储请求的选项,以按请求提供加密密钥。 提供的密钥及其哈希将从环境变量CPK_ENCRYPTION_KEY
中提取,CPK_ENCRYPTION_KEY_SHA256
--delete-snapshots
(字符串)如果 blob 有快照,删除操作默认将失败。 可指定“include”以删除根 blob 及其所有快照;也可指定“only”以仅删除快照,但保留根 blob。
--dry-run
- 默认值为 false。 打印命令将删除的路径文件。 此标志不会触发文件的删除。
--exclude-path
(字符串)删除时排除这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀。 例如:myFolder;myFolder/subDirName/file.pdf
--exclude-pattern
(字符串)排除名称与模式列表相匹配的文件。 例如: .jpg; .pdf;exactName
--force-if-read-only
- 默认值为 false。 删除Azure 文件存储文件或文件夹时,即使现有对象设置了只读属性,也强制删除工作
--from-to
(字符串)(可选)指定源-目标组合。 例如:BlobTrash、FileTrash、BlobFSTrash
-h
, --help
有关删除的帮助
--include-after
(字符串)仅包含在给定日期和时间之后修改的文件。 该值应为 ISO8601 格式。 如果未指定时区,则假定该值位于运行 AzCopy 的计算机的本地时区(例如:UTC 时间的“2020-08-19T15:04:00Z”)或“2020-08-19”(本地时区)的午夜(00:00)。 从 AzCopy 10.5 开始,此标志仅适用于文件,不适用于文件夹,因此在将此标志用于 --preserve-smb-info
或 --preserve-smb-permission
s 时,不会复制文件夹属性。
--include-before
(字符串)仅包括之前或给定日期和时间修改的文件。 该值应为 ISO8601 格式。 如果未指定时区,则假定该值位于运行 AzCopy 的计算机的本地时区(例如:UTC 时间的“2020-08-19T15:04:00Z”)或“2020-08-19”(本地时区)的午夜(00:00)。 从 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
(字符串)指定一个文本文件,其中每个版本 ID 都列在单独的行上。 确保源必须指向单个 Blob,并且使用此标志在文件中指定的所有版本 ID 必须仅属于源 Blob。 给定 Blob 的指定版本 ID 将从 Azure 存储中删除。
--permanent-delete
(字符串)这是永久删除软删除快照/版本的预览功能。 可能的值包括“snapshots”、“versions”、“snapshotsandversions”、“none”。 (默认值为“None”)
--trailing-dot
默认情况下启用以安全方式处理文件共享相关操作。 可用选项: Enable
, Disable
。 选择 Disable
返回到对尾随点文件的旧处理(可能不安全),文件服务将剪裁路径中的任何尾随点。 如果传输仅包含一个尾随点(例如 mypath
和 mypath.
)不同的两个路径,这可能会导致潜在的数据损坏。 如果此标志设置为 Disable
AzCopy 并且遇到尾随点文件,它将警告扫描日志中的客户,但不会尝试中止操作。 如果目标不支持尾随点文件(Windows 或 Blob 存储),则如果尾随点文件是传输的根,并且跳过枚举期间遇到的任何尾随点路径,AzCopy 将失败。
--recursive
- 默认值为 false。 在目录之间同步时,以递归方式查看子目录。
从父命令继承的选项
--cap-mbps float
限定传输速率,以 Mbps(兆位/秒)为单位。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零或被省略,则吞吐量不受限制。
--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”)