你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az storage file

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展,使其受益于其扩展功能。 详细了解扩展。

管理使用 SMB 3.0 协议的文件共享。

命令

名称 说明 类型 状态
az storage file copy

管理文件复制操作。

核心和扩展 GA
az storage file copy cancel

中止正在进行的复制操作。

核心 GA
az storage file copy cancel (storage-preview 扩展)

中止正在进行的复制操作。

分机 预览
az storage file copy start

异步复制文件。

核心 GA
az storage file copy start (storage-preview 扩展)

异步复制文件。

扩展 预览
az storage file copy start-batch

将多个文件或 Blob 复制到文件共享。

核心 GA
az storage file copy start-batch (storage-preview 扩展)

将多个文件或 Blob 复制到文件共享。

分机 预览
az storage file delete

标记要删除的指定文件。

核心 GA
az storage file delete (storage-preview 扩展)

标记要删除的指定文件。

分机 预览
az storage file delete-batch

从Azure 存储文件共享中删除文件。

核心 GA
az storage file delete-batch (storage-preview 扩展)

从Azure 存储文件共享中删除文件。

分机 预览版
az storage file download

使用自动分块和进度通知将文件下载到文件路径。

核心 GA
az storage file download (storage-preview 扩展)

使用自动分块和进度通知将文件下载到文件路径。

扩展 预览版
az storage file download-batch

在批处理操作中,将Azure 存储文件共享中的文件下载到本地目录。

核心 GA
az storage file download-batch (storage-preview 扩展)

在批处理操作中,将Azure 存储文件共享中的文件下载到本地目录。

分机 预览
az storage file exists

检查文件是否存在。

核心 GA
az storage file exists (storage-preview 扩展)

检查文件是否存在。

扩展 预览
az storage file generate-sas

为文件生成共享访问签名。

核心 GA
az storage file generate-sas (storage-preview 扩展)

为文件生成共享访问签名。

扩展 预览
az storage file list

列出共享中的文件和目录。

核心 GA
az storage file list (storage-preview 扩展)

列出共享中的文件和目录。

扩展 预览
az storage file metadata

管理文件元数据。

核心和扩展 GA
az storage file metadata show

返回文件的所有用户定义的元数据。

核心 GA
az storage file metadata show (storage-preview 扩展)

返回文件的所有用户定义的元数据。

分机 预览
az storage file metadata update

更新文件元数据。

核心 GA
az storage file metadata update (storage-preview 扩展)

更新文件元数据。

分机 预览
az storage file resize

将文件的大小调整为指定大小。

核心 GA
az storage file resize (storage-preview 扩展)

将文件的大小调整为指定大小。

分机 预览
az storage file show

返回文件的所有用户定义的元数据、标准 HTTP 属性和系统属性。

核心 GA
az storage file show (storage-preview 扩展)

返回文件的所有用户定义的元数据、标准 HTTP 属性和系统属性。

分机 预览
az storage file update

在文件上设置系统属性。

核心 GA
az storage file update (storage-preview 扩展)

在文件上设置系统属性。

分机 预览版
az storage file upload

将文件上传到使用 SMB 3.0 协议的共享。

核心 GA
az storage file upload (storage-preview 扩展)

将文件上传到使用 SMB 3.0 协议的共享。

分机 预览
az storage file upload-batch

在批处理操作中,将文件从本地目录上传到Azure 存储文件共享。

核心 GA
az storage file upload-batch (storage-preview 扩展)

在批处理操作中,将文件从本地目录上传到Azure 存储文件共享。

分机 预览版
az storage file url

创建 URL 以访问文件。

核心 GA
az storage file url (storage-preview 扩展)

创建 URL 以访问文件。

扩展 预览

az storage file delete

标记要删除的指定文件。

该文件稍后将在垃圾回收期间删除。

az storage file delete --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file delete (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

标记要删除的指定文件。

该文件稍后将在垃圾回收期间删除。

az storage file delete --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--timeout]

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file delete-batch

从Azure 存储文件共享中删除文件。

az storage file delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--backup-intent]
                             [--connection-string]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--file-endpoint]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

示例

从Azure 存储文件共享中删除文件。 (自动生成)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --source /path/to/file

从Azure 存储文件共享中删除文件。 (自动生成)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --pattern "*.py" --source /path/to/file

必需参数

--source -s

文件删除操作的源。 源可以是文件共享 URL 或共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--dryrun

列出要删除的文件和 Blob。 不会发生实际数据删除。

默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--pattern

用于文件填充的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file delete-batch (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

从Azure 存储文件共享中删除文件。

az storage file delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--backup-intent]
                             [--connection-string]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

示例

从Azure 存储文件共享中删除文件。 (自动生成)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --source /path/to/file

从Azure 存储文件共享中删除文件。 (自动生成)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --pattern *.py --source /path/to/file

必需参数

--source -s

文件删除操作的源。 源可以是文件共享 URL 或共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--dryrun

列出要删除的文件和 Blob。 不会发生实际数据删除。

默认值: False
--pattern

用于文件填充的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file download

使用自动分块和进度通知将文件下载到文件路径。

返回包含属性和元数据的文件实例。

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--backup-intent]
                         [--connection-string]
                         [--dest]
                         [--disallow-trailing-dot {false, true}]
                         [--end-range]
                         [--file-endpoint]
                         [--max-connections]
                         [--no-progress]
                         [--open-mode]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--timeout]
                         [--validate-content]

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--dest

要写入的文件的路径。 如果未指定,将使用源文件名。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--end-range

要用于下载文件的节的字节范围的结束。 如果给定了 --end-range,则必须提供 --start-range。 --start-range 和 --end-range 参数是包容性的。 例如:--start-range=0,--end-range=511 将下载前 512 字节的文件。

--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--max-connections

要使用的并行连接的最大数目。

默认值: 2
--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--open-mode

打开文件时要使用的模式。 请注意,仅指定追加open_mode会阻止并行下载。 因此,如果使用此 --open-mode,则必须将 --max-connections 设置为 1。

默认值: wb
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--start-range

要用于下载文件的节的字节范围的开始。 如果未提供 --end-range,则会下载 --start-range 之后的所有字节。 --start-range 和 --end-range 参数是包容性的。 例如:--start-range=0,--end-range=511 将下载前 512 字节的文件。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

--validate-content

如果设置为 true,则验证文件的每个检索部分的 MD5 哈希。 如果使用 http 而不是 https 作为 https(默认值)已经验证,则这主要用于检测网络上的位剪辑。 由于区块大小减少,计算 MD5 需要处理时间,因此需要执行更多请求,延迟可能会增加一些。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file download (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

使用自动分块和进度通知将文件下载到文件路径。

返回包含属性和元数据的文件实例。

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--backup-intent]
                         [--connection-string]
                         [--dest]
                         [--disallow-trailing-dot {false, true}]
                         [--end-range]
                         [--max-connections]
                         [--no-progress]
                         [--open-mode]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--timeout]
                         [--validate-content]

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--dest

要写入的文件的路径。 如果未指定,将使用源文件名。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--end-range

要用于下载文件的节的字节范围的结束。 如果给定了 --end-range,则必须提供 --start-range。 --start-range 和 --end-range 参数是包容性的。 例如:--start-range=0,--end-range=511 将下载前 512 字节的文件。

--max-connections

要使用的并行连接的最大数目。

默认值: 2
--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--open-mode

打开文件时要使用的模式。 请注意,仅指定追加open_mode会阻止并行下载。 因此,如果使用此 --open-mode,则必须将 --max-connections 设置为 1。

默认值: wb
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--start-range

要用于下载文件的节的字节范围的开始。 如果未提供 --end-range,则会下载 --start-range 之后的所有字节。 --start-range 和 --end-range 参数是包容性的。 例如:--start-range=0,--end-range=511 将下载前 512 字节的文件。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

--validate-content

如果设置为 true,则验证文件的每个检索部分的 MD5 哈希。 如果使用 http 而不是 https 作为 https(默认值)已经验证,则这主要用于检测网络上的位剪辑。 由于区块大小减少,计算 MD5 需要处理时间,因此需要执行更多请求,延迟可能会增加一些。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file download-batch

在批处理操作中,将Azure 存储文件共享中的文件下载到本地目录。

az storage file download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--disallow-trailing-dot {false, true}]
                               [--dryrun]
                               [--file-endpoint]
                               [--max-connections]
                               [--no-progress]
                               [--pattern]
                               [--sas-token]
                               [--snapshot]
                               [--validate-content]

示例

在批处理操作中,将Azure 存储文件共享中的文件下载到本地目录。 (自动生成)

az storage file download-batch --account-key 00000000 --account-name MyAccount --destination . --no-progress --source /path/to/file

必需参数

--destination -d

文件下载到的本地目录。 此目录必须已存在。

--source -s

文件下载操作的源。 源可以是文件共享 URL 或共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--dryrun

列出要下载的文件和 Blob。 不会发生实际数据传输。

默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--max-connections

要使用的并行连接的最大数目。 默认值为 1。

默认值: 1
--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--pattern

用于文件填充的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--validate-content

如果已设置,则计算文件的每个范围的 MD5 哈希进行验证。

存储服务检查已到达的内容的哈希与发送的哈希相同。 如果使用 HTTP 而不是 HTTPS,则这在传输过程中检测位剪辑最为有用。 此哈希未存储。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file download-batch (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

在批处理操作中,将Azure 存储文件共享中的文件下载到本地目录。

az storage file download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--disallow-trailing-dot {false, true}]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--pattern]
                               [--sas-token]
                               [--snapshot]
                               [--validate-content]

示例

在批处理操作中,将Azure 存储文件共享中的文件下载到本地目录。 (自动生成)

az storage file download-batch --account-key 00000000 --account-name MyAccount --destination . --no-progress --source /path/to/file

必需参数

--destination -d

文件下载到的本地目录。 此目录必须已存在。

--source -s

文件下载操作的源。 源可以是文件共享 URL 或共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--dryrun

列出要下载的文件和 Blob。 不会发生实际数据传输。

默认值: False
--max-connections

要使用的并行连接的最大数目。 默认值为 1。

默认值: 1
--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--pattern

用于文件填充的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--validate-content

如果已设置,则计算文件的每个范围的 MD5 哈希进行验证。

存储服务检查已到达的内容的哈希与发送的哈希相同。 如果使用 HTTP 而不是 HTTPS,则这在传输过程中检测位剪辑最为有用。 此哈希未存储。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file exists

检查文件是否存在。

az storage file exists --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

示例

检查文件是否存在。 (自动生成)

az storage file exists --account-key 00000000 --account-name MyAccount --path path/file.txt --share-name MyShare

检查文件是否存在。 (自动生成)

az storage file exists --connection-string $connectionString --path path/file.txt --share-name MyShare

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file exists (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

检查文件是否存在。

az storage file exists --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

示例

检查文件是否存在。 (自动生成)

az storage file exists --account-key 00000000 --account-name MyAccount --path path/file.txt --share-name MyShare

检查文件是否存在。 (自动生成)

az storage file exists --connection-string $connectionString --path path/file.txt --share-name MyShare

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file generate-sas

为文件生成共享访问签名。

az storage file generate-sas --path
                             --share-name
                             [--account-key]
                             [--account-name]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--disallow-trailing-dot {false, true}]
                             [--expiry]
                             [--file-endpoint]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--start]

示例

为文件生成 SAS 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage file generate-sas -p path/file.txt -s MyShare --account-name MyStorageAccount --permissions rcdw --https-only --expiry $end

为文件生成共享访问签名。 (自动生成)

az storage file generate-sas --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --path path/file.txt --permissions rcdw --share-name MyShare --start 2019-01-01T12:20Z

为文件生成共享访问签名。 (自动生成)

az storage file generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2037-12-31T23:59:00Z --https-only --path path/file.txt --permissions rcdw --share-name myshare

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--cache-control

使用此共享访问签名访问资源时,Cache-Control 的响应标头值。

--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

使用此共享访问签名访问资源时,Content-Disposition 的响应标头值。

--content-encoding

使用此共享访问签名访问资源时,内容编码的响应标头值。

--content-language

使用此共享访问签名访问资源时,Content-Language 的响应标头值。

--content-type

使用此共享访问签名访问资源时,Content-Type 的响应标头值。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--expiry

指定 SAS 无效的 UTC 日期时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。

--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--https-only

仅允许使用 HTTPS 协议发出的请求。 如果省略,则允许来自 HTTP 和 HTTPS 协议的请求。

--ip

指定要从中接受请求的 IP 地址或 IP 地址范围。 仅支持 IPv4 样式地址。

--permissions

SAS 授予的权限。 允许的值:(c)reate (d)elete (r)ead (w)rite。 如果使用指定此值的 --id 引用存储访问策略,请不要使用。 可以组合使用。

--policy-name

容器 ACL 中存储的访问策略的名称。

--start

指定 SAS 生效的 UTC 日期/时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。 默认为请求的时间。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file generate-sas (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

为文件生成共享访问签名。

az storage file generate-sas --path
                             --share-name
                             [--account-key]
                             [--account-name]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--disallow-trailing-dot {false, true}]
                             [--expiry]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--start]

示例

为文件生成 SAS 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage file generate-sas -p path/file.txt -s MyShare --account-name MyStorageAccount --permissions rcdw --https-only --expiry $end

为文件生成共享访问签名。 (自动生成)

az storage file generate-sas --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --path path/file.txt --permissions rcdw --share-name MyShare --start 2019-01-01T12:20Z

为文件生成共享访问签名。 (自动生成)

az storage file generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2037-12-31T23:59:00Z --https-only --path path/file.txt --permissions rcdw --share-name myshare

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--cache-control

使用此共享访问签名访问资源时,Cache-Control 的响应标头值。

--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

使用此共享访问签名访问资源时,Content-Disposition 的响应标头值。

--content-encoding

使用此共享访问签名访问资源时,内容编码的响应标头值。

--content-language

使用此共享访问签名访问资源时,Content-Language 的响应标头值。

--content-type

使用此共享访问签名访问资源时,Content-Type 的响应标头值。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--expiry

指定 SAS 无效的 UTC 日期时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。

--https-only

仅允许使用 HTTPS 协议发出的请求。 如果省略,则允许来自 HTTP 和 HTTPS 协议的请求。

--ip

指定要从中接受请求的 IP 地址或 IP 地址范围。 仅支持 IPv4 样式地址。

--permissions

SAS 授予的权限。 允许的值:(c)reate (d)elete (r)ead (w)rite。 如果使用指定此值的 --id 引用存储访问策略,请不要使用。 可以组合使用。

--policy-name

容器 ACL 中存储的访问策略的名称。

--start

指定 SAS 生效的 UTC 日期/时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。 默认为请求的时间。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file list

列出共享中的文件和目录。

az storage file list --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--exclude-dir]
                     [--exclude-extended-info]
                     [--file-endpoint]
                     [--marker]
                     [--num-results]
                     [--path]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

示例

列出共享中的文件和目录。 (自动生成)

az storage file list --share-name MyShare

必需参数

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--exclude-dir

仅列出给定共享中的文件。

默认值: False
--exclude-extended-info

指定从响应中排除“timestamps”、“Etag”、“Attributes”、“PermissionKey”信息。

默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--marker

一个字符串值,该值标识要在下一个列表操作中返回的容器列表部分。 如果列表操作未返回剩余的所有容器,则返回响应正文中的 NextMarker 值,该容器将随当前页一起列出。 如果指定,此生成器将从上一个生成器停止的点开始返回结果。

--num-results

指定要返回的最大数字。 如果请求未指定num_results,或指定大于 5000 的值,服务器将返回最多 5000 个项目。 请注意,如果列表操作跨越分区边界,则服务将返回一个继续标记,用于检索其余结果。 提供“*”以全部返回。

默认值: 5000
--path -p

文件共享中的目录路径。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file list (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

列出共享中的文件和目录。

az storage file list --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--exclude-dir]
                     [--exclude-extended-info]
                     [--marker]
                     [--num-results]
                     [--path]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

示例

列出共享中的文件和目录。 (自动生成)

az storage file list --share-name MyShare

必需参数

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--exclude-dir

仅列出给定共享中的文件。

默认值: False
--exclude-extended-info

指定从响应中排除“timestamps”、“Etag”、“Attributes”、“PermissionKey”信息。

默认值: False
--marker

一个字符串值,该值标识要在下一个列表操作中返回的容器列表部分。 如果列表操作未返回剩余的所有容器,则返回响应正文中的 NextMarker 值,该容器将随当前页一起列出。 如果指定,此生成器将从上一个生成器停止的点开始返回结果。

--num-results

指定要返回的最大结果数。 提供“*”以全部返回。

默认值: 5000
--path -p

文件共享中的目录路径。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file resize

将文件的大小调整为指定大小。

如果指定的字节值小于文件的当前大小,则会清除指定字节值上方的所有范围。

az storage file resize --path
                       --share-name
                       --size
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

--size

要调整文件的大小(以字节为单位)。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file resize (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

将文件的大小调整为指定大小。

如果指定的字节值小于文件的当前大小,则会清除指定字节值上方的所有范围。

az storage file resize --path
                       --share-name
                       --size
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--timeout]

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

--size

要调整文件的大小(以字节为单位)。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file show

返回文件的所有用户定义的元数据、标准 HTTP 属性和系统属性。

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--file-endpoint]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

示例

显示文件共享中的文件属性。

az storage file show -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file show (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

返回文件的所有用户定义的元数据、标准 HTTP 属性和系统属性。

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

示例

显示文件共享中的文件属性。

az storage file show -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串(如果适用)。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file update

在文件上设置系统属性。

如果为content_settings设置了一个属性,则会重写所有属性。

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

示例

在文件上设置系统属性。

az storage file update -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000 --content-type test/type

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--clear-content-settings

如果设置了此标志,则设置以下任何一个或多个属性(--content-cache-control、--content-disposition、-content-encoding、--content-language、--content-md5、--content-type)时,所有这些属性都设置在一起。 如果在设置以下至少一个属性时未为给定属性提供值,则将清除该属性。

接受的值: false, true
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

缓存控制字符串。

--content-disposition

传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file update (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

在文件上设置系统属性。

如果为content_settings设置了一个属性,则会重写所有属性。

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--timeout]

示例

在文件上设置系统属性。

az storage file update -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000 --content-type test/type

必需参数

--path -p

文件共享中文件的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--clear-content-settings

如果设置了此标志,则设置以下任何一个或多个属性(--content-cache-control、--content-disposition、-content-encoding、--content-language、--content-md5、--content-type)时,所有这些属性都设置在一起。 如果在设置以下至少一个属性时未为给定属性提供值,则将清除该属性。

接受的值: false, true
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

缓存控制字符串。

--content-disposition

传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file upload

将文件上传到使用 SMB 3.0 协议的共享。

使用自动分块和进度通知从源路径创建或更新 Azure 文件。

az storage file upload --source
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--file-url]
                       [--max-connections]
                       [--metadata]
                       [--no-progress]
                       [--path]
                       [--sas-token]
                       [--share-name]
                       [--timeout]
                       [--validate-content]

示例

上传到本地文件到共享。

az storage file upload -s MyShare --source /path/to/file

将文件上传到使用 SMB 3.0 协议的共享。 (自动生成)

az storage file upload --account-key 00000000 --account-name MyStorageAccount --path path/file.txt --share-name MyShare --source /path/to/file

必需参数

--source

要作为文件内容上传的本地文件的路径。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

缓存控制字符串。

--content-disposition

传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--file-url

文件的完整终结点 URL,包括 SAS 令牌(如果使用)。

--max-connections

要使用的并行连接的最大数目。

默认值: 2
--metadata

空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。

--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--path -p

文件共享中文件的路径。 如果省略文件名,将使用源文件名称。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--share-name -s

文件共享名称。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

--validate-content

如果为 true,则计算文件的每个范围的 MD5 哈希。 存储服务检查已随发送的哈希一起到达的内容的哈希。 如果使用 http 而不是 https 作为 https(默认值)已经验证,则这主要用于检测网络上的位剪辑。 请注意,此 MD5 哈希未随文件一起存储。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file upload (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

将文件上传到使用 SMB 3.0 协议的共享。

使用自动分块和进度通知从源路径创建或更新 Azure 文件。

az storage file upload --share-name
                       --source
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--max-connections]
                       [--metadata]
                       [--no-progress]
                       [--path]
                       [--sas-token]
                       [--timeout]
                       [--validate-content]

示例

上传到本地文件到共享。

az storage file upload -s MyShare --source /path/to/file

将文件上传到使用 SMB 3.0 协议的共享。 (自动生成)

az storage file upload --account-key 00000000 --account-name MyStorageAccount --path path/file.txt --share-name MyShare --source /path/to/file

必需参数

--share-name -s

文件共享名称。

--source

要作为文件内容上传的本地文件的路径。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

缓存控制字符串。

--content-disposition

传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--max-connections

要使用的并行连接的最大数目。

默认值: 2
--metadata

空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。

--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--path -p

文件共享中文件的路径。 如果省略文件名,将使用源文件名称。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--timeout

请求超时(以秒为单位)。 适用于对服务的每个调用。

--validate-content

如果为 true,则计算文件的每个范围的 MD5 哈希。 存储服务检查已随发送的哈希一起到达的内容的哈希。 如果使用 http 而不是 https 作为 https(默认值)已经验证,则这主要用于检测网络上的位剪辑。 请注意,此 MD5 哈希未随文件一起存储。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file upload-batch

在批处理操作中,将文件从本地目录上传到Azure 存储文件共享。

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--file-endpoint]
                             [--max-connections]
                             [--metadata]
                             [--no-progress]
                             [--pattern]
                             [--sas-token]
                             [--validate-content]

示例

在批处理操作中,将文件从本地目录上传到Azure 存储文件共享。

az storage file upload-batch --destination myshare --source . --account-name myaccount --account-key 00000000

使用批处理操作中的 URL 将文件从本地目录上传到Azure 存储文件共享。

az storage file upload-batch --destination https://myaccount.file.core.windows.net/myshare --source . --account-key 00000000

必需参数

--destination -d

上传操作的目标。

目标可以是文件共享 URL 或共享名称。 当目标为共享 URL 时,将从 URL 分析存储帐户名称。

--source -s

要从中上传文件的目录。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

缓存控制字符串。

--content-disposition

传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--destination-path

将源数据复制到的目录。 如果省略,数据将复制到根目录。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--dryrun

列出要上传的文件和 Blob。 不会发生实际数据传输。

默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--max-connections

要使用的并行连接的最大数目。 默认值为 1。

默认值: 1
--metadata

空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。

--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--pattern

用于文件填充的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--validate-content

如果已设置,则计算文件的每个范围的 MD5 哈希进行验证。

存储服务检查已到达的内容的哈希与发送的哈希相同。 如果使用 HTTP 而不是 HTTPS,则这在传输过程中检测位剪辑最为有用。 此哈希未存储。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file upload-batch (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

在批处理操作中,将文件从本地目录上传到Azure 存储文件共享。

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--max-connections]
                             [--metadata]
                             [--no-progress]
                             [--pattern]
                             [--sas-token]
                             [--validate-content]

示例

在批处理操作中,将文件从本地目录上传到Azure 存储文件共享。

az storage file upload-batch --destination myshare --source . --account-name myaccount --account-key 00000000

使用批处理操作中的 URL 将文件从本地目录上传到Azure 存储文件共享。

az storage file upload-batch --destination https://myaccount.file.core.windows.net/myshare --source . --account-key 00000000

必需参数

--destination -d

上传操作的目标。

目标可以是文件共享 URL 或共享名称。 当目标为共享 URL 时,将从 URL 分析存储帐户名称。

--source -s

要从中上传文件的目录。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

缓存控制字符串。

--content-disposition

传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--destination-path

将源数据复制到的目录。 如果省略,数据将复制到根目录。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--dryrun

列出要上传的文件和 Blob。 不会发生实际数据传输。

默认值: False
--max-connections

要使用的并行连接的最大数目。 默认值为 1。

默认值: 1
--metadata

空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。

--no-progress

包括此标志以禁用命令的进度报告。

默认值: False
--pattern

用于文件填充的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。

--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

--validate-content

如果已设置,则计算文件的每个范围的 MD5 哈希进行验证。

存储服务检查已到达的内容的哈希与发送的哈希相同。 如果使用 HTTP 而不是 HTTPS,则这在传输过程中检测位剪辑最为有用。 此哈希未存储。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file url

创建 URL 以访问文件。

az storage file url --path
                    --share-name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--backup-intent]
                    [--connection-string]
                    [--disallow-trailing-dot {false, true}]
                    [--file-endpoint]
                    [--protocol {http, https}]
                    [--sas-token]

示例

创建 URL 以访问文件。 (自动生成)

az storage file url --account-key 00000000 --account-name mystorageaccount --path path/file.txt --share-name myshare

必需参数

--path -p

文件共享中文件/目录的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。

--protocol

要使用的协议。

接受的值: http, https
默认值: https
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage file url (storage-preview 扩展)

预览

命令组“az storage”处于预览状态,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

创建 URL 以访问文件。

az storage file url --path
                    --share-name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--backup-intent]
                    [--connection-string]
                    [--disallow-trailing-dot {false, true}]
                    [--protocol {http, https}]
                    [--sas-token]

示例

创建 URL 以访问文件。 (自动生成)

az storage file url --account-key 00000000 --account-name mystorageaccount --path path/file.txt --share-name myshare

必需参数

--path -p

文件共享中文件/目录的路径。

--share-name -s

文件共享名称。

可选参数

--account-key

存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。

--account-name

存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。

--auth-mode

运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

用于文件 OAuth (Azure AD) 身份验证所需的参数。 这将绕过任何文件/目录级别权限检查并允许访问,具体取决于允许的数据操作,即使这些文件/目录存在 ACL。

默认值: False
--connection-string

存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true,将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--protocol

要使用的协议。

接受的值: http, https
默认值: https
--sas-token

共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。