你当前正在访问 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-permissions 时,不会复制文件夹属性。

--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 默认情况下启用以安全方式处理文件共享相关操作。 可用选项: EnableDisable。 选择 Disable 返回到对尾随点文件的旧处理(可能不安全),文件服务将剪裁路径中的任何尾随点。 如果传输仅包含一个尾随点(例如 mypathmypath.)不同的两个路径,这可能会导致潜在的数据损坏。 如果此标志设置为 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”)

另请参阅