az storage
Note
此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展，使其受益于其扩展功能。 了解更多关于扩展的信息。
管理 Azure 云存储资源。
命令
az storage copy
将文件或目录复制到 Azure 存储或从 Azure 存储复制或从中复制。
az storage copy [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-type {AppendBlob, BlockBlob, PageBlob}]
[--cap-mbps]
[--connection-string]
[--content-type]
[--destination]
[--destination-account-name]
[--destination-blob]
[--destination-container]
[--destination-file-path]
[--destination-local-path]
[--destination-share]
[--exclude-path]
[--exclude-pattern]
[--follow-symlinks]
[--include-path]
[--include-pattern]
[--preserve-s2s-access-tier {false, true}]
[--put-md5]
[--recursive]
[--sas-token]
[--source]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-connection-string --src-conn]
[--source-container]
[--source-file-path]
[--source-local-path]
[--source-sas]
[--source-share]
[]示例
使用 URL 将单个文件上传到 Azure Blob。
az storage copy -s /path/to/file.txt -d https://[account].blob.core.windows.net/[container]/[path/to/blob]使用帐户名称和容器名称将单个文件上传到 Azure Blob。
az storage copy -s /path/to/file.txt --destination-account-name mystorageaccount --destination-container mycontainer将单个文件上传到包含文件内容的 MD5 哈希的 Azure Blob，并将其保存为 Blob 的 Content-MD5 属性。
az storage copy -s /path/to/file.txt -d https://[account].blob.core.windows.net/[container]/[path/to/blob] --put-md5使用 URL 将整个目录上传到 Azure Blob。
az storage copy -s /path/to/dir -d https://[account].blob.core.windows.net/[container]/[path/to/directory] --recursive使用帐户名称和容器名称将整个目录上传到 Azure Blob。
az storage copy -s /path/to/dir --destination-account-name mystorageaccount --destination-container mycontainer --recursive使用带有 URL 的通配符将一组文件上传到 Azure Blob。
az storage copy -s /path/*foo/*bar/*.pdf -d https://[account].blob.core.windows.net/[container]/[path/to/directory]使用具有帐户名称和容器名称的通配符将一组文件上传到 Azure Blob。
az storage copy -s /path/*foo/*bar/*.pdf --destination-account-name mystorageaccount --destination-container mycontainer使用带 URL 的通配符将文件和目录上传到 Azure Blob。
az storage copy -s /path/*foo/*bar* -d https://[account].blob.core.windows.net/[container]/[path/to/directory] --recursive使用具有帐户名称和容器名称的通配符将文件和目录上传到 Azure Blob。
az storage copy -s /path/*foo/*bar* --destination-account-name mystorageaccount --destination-container mycontainer --recursive使用 URL 从 Azure Blob 下载单个文件，还可以指定存储帐户和容器信息，如下所示。
az storage copy -s https://[account].blob.core.windows.net/[container]/[path/to/blob] -d /path/to/file.txt从 Azure Blob 下载整个目录，还可以指定存储帐户和容器信息，如下所示。
az storage copy -s https://[account].blob.core.windows.net/[container]/[path/to/directory] -d /path/to/dir --recursive使用容器名称中的通配符 • 在存储帐户中下载容器的子集，还可以指定存储帐户和容器信息，如下所示。
az storage copy -s https://[account].blob.core.windows.net/[container*name] -d /path/to/dir --recursive从 Azure Blob 下载一部分文件。 （仅包含 jpg 文件和文件名以测试开头。
az storage copy -s https://[account].blob.core.windows.net/[container] --include-pattern "*.jpg" --exclude-pattern test* -d /path/to/dir --recursive将单个 Blob 复制到另一个 Blob，还可以指定源和目标的存储帐户和容器信息，如上所述。
az storage copy -s https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob] -d https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]将整个帐户数据从 Blob 帐户复制到另一个 Blob 帐户，还可以指定源和目标的存储帐户和容器信息，如下所示。
az storage copy -s https://[srcaccount].blob.core.windows.net -d https://[destaccount].blob.core.windows.net --recursive从具有 Blob 访问密钥的 S3 复制单个对象，还可以指定存储帐户和容器信息，如下所示。
az storage copy -s https://s3.amazonaws.com/[bucket]/[object] -d https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]将具有访问密钥的整个目录从 S3 复制到 Blob 虚拟目录，还可以指定存储帐户和容器信息，如下所示。
az storage copy -s https://s3.amazonaws.com/[bucket]/[folder] -d https://[destaccount].blob.core.windows.net/[container]/[path/to/directory] --recursive将 S3 服务中的所有存储桶与 Blob 帐户的访问密钥一起复制，还可以按上述方式指定存储帐户信息。
az storage copy -s https://s3.amazonaws.com/ -d https://[destaccount].blob.core.windows.net --recursive复制 S3 区域中具有 Blob 帐户访问密钥的所有存储桶，还可以按上述方式指定存储帐户信息。
az storage copy -s https://s3-[region].amazonaws.com/ -d https://[destaccount].blob.core.windows.net --recursive使用 URL 将单个文件上传到 Azure 文件共享。
az storage copy -s /path/to/file.txt -d https://[account].file.core.windows.net/[share]/[path/to/file]使用帐户名称和共享名称将单个文件上传到 Azure 文件共享。
az storage copy -s /path/to/file.txt --destination-account-name mystorageaccount --destination-share myshare使用 URL 将整个目录上传到 Azure 文件共享。
az storage copy -s /path/to/dir -d https://[account].file.core.windows.net/[share]/[path/to/directory] --recursive使用帐户名称和容器名称将整个目录上传到 Azure 文件共享。
az storage copy -s /path/to/dir --destination-account-name mystorageaccount --destination-share myshare --recursive使用具有帐户名称和共享名称的通配符将一组文件上传到 Azure 文件共享。
az storage copy -s /path/*foo/*bar/*.pdf --destination-account-name mystorageaccount --destination-share myshare使用带有 URL 的通配符将文件和目录上传到 Azure 文件共享。
az storage copy -s /path/*foo/*bar* -d https://[account].file.core.windows.net/[share]/[path/to/directory] --recursive使用具有帐户名称和共享名称的通配符将文件和目录上传到 Azure 文件共享。
az storage copy -s /path/*foo/*bar* --destination-account-name mystorageaccount --destination-share myshare --recursive使用 URL 从 Azure 文件共享下载单个文件，还可以指定存储帐户和共享信息，如下所示。
az storage copy -s https://[account].file.core.windows.net/[share]/[path/to/file] -d /path/to/file.txt从 Azure 文件共享下载整个目录，还可以指定存储帐户和共享信息，如下所示。
az storage copy -s https://[account].file.core.windows.net/[share]/[path/to/directory] -d /path/to/dir --recursive使用通配符从 Azure 文件共享下载一组文件，还可以指定存储帐户和共享信息，如下所示。
az storage copy -s https://[account].file.core.windows.net/[share]/ --include-pattern foo* -d /path/to/dir --recursive使用 url 和 azcopy 选项直通将单个文件上传到 Azure Blob。
az storage copy -s /path/to/file.txt -d https://[account].blob.core.windows.net/[container]/[path/to/blob] -- --block-size-mb=0.25 --check-length可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_KEY。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
复制目标的存储帐户名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。
| 属性 | 值 |
|---|---|
| 接受的值: | key, login |
目标处 Blob 的类型。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
| 接受的值: | AppendBlob, BlockBlob, PageBlob |
以兆位/秒为单位限制传输速率。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零，或者省略，则吞吐量不受限制。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
指定文件的内容类型。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
复制目标的路径/URL。 它可以是本地路径，可以是 Azure 存储服务器的 URL。 如果在此处提供目标参数，则不需要在复制目标参数组中提供参数，并且将来将弃用复制目标参数。
选项“--destination-account-name”已弃用，将在将来的版本中删除。 请改用“--account-name”。
复制目标的存储帐户名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
复制目标存储帐户的 Blob 容器中的 Blob 名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy destination Arguments |
复制目标存储帐户的容器名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy destination Arguments |
复制目标存储帐户文件共享中的文件路径。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy destination Arguments |
选项“--destination-local-path”已弃用，将在将来的版本中删除。 请改用“--destination”。
复制目标的路径/URL。 它可以是本地路径，可以是 Azure 存储服务器的 URL。 如果在此处提供目标参数，则不需要在复制目标参数组中提供参数，并且将来将弃用复制目标参数。
复制目标存储帐户的文件共享名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy destination Arguments |
排除这些路径。 此选项不支持通配符 \. 检查相对路径前缀。 例如：myFolder;myFolder/subDirName/file.pdf。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
排除名称与模式列表匹配的这些文件。 例如： .jpg;.pdf;exactName。 此选项支持通配符 (*)。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
从本地文件系统上传时，请遵循符号链接。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
仅包括这些路径。 此选项不支持通配符 \. 检查相对路径前缀。 例如：myFolder;myFolder/subDirName/file.pdf.
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
仅包含名称与模式列表匹配的这些文件。 例如： .jpg;.pdf;exactName。 此选项支持通配符 (*)。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
在服务到服务复制期间保留访问层。 请参阅 https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers 确保目标存储帐户支持设置访问层。 如果不支持设置访问层，请使用 --preserve-s2s-access-tier false 来绕过访问层的复制。 （默认值为 true）。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
| 接受的值: | false, true |
创建每个文件的 MD5 哈希，并将哈希保存为目标 blob/文件的 Content-MD5 属性。仅在上传时可用。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
以递归方式查看子目录。
共享访问签名（SAS）。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
复制源的路径/URL。 它可以是本地路径、Azure 存储服务器或 AWS S3 存储桶的 URL。 如果在此处提供源参数，则不需要在复制源参数组中提供参数，并且将来将弃用复制源参数。
复制源存储帐户的帐户密钥。 必须与源存储帐户名称结合使用。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
复制源存储帐户的帐户名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
复制源存储帐户的 Blob 容器中的 Blob 名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
源存储帐户的连接字符串。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
复制源存储帐户的容器名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
复制源存储帐户文件共享中的文件路径。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
选项“--source-local-path”已弃用，将在将来的版本中删除。 请改用“--source”。
复制源的路径/URL。 它可以是本地路径、Azure 存储服务器或 AWS S3 存储桶的 URL。 如果在此处提供源参数，则不需要在复制源参数组中提供参数，并且将来将弃用复制源参数。
复制源的共享访问签名 （SAS） 令牌。 必须与源存储帐户名称结合使用。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
复制源存储帐户的文件共享名称。
| 属性 | 值 |
|---|---|
| Parameter group: | Copy source Arguments |
将传递到 azcopy 的其他选项，因为它是。 请在一个 --之后放置所有额外的选项。
| 属性 | 值 |
|---|---|
| Parameter group: | Positional |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误，禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az storage remove
从Azure 存储中删除 blob 或文件。
az storage remove [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--container-name]
[--exclude-path]
[--exclude-pattern]
[--include-path]
[--include-pattern]
[--name]
[--path]
[--recursive]
[--sas-token]
[--share-name]示例
删除单个 Blob。
az storage remove -c mycontainer -n MyBlob删除整个虚拟目录。
az storage remove -c mycontainer -n path/to/directory --recursive仅删除虚拟目录中的顶部 Blob，而不是删除其子目录。
az storage remove -c mycontainer --recursive删除存储容器中的所有 Blob。
az storage remove -c mycontainer -n path/to/directory删除虚拟目录中的 blob 子集（例如，仅 jpg 和 pdf 文件，或者 Blob 名称为“exactName”且文件名不以“test”开头）。
az storage remove -c mycontainer --include-path path/to/directory --include-pattern "*.jpg;*.pdf;exactName" --exclude-pattern "test*" --recursive删除整个虚拟目录，但从范围中排除某些 blob（例如，以 foo 开头或以条结尾的每个 Blob）。
az storage remove -c mycontainer --include-path path/to/directory --exclude-pattern "foo*;*bar" --recursive删除单个文件。
az storage remove -s MyShare -p MyFile删除整个目录。
az storage remove -s MyShare -p path/to/directory --recursive删除存储文件共享中的所有文件。
az storage remove -s MyShare --recursive可选参数
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_KEY。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
存储帐户名称。 相关环境变量：AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在，该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令，可能会达到 API 配额限制。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数，则旧版“密钥”模式将尝试查询帐户密钥。 环境变量：AZURE_STORAGE_AUTH_MODE。
| 属性 | 值 |
|---|---|
| 接受的值: | key, login |
存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
容器名称。
排除这些路径。 此选项不支持通配符 \. 检查相对路径前缀。 例如：myFolder;myFolder/subDirName/file.pdf。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
排除名称与模式列表匹配的这些文件。 例如： .jpg;.pdf;exactName。 此选项支持通配符 (*)。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
仅包括这些路径。 此选项不支持通配符 \. 检查相对路径前缀。 例如：myFolder;myFolder/subDirName/file.pdf.
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
仅包含名称与模式列表匹配的这些文件。 例如： .jpg;.pdf;exactName。 此选项支持通配符 (*)。
| 属性 | 值 |
|---|---|
| Parameter group: | Additional Flags Arguments |
Blob 名称。
文件共享中文件的路径。
以递归方式查看子目录。
共享访问签名（SAS）。 必须与存储帐户名称结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。
| 属性 | 值 |
|---|---|
| Parameter group: | Storage Account Arguments |
文件共享名称。
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
仅显示错误，禁止显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
