你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
azcopy copy
将源数据复制到目标位置。
注意
AzCopy 不支持在传输期间主动更改源或目标的情况。
摘要
将源数据复制到目标位置。 支持的方向如下:
- 本地 <-> Azure Blob(SAS 或 OAuth 身份验证)
- 本地 < - > Azure 文件存储(共享/目录 SAS 身份验证或 OAuth 身份验证)
- 本地 <-> Azure Data Lake Storage(SAS、OAuth 或 SharedKey 身份验证)
- Azure Blob(SAS 或公共)-> Azure Blob(SAS 或 OAuth 身份验证)
- Azure Data Lake Storage(SAS 或公共)-> Azure Data Lake Storage(SAS 或 OAuth 身份验证)
- Azure Blob(SAS 或 OAuth 身份验证)<-> Azure Blob(SAS 或 OAuth 身份验证)- 请参阅准则。
- Azure Data Lake Storage(SAS 或 OAuth 身份验证)<-> Azure Data Lake Storage(SAS 或 OAuth 身份验证)
- Azure Data Lake Storage(SAS 或 OAuth 身份验证)<-> Azure Blob(SAS 或 OAuth 身份验证)
- Azure Blob(SAS 或公共)-> Azure 文件存储 (SAS)
- Azure 文件(SAS 或 OAuth 身份验证)<- > Azure 文件(SAS 或 OAuth 身份验证)
- Azure 文件存储 (SAS) -> Azure Blob(SAS 或 OAuth 身份验证)
- AWS S3(访问密钥)-> Azure 块 Blob(SAS 或 OAuth 身份验证)
- Google Cloud Storage(服务帐户密钥)-> Azure 块 Blob(SAS 或 OAuth 身份验证)
有关详细信息,请参阅示例。
高级
从本地磁盘上传时,AzCopy 会根据文件扩展名或内容(如果未指定扩展名)自动检测文件的内容类型。
内置的查找表较小,但在 Unix 上,已通过采用以下一个或多个名称的本地系统 mime.types 文件(如果可用)扩充了该查找表:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
在 Windows 上,MIME 类型是从注册表提取的。 可以借助一个标志禁用此功能。 请参阅“标志”部分。
如果使用命令行设置环境变量,则可以在命令行历史记录中读取该变量。 请考虑从命令行历史记录中清除包含凭据的变量。 若要防止变量出现在历史记录中,可以使用脚本提示用户输入凭据,并设置环境变量。
azcopy copy [source] [destination] [flags]
相关概念性文章
示例
使用 OAuth 身份验证上传单个文件。 如果尚未登录到 AzCopy,请在运行以下命令之前运行 azcopy login 命令。
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
与前面的示例相同,但这一次此命令还会计算文件内容的 MD5 哈希,并将其另存为 Blob 的 Content-MD5 属性:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
使用 SAS 令牌上传单个文件:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
使用 SAS 令牌和管道(仅限块 Blob)上传单个文件:
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
使用 OAuth 和管道(仅限块 Blob)上传单个文件:
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
使用 SAS 令牌上传整个目录:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
或
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
使用 SAS 令牌和通配符 (*) 上传一组文件:
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
使用 SAS 令牌和通配符 (*) 上传文件和目录:
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
将文件和目录上传到 Azure 存储帐户,并在 Blob 上设置查询字符串编码标记。
- 若要设置标记 {key = "bla bla", val = "foo"} 和 {key = "bla bla 2", val = "bar"},请使用以下语法:
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
- 键和值是 URL 编码的,键值对之间用与符号(“&”)分隔
- 在 Blob 上设置标记时,SAS 中还有更多权限(“t”表示标记),如果没有这些权限,服务会返回授权错误。
使用 OAuth 身份验证下载单个文件。 如果尚未登录到 AzCopy,请在运行以下命令之前运行 azcopy login 命令。
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
使用 SAS 令牌下载单个文件:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
使用 SAS 令牌下载单个文件,然后通过管道将输出传送到文件(仅限块 Blob):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
使用 OAuth 下载单个文件,然后通过管道将输出传送到文件(仅限块 Blob):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
使用 SAS 令牌下载整个目录:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
有关在 URL 中使用通配符 (*) 的说明:
仅支持通过两种方式在 URL 中使用通配符。
紧接在 URL 的最后一个正斜杠 (/) 后面使用一个通配符。 这会将目录中的所有文件直接复制到目标,而不会将其放入子目录。
也可以在容器名称中使用一个通配符,前提是 URL 只引用容器而不引用 Blob。 可以使用此方法从一部分容器中获取文件。
下载目录的内容,而不复制包含的目录本身。
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
下载整个存储帐户。
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
在容器名称中使用通配符 (*),下载存储帐户中的一部分容器。
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
将文本文件(例如:versionidsFile
)中列出的所有 Blob 版本从 Azure 存储下载到本地目录。 确保源是有效的 blob,目标是本地文件夹,versionidsFile
是一个文本文件,其中每个版本都列在单独一行上。 所有指定的版本都会下载到指定的目标文件夹中。
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
使用 SAS 令牌将单个 Blob 复制到另一个 Blob。
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
使用 SAS 令牌和 OAuth 令牌将单个 Blob 复制到另一个 Blob。
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
使用 SAS 令牌将一个 Blob 虚拟目录复制到另一个 Blob:
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
使用 SAS 令牌将一个存储帐户中的所有 Blob 容器、目录和 Blob 复制到另一个存储帐户:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
使用访问密钥和 SAS 令牌将单个对象复制到 Amazon Web Services (AWS) S3 中的 Blob 存储。 首先,为 AWS S3 源设置环境变量 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
使用访问密钥和 SAS 令牌将整个目录复制到 AWS S3 中的 Blob 存储。 首先,为 AWS S3 源设置环境变量 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
请参阅 https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html 以更好地了解 [folder] 占位符。
使用访问密钥和 SAS 令牌将所有桶复制到 Amazon Web Services (AWS) 中的 Blob 存储。 首先,为 AWS S3 源设置环境变量 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
使用访问密钥和 SAS 令牌将所有桶复制到 Amazon Web Services (AWS) 区域中的 Blob 存储。 首先,为 AWS S3 源设置环境变量 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
在桶名称中使用通配符 (*) 来复制一部分桶。 如前面的示例所示,需要提供访问密钥和 SAS 令牌。 请确保为 AWS S3 源设置环境变量 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
将 Blob 从一个 Blob 存储复制到另一个 Blob 存储,并保留源中的标记。 若要保留标记,请使用以下语法:
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true
将文件和目录传输到 Azure 存储帐户,并在 Blob 上设置给定查询字符串编码标记。
若要设置标记 {key = "bla bla", val = "foo"} 和 {key = "bla bla 2", val = "bar"},请使用以下语法:
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
键和值是 URL 编码的,键值对之间用与符号(“&”)分隔
在 Blob 上设置标记时,SAS 中还有其他权限(“t”表示标记),如果没有这些权限,服务将返回授权错误。
使用服务帐户密钥和 SAS 令牌将的单个对象从 Google Cloud Storage (GCS) 复制到 Blob 存储。 首先,为 GCS 源设置环境变量 GOOGLE_APPLICATION_CREDENTIALS。
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
使用服务帐户密钥和 SAS 令牌将整个目录从 Google Cloud Storage (GCS) 复制到 Blob 存储。 首先,为 GCS 源设置环境变量 GOOGLE_APPLICATION_CREDENTIALS。
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
使用服务帐户密钥和 SAS 令牌将整个 Bucket 从 Google Cloud Storage (GCS) 复制到 Blob 存储。 首先,为 GCS 源设置环境变量 GOOGLE_APPLICATION_CREDENTIALS。
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
使用服务帐户密钥和 SAS 令牌将所有 Bucket 从 Google Cloud Storage (GCS) 复制到 Blob 存储。 首先,为 GCS 源设置环境变量 GOOGLE_APPLICATION_CREDENTIALS 和 GOOGLE_CLOUD_PROJECT=<project-id>
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
通过使用目标的服务帐户密钥和 SAS 令牌,使用 Google Cloud Storage (GCS) 中 Bucket 名称中的通配符 (*) 复制 Bucket 的子集。 首先,为 GCS 源设置环境变量 GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id>
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
如果要复制在 AzCopy 作业启动之前或之后更改的文件,AzCopy 在作业日志中提供了 ISO8601 格式的日期和时间(在作业日志中搜索“ISO 8601 START TIME”),可与 --include-after
和 --include-before
标志一起使用,见下例。 这对增量副本很有用。
使用 include-after
标志复制容器中在给定日期和时间(ISO8601 格式)或之后修改的文件子集。
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"
使用 include-before
标志复制容器中在给定日期和时间(ISO8601 格式)或之前修改的文件子集。
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"
选项
--as-subdir
默认值为 True。 将文件夹源作为子目录放置在目标下。 (默认值为 true)
--backup
激活 Windows 用于上传的 SeBackupPrivilege 或用于下载的 SeRestorePrivilege,以允许 AzCopy 查看和读取所有文件(无论其文件系统权限如何),并恢复所有权限。 要求运行 AzCopy 的帐户已经具有这些权限(例如,拥有管理员权限,或者是“备份操作员”组的成员)。 此标志激活帐户已经具有的权限
--blob-tags
(字符串)在 Blob 上设置标记以对存储帐户中的数据进行分类
--blob-type
(字符串)定义目标中的 Blob 类型。 此选项用于上传 Blob 以及在帐户之间进行复制(默认值为“Detect”)。 有效值包括“Detect”、“BlockBlob”、“PageBlob”和“AppendBlob”。 在帐户之间复制时,使用值“Detect”会导致 AzCopy 使用源 Blob 的类型来确定目标 Blob 的类型。 上传文件时,“Detect”会根据文件扩展名确定文件是 VHD 文件还是 VHDX 文件。 如果文件是 VHD 或 VHDX 文件,则 AzCopy 会将该文件视为页 Blob。 (默认值为“Detect”)
--block-blob-tier
(字符串)使用此 Blob 层将块 Blob 上传到 Azure 存储。 (默认值为“None”)
--block-size-mb
(浮点数)在上传到 Azure 存储以及从 Azure 存储下载时使用此块大小(以 MiB 为单位)。 默认值是根据文件大小自动计算的。 允许使用小数(例如:0.25)。 在上传或下载时,允许的最大块大小为 0.75 * AZCOPY_BUFFER_GB。 有关详细信息,请参阅优化内存使用。
--cache-control
(字符串)设置 cache-control 标头。 下载时返回。
--check-length
- 传输后检查目标上的文件长度。 如果源与目标之间不匹配,则将传输标记为失败。 (默认值为 true)
--check-md5
(字符串)指定下载时验证 MD5 哈希的严格程度。 仅在下载时可用。 可用选项:NoCheck、LogOnly、FailIfDifferent、FailIfDifferentOrMissing。 (默认值为“FailIfDifferent”)
--content-disposition
(字符串)设置 content-disposition 标头。 下载时返回。
--content-encoding
(字符串)设置 content-encoding 标头。 下载时返回。
--content-language
(字符串)设置 content-language 标头。 下载时返回。
--content-type
(字符串)指定文件的内容类型。 暗指 no-guess-mime-type。 下载时返回。
--cpk-by-name
(字符串)客户端按名称提供的密钥使客户端可以向 Azure Blob 存储发出请求,以便按每个请求提供加密密钥。 提供的密钥名称提取自 Azure 密钥保管库,并用于对数据进行加密
--cpk-by-value
- 默认值为 false。 客户端按名称提供的密钥使客户端可以向 Azure Blob 存储发出请求,以便按每个请求提供加密密钥。 提供的密钥及其哈希提取自环境变量
--decompress
下载时自动解压缩文件(如果 content-encoding 指示文件已压缩)。 支持的 content-encoding 值为“gzip”和“deflate”。 不需要提供“.gz”/“.gzip”或“.zz”文件扩展名,但如果存在,则会将其移除。
--disable-auto-decoding
默认为 false 以在 Windows 上启用非法字符的自动解码。 可以设置为 true 以禁用自动解码。
--dry-run
- 默认值为 false。 打印此命令将复制的文件路径。 此标志不会复制实际文件。 --overwrite 标志不起作用。 如果将 --overwrite 标志设置为 false,即使目标目录中存在这些文件,也会列出源目录中的文件。
--exclude-attributes
(字符串)(仅限 Windows)- 排除其特性与特性列表相匹配的文件。 例如:A;S;R
--exclude-blob-type
(字符串)(可选)指定从容器或帐户复制 Blob 时要排除的 Blob 类型 (BlockBlob/PageBlob/AppendBlob)。 此标志不适用于将数据从非 Azure 服务复制到 Azure 服务。 应使用“;”分隔多个 Blob。
--exclude-container
(字符串)仅在帐户间传输时排除这些容器。 可以使用“;”分隔多个容器。
--exclude-path
(字符串)复制时排除这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀(例如:myFolder;myFolder/subDirName/file.pdf)。 与帐户遍历结合使用时,路径不包含容器名称。
--exclude-pattern
(字符串)复制时排除这些文件。 此选项支持通配符 (*)
--exclude-regex
(字符串)排除与正则表达式相符的文件的所有相对路径。 使用“;”分隔正则表达式。
--follow-symlinks
从本地文件系统上传时跟踪符号链接。
--force-if-read-only
在 Windows 或 Azure 文件上覆盖现有文件时,即使现有文件已设置只读属性,也要执行覆盖操作
--from-to
(字符串)(可选)指定源-目标组合。 例如:LocalBlob、BlobLocal、LocalBlobFS。 管道:BlobPipe、PipeBlob
-h
、--help
copy 命令的帮助
--include-after
(字符串)只包括在给定日期/时间或之后修改的文件。 该值应为 ISO8601 格式。 如果未指定时区,则假定该值位于运行 AzCopy 的计算机的本地时区中。 例如,2020-08-19T15:04:00Z
表示 UTC 时间,2020-08-19
表示本地时区的午夜 (00:00)。 从 AzCopy 10.5 开始,此标志仅适用于文件,不适用于文件夹,因此在将此标志与 --preserve-smb-info
或 --preserve-smb-permissions
一起使用时,将不会复制文件夹属性。
--include-attributes
(字符串)(仅限 Windows)包括其特性与特性列表相匹配的文件。 例如:A;S;R
--include-before
(字符串)只包括在给定日期/时间或之前修改的文件。 该值应为 ISO8601 格式。 如果未指定时区,则假定该值位于运行 AzCopy 的计算机的本地时区中。 例如,2020-08-19T15:04:00Z
表示 UTC 时间,2020-08-19
表示本地时区的午夜 (00:00)。 从 AzCopy 10.7 开始,此标志仅适用于文件,不适用于文件夹,因此当将此标志与 --preserve-smb-info
或 --preserve-smb-permissions
一起使用时,将不会复制文件夹属性。
--include-directory-stub
默认为 False,即忽略目录存根。 目录存根具有元数据 hdi_isfolder:true
的 Blob。 将值设置为 true 会在传输期间保留目录存根。 包括这个不具有默认为 true(例如,azcopy copy --include-directory-stub
与 azcopy copy --include-directory-stub=true
相同)值的标志。
--include-path
(字符串)复制时仅包括这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀(例如:myFolder;myFolder/subDirName/file.pdf)。
--include-pattern
(字符串)复制时仅包括这些文件。 此选项支持通配符 (*)。 使用“;”分隔文件。
--include-regex
(字符串)仅包括与正则表达式相符的文件的相对路径。 使用“;”分隔正则表达式。
--list-of-versions
(字符串)指定一个文件,其中每个版本 ID 都列在单独的一行中。 确保源必须指向单个 Blob,并且使用此标志在文件中指定的所有版本 ID 必须仅属于源 Blob。 AzCopy 会将指定的版本下载到提供的目标文件夹中。
--metadata
(字符串)将这些键值对作为元数据上传到 Azure 存储。
--no-guess-mime-type
阻止 AzCopy 根据文件的扩展名或内容来检测内容类型。
--overwrite
(字符串)如果此标志设置为 true,则会覆盖目标上有冲突的文件和 Blob。 (默认值为“true”)可能的值包括“true”“false”“prompt”和“ifSourceNewer”。 对于支持文件夹的目标,如果此标志为“true”,或对提示提供了肯定相应,则将覆盖冲突的文件夹级别属性。 (默认值为“true”)
--page-blob-tier
(字符串)使用此 Blob 层将页 Blob 上传到 Azure 存储。 (默认值为“None”)。 (默认值为“None”)
--preserve-last-modified-time
仅当目标为文件系统时才可用。
--preserve-owner
仅当下载时,且仅当使用 --preserve-smb-permissions
时才起作用。 如果为 true(默认值),则下载内容中将保留文件“所有者”和“组”。 如果设置为 false,
--preserve-smb-permissions
仍保留 ACL,但“所有者”和“组”将基于运行 AzCopy 的用户(默认值为 true)
--preserve-permissions
默认为 false。 在感知资源(Windows 和 Azure 文件,或 Azure Data Lake Storage 到 Azure Data Lake Storage)之间保留 ACL。 对于具有分层命名空间的帐户,安全主体必须是目标容器的责任用户,或者必须被分配存储 Blob 数据所有者角色,范围仅限于目标容器、存储帐户、父资源组或订阅。 对于下载操作,还需要使用 --backup
标志来恢复权限,其中新所有者将不是运行 AzCopy 的用户。 此标志同时适用于文件和文件夹,除非指定了“仅文件”筛选器(例如包含模式)。
--preserve-posix-properties
- 默认值为 false。 保留从 stat
或 statx
收集到对象元数据中的属性信息。
--preserve-smb-info
对于 SMB 感知位置,默认情况下,标志设置为 true。 保留 SMB 感知资源(Windows 和 Azure 文件存储)之间的 SMB 属性信息(上次写入时间、创建时间、属性位)。 只会传输 Azure 文件存储支持的属性位;其他属性位将被忽略。 此标志同时适用于文件和文件夹,除非指定了“仅文件”筛选器(例如包含模式)。 为文件夹传输的信息与为文件传输的信息几乎相同,只是 Last Write Time
除外,不会为文件夹保留该信息。 (默认值为 true)
--preserve-symlinks
如果启用,则符号链接目标将保留为 blob 内容,而不是在符号链接的另一端上传文件或文件夹。
--put-blob-size-mb
将此大小(以 MiB 指定)用作阈值,以确定在上传到 Azure 存储时是否将 blob 作为单个 PUT 请求上传。 默认值是根据文件大小自动计算的。 允许使用小数(例如:0.25)。
--put-md5
- 创建每个文件的 MD5 哈希,并将该哈希另存为目标 Blob 或文件的 Content-MD5 属性。 (默认不会创建哈希。)仅在上传时可用。
--recursive
从本地文件系统上传时以递归方式检查子目录。
--s2s-detect-source-changed
检测源文件/Blob 在读取时是否发生更改。 (此参数仅适用于服务到服务的副本,因为将对上传和下载永久启用相应的检查。)
--s2s-handle-invalid-metadata
(字符串)指定如何处理无效的元数据键。 可用选项:ExcludeIfInvalid、FailIfInvalid、RenameIfInvalid。 (默认值为“ExcludeIfInvalid”)。 (默认值为“ExcludeIfInvalid”)
--s2s-preserve-access-tier
在服务间复制过程中保留访问层。 请参阅 Azure Blob 存储:热、冷和存档访问层,确保目标存储帐户支持设置访问层。 如果不支持设置访问层,请确保使用 s2sPreserveAccessTier=false 来绕过访问层的复制。 (默认值为 true)。 (默认值为 true)
--s2s-preserve-blob-tags
- 默认值为 false。 在 blob 存储之间进行服务到服务传输过程中保留索引标记
--s2s-preserve-properties
在服务间复制过程中保留完整属性。 对于 AWS S3 和 Azure 文件存储的非单一文件源,列出操作不会返回对象和文件的完整属性。 若要保留完整属性,AzCopy 需要对每个对象或文件发送一个额外的请求。 (默认值为 true)
--trailing-dot
默认情况下启用,会以安全方式处理文件共享相关操作。 可用选项:Enable
、Disable
。 选择 Disable
可返回到对尾随点文件的旧式处理(可能不安全),其中文件服务将剪裁路径中的任何尾随点。 如果传输包含两个仅相差一个尾随点的路径(例如 mypath
和 mypath.
),这可能导致潜在的数据损坏。 如果此标志设置为 Disable
并且 AzCopy 遇到尾随点文件,它将在扫描日志中警告客户,但不会尝试中止操作。 如果目标不支持尾随点文件(Windows 或 Blob 存储),当尾随点文件是传输的根目录时,AzCopy 将失败,并跳过枚举期间遇到的任何尾随点路径。
从父命令继承的选项
--cap-mbps
(浮动)以兆位/秒为单位限制传输速率。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零或被省略,则吞吐量不受限制。
--log-level
(字符串)定义日志文件的日志详细程度,可用级别:INFO(所有请求/响应)、WARNING(响应缓慢)、ERROR(仅限失败的请求)和 NONE(无输出日志)。 (默认值为“INFO”)。 (默认值为“INFO”)
--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 域。 用分号分隔多个条目。