使用 AzCopy 将文件上传到 Azure Blob 存储

可以使用 AzCopy v10 命令行实用程序将文件和目录上传到 Blob 存储。

若要查看其他类型任务（如下载 Blob、与 Blob 存储同步或在帐户之间复制 Blob）的示例，请参阅本文的后续步骤部分中提供的链接。

入门

请参阅 AzCopy 入门一文下载 AzCopy，并了解如何提供存储服务的授权凭据。

创建容器

可以使用 azcopy make 命令创建容器。

语法

azcopy make 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>'

示例

azcopy make 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer'

示例（Data Lake Storage 终结点）

azcopy make 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer'

有关详细参考文档，请参阅 azcopy make。

上载文件

使用 azcopy copy 命令上传文件。

语法

azcopy copy '<local-file-path>' 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>/<blob-name>'

示例

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer/myTextFile.txt'

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer/myTextFile.txt'

还可以在文件路径或文件名中的任意位置使用通配符 (*) 来上传文件。 例如：'C:\myDirectory\*.txt' 或 C:\my*\*.txt。

上传目录

使用 azcopy copy 命令上传目录。

此示例将某个目录（以及该目录中的所有文件）复制到 Blob 容器。 结果是该文件共享中出现一个同名的容器。

语法

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>' --recursive

示例

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer' --recursive

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer' --recursive

若要复制到容器中的某个目录，只需在命令字符串中指定该目录的名称。

示例

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer/myBlobDirectory' --recursive

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer/myBlobDirectory' --recursive

如果指定的目录名称在容器中不存在，AzCopy 将以该名称创建一个新目录。

上传目录内容

使用 azcopy copy 命令上传目录的内容。 可以使用通配符 (*) 上传内容，而无需复制包含的目录本身。

语法

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>/<directory-path>'

示例

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer/myBlobDirectory'

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer/myBlobDirectory'

追加 --recursive 标志可以上传所有子目录中的文件。

上传特定的文件

可以使用完整的文件名、包含通配符 (*) 的部分名称或者日期和时间来上传特定文件。

指定多个完整文件名

结合 --include-path 选项使用 azcopy copy 命令。 使用分号 (;) 分隔各个文件名。

语法

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>' --include-path <semicolon-separated-file-list>

示例

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive'

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer' --include-path 'photos;documents\myFile.txt' --recursive'

在此示例中，AzCopy 将传输 C:\myDirectory\photos 目录和 C:\myDirectory\documents\myFile.txt 文件。 包含 --recursive 选项才能传输 C:\myDirectory\photos 目录中的所有文件。

还可以使用 --exclude-path 选项来排除文件。 有关详细信息，请参阅 azcopy copy 参考文档。

使用通配符

结合 --include-pattern 选项使用 azcopy copy 命令。 指定包含通配符的部分名称。 使用分号 (;) 分隔名称。

语法

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-name>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

示例

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer' --include-pattern 'myFile*.txt;*.pdf*'

还可以使用 --exclude-pattern 选项来排除文件。 有关详细信息，请参阅 azcopy copy 参考文档。

--include-pattern 和 --exclude-pattern 选项仅适用于文件名，而不适用于路径。 若要复制目录树中存在的所有文本文件，请使用 -recursive 选项获取整个目录树，然后使用 -include-pattern 并指定 *.txt 来获取所有文本文件。

上传在某个日期和时间之前或之后修改的文件

将 azcopy copy 命令与 --include-before 或 --include-after 选项结合使用。 以 ISO-8601 格式指定日期和时间（例如 2020-08-19T15:04:00Z）。

以下示例上传在指定日期或之后修改的文件。

语法

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.<blob or dfs>.core.chinacloudapi.cn/<container-or-directory-name>' --include-after <Date-Time-in-ISO-8601-format>

示例

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer/FileDirectory'  --include-after '2020-08-19T15:04:00Z'

示例（Data Lake Storage 终结点）

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.dfs.core.chinacloudapi.cn/mycontainer/FileDirectory'   --include-after '2020-08-19T15:04:00Z'

如需详细的参考，请查看 azcopy copy 参考文档。

使用索引标记上传

可上传文件并将 Blob 索引标记添加到目标 Blob。

如果使用 Microsoft Entra 授权，则必须向安全主体分配存储 Blob 数据所有者角色，或者必须通过自定义 Azure 角色向其授予 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure 资源提供程序操作权限。 如果使用共享访问签名 (SAS) 令牌，则该令牌必须通过 SAS 权限 t 提供对 Blob 标记的访问权限。

要添加标记，请使用 --blob-tags 选项以及 URL 编码的键值对。 例如，要添加键 my tag 和值 my tag value，可将 --blob-tags='my%20tag=my%20tag%20value' 添加到目标参数。

使用与号 (&) 分隔多个索引标记。 例如，如果要添加键 my second tag 和值 my second tag value，则完整选项字符串将为 --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'。

以下示例演示如何使用 --blob-tags 选项。

上传文件

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer/myTextFile.txt' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

上传目录

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer' --recursive --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

上传目录内容

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.blob.core.chinacloudapi.cn/mycontainer/myBlobDirectory' --blob-tags='my%20tag=my%20tag%20value&my%20second%20tag=my%20second%20tag%20value'

使用可选标志上传

可以通过使用可选标志来调整上传操作。 下面是几个示例。

方案	标志
将文件作为追加 Blob 或页 Blob 上传。	--blob-type=[BlockBlob|PageBlob|AppendBlob]
上传到特定访问层（如存档层）。	--block-blob-tier=[None|Hot|Cool|Archive]

有关完整列表，请参阅选项。

后续步骤

如需了解更多示例，请参阅以下文章：

• 示例：下载
• 示例：在帐户之间复制
• 示例：同步
• 示例：Amazon S3 存储桶
• 示例：Google Cloud Storage
• 示例：Azure 文件存储
• 教程：使用 AzCopy 将本地数据迁移到云存储

请参阅以下文章了解如何配置设置、优化性能和排查问题：

• AzCopy 配置设置
• 优化 AzCopy 的性能
• 使用 AzCopy 中的日志和计划文件查找错误并恢复作业
• 排查 AzCopy v10 的问题