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

az storage fs file

管理 Azure Data Lake 存储 Gen2 帐户中的文件。

命令

名称	说明	类型	状态
az storage fs file append	将内容追加到 ADLS Gen2 文件系统中的文件。	核心	GA
az storage fs file create	在 ADLS Gen2 文件系统中创建新文件。	核心	GA
az storage fs file delete	删除 ADLS Gen2 文件系统中的文件。	核心	GA
az storage fs file download	从 ADLS Gen2 文件系统中的指定路径下载文件。	核心	GA
az storage fs file exists	检查 ADLS Gen2 文件系统中是否存在文件。	核心	GA
az storage fs file list	列出 ADLS Gen2 文件系统中的文件和目录。	核心	GA
az storage fs file metadata	管理文件系统中文件的元数据。	核心	GA
az storage fs file metadata show	返回指定文件的所有用户定义的元数据。	核心	GA
az storage fs file metadata update	为指定的文件系统设置一个或多个用户定义的名称值对。	核心	GA
az storage fs file move	在 ADLS Gen2 帐户中移动文件。	核心	GA
az storage fs file set-expiry	设置文件过期并被删除的时间。	核心	GA
az storage fs file show	显示 ADLS Gen2 文件系统中的文件属性。	核心	GA
az storage fs file upload	将文件上传到 ADLS Gen2 文件系统中的文件路径。	核心	GA

az storage fs file append

将内容追加到 ADLS Gen2 文件系统中的文件。

az storage fs file append --content
                          --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]
                          [--timeout]

示例

将内容追加到 ADLS Gen2 文件系统中的文件。

az storage fs file append --content "test content test" -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--content

要追加到文件的内容。

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--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 fs file create

在 ADLS Gen2 文件系统中创建新文件。

az storage fs file create --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--content-cache]
                          [--content-disposition]
                          [--content-encoding]
                          [--content-language]
                          [--content-md5]
                          [--content-type]
                          [--metadata]
                          [--permissions]
                          [--sas-token]
                          [--timeout]
                          [--umask]

示例

在 ADLS Gen2 文件系统中创建新文件。

az storage fs file create -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

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

缓存控制字符串。

--content-disposition

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

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--metadata

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

--permissions

文件所有者、文件拥有组和其他文件的 POSIX 访问权限。 可以授予每个类读取（4）、写入（2）或执行 （1） 权限。 支持符号符号（rwxrw-rw-）和 4 位八进制表示法（例如 0766）。 粘性位也受支持，在符号表示法中，它由字母 t 或 T 表示，具体取决于其他类别的执行位是分别设置还是未设置（例如，带有粘滞位的 rwxrw-rw- 表示为 rwxrw-rwT）。带有粘滞位的 rwxrw-rwx 表示为 rwxrw-rwt），不存在 t 或 T 表示未设置粘滞位。 在 4 位八进制表示法中，它由第一位数字表示（例如 1766 表示具有粘性位的 rwxrw-rw），0766 表示 rwxrw-rw-without粘性位）。 有关详细信息，请参阅 https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#levels-of-permission。

--sas-token

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

--timeout

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

--umask

创建文件或目录时，父文件夹没有默认 ACL，umask 将限制要创建的文件或目录的权限。 生成的权限由 p 和 ^u 提供，其中 p 是权限，而你是 umask。 有关详细信息，请参阅 https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#umask。

全局参数

--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 fs file delete

删除 ADLS Gen2 文件系统中的文件。

az storage fs file delete --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]
                          [--timeout]
                          [--yes]

示例

删除 ADLS Gen2 文件系统中的文件。

az storage fs file delete -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--sas-token

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

--timeout

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

--yes -y

不提示确认。

默认值: 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 fs file download

从 ADLS Gen2 文件系统中的指定路径下载文件。

az storage fs file download --file-system
                            --path
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--destination]
                            [--overwrite {false, true}]
                            [--sas-token]
                            [--timeout]

示例

将 ADLS Gen2 文件系统中的文件下载到当前路径。

az storage fs file download -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

将 ADLS Gen2 文件系统中的文件下载到指定的目录。

az storage fs file download -p dir/a.txt -d test/ -f fsname --account-name myadlsaccount --account-key 0000-0000

将 ADLS Gen2 文件系统中的文件下载到指定的文件路径。

az storage fs file download -p dir/a.txt -d test/b.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--destination -d

将文件或文件夹下载到的本地文件。 如果未指定，将使用源文件名。

--overwrite

指定时覆盖现有文件。 默认值为 false。

接受的值: false, true

默认值: True

--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 fs file exists

检查 ADLS Gen2 文件系统中是否存在文件。

az storage fs file exists --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]
                          [--timeout]

示例

检查 ADLS Gen2 文件系统中是否存在文件。

az storage fs file exists -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--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 fs file list

列出 ADLS Gen2 文件系统中的文件和目录。

az storage fs file list --file-system
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--exclude-dir]
                        [--marker]
                        [--num-results]
                        [--path]
                        [--recursive {false, true}]
                        [--sas-token]
                        [--show-next-marker]
                        [--timeout]

示例

列出 ADLS Gen2 文件系统中的文件和目录。

az storage fs file list -f fsname --account-name myadlsaccount --account-key 0000-0000

列出 ADLS Gen2 文件系统中的文件。

az storage fs file list --exclude-dir -f fsname --account-name myadlsaccount --account-key 0000-0000

列出指定路径中的文件和目录。

az storage fs file list --path dir -f fsname --account-name myadlsaccount --account-key 0000-0000

列出特定标记中的文件和目录。

az storage fs file list --marker "VBaS6LvPufaqrTANTQvbmV3dHJ5FgAAAA==" -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--exclude-dir

仅列出给定文件系统中的文件。

--marker

不透明的延续标记。 可以从上一个生成器对象的next_marker字段中检索此值。 如果指定，此生成器将从此点开始返回结果。

--num-results

指定要返回的最大结果数。 如果请求未指定num_results或指定大于 5,000 的值，服务器将返回最多 5,000 个项目。

默认值: 5000

--path

筛选结果以仅返回指定路径下的路径。

--recursive

设置为 true 时，以递归方式查看子目录。

接受的值: false, true

默认值: True

--sas-token

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

--show-next-marker

预览

指定后，在结果中显示 nextMarker。

--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 fs file move

在 ADLS Gen2 帐户中移动文件。

az storage fs file move --file-system
                        --new-path
                        --path
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--content-cache]
                        [--content-disposition]
                        [--content-encoding]
                        [--content-language]
                        [--content-md5]
                        [--content-type]
                        [--sas-token]

示例

在 ADLS Gen2 帐户中移动文件。

az storage fs file move --new-path new-fs/new-dir/b.txt -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

--new-path

用户希望移动到的新路径。 该值必须采用以下格式：“{filesystem}/{directory}/{subdirectory}/{file}”。

--path -p

用户希望在文件系统中移动的原始文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

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

缓存控制字符串。

--content-disposition

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

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--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 fs file set-expiry

设置文件过期并被删除的时间。

az storage fs file set-expiry --expiry-options {Absolute, NeverExpire, RelativeToCreation, RelativeToNow}
                              --file-system
                              --path
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--connection-string]
                              [--expires-on]
                              [--sas-token]
                              [--timeout]

必需参数

--expiry-options

必需。 指示到期时间的模式。 可能的值包括：“NeverExpire”、“RelativeToCreation”、“RelativeToNow”、“Absolute”。

接受的值: Absolute, NeverExpire, RelativeToCreation, RelativeToNow

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--expires-on

将文件设置为过期的时间。 当expiry_options为 RelativeTo* 时，expires_on应为以毫秒为单位的 int。 如果expires_on的类型为日期/时间，则它应为 UTC 时间。

--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 fs file show

显示 ADLS Gen2 文件系统中的文件属性。

az storage fs file show --file-system
                        --path
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--sas-token]
                        [--timeout]

示例

显示 ADLS Gen2 文件系统中的文件属性。

az storage fs file show -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

显示 ADLS Gen2 文件系统中的文件属性。 （自动生成）

az storage fs file show --account-name myadlsaccount --auth-mode login --file-system fsname --path dir/a.txt

必需参数

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

--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 fs file upload

将文件上传到 ADLS Gen2 文件系统中的文件路径。

az storage fs file upload --file-system
                          --path
                          --source
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--content-cache]
                          [--content-disposition]
                          [--content-encoding]
                          [--content-language]
                          [--content-md5]
                          [--content-type]
                          [--if-match]
                          [--if-modified-since]
                          [--if-none-match]
                          [--if-unmodified-since]
                          [--metadata]
                          [--overwrite {false, true}]
                          [--permissions]
                          [--sas-token]
                          [--timeout]
                          [--umask]

示例

将文件从本地路径上传到 ADLS Gen2 文件系统中的文件路径。

az storage fs file upload --source a.txt -p dir/a.txt -f fsname --account-name myadlsaccount --account-key 0000-0000

必需参数

--file-system -f

文件系统名称（即容器名称）。

--path -p

文件系统中的文件路径。

--source -s

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

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

--blob-endpoint

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

--connection-string

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

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

缓存控制字符串。

--content-disposition

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

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--if-match

ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

--if-modified-since

仅当自提供的 UTC 日期时间（Y-m-d'T'H：M'Z'）修改后才开始。

--if-none-match

ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值不匹配时，才指定此标头来执行该操作。

--if-unmodified-since

仅当自提供的 UTC 日期时间（Y-m-d'T'H：M'Z'）以来未修改的开始时间。

--metadata

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

--overwrite

指定时覆盖现有文件。

接受的值: false, true

--permissions

文件所有者、文件拥有组和其他文件的 POSIX 访问权限。 可以授予每个类读取（4）、写入（2）或执行 （1） 权限。 支持符号符号（rwxrw-rw-）和 4 位八进制表示法（例如 0766）。 粘性位也受支持，在符号表示法中，它由字母 t 或 T 表示，具体取决于其他类别的执行位是分别设置还是未设置（例如，带有粘滞位的 rwxrw-rw- 表示为 rwxrw-rwT）。带有粘滞位的 rwxrw-rwx 表示为 rwxrw-rwt），不存在 t 或 T 表示未设置粘滞位。 在 4 位八进制表示法中，它由第一位数字表示（例如 1766 表示具有粘性位的 rwxrw-rw），0766 表示 rwxrw-rw-without粘性位）。 有关详细信息，请参阅 https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#levels-of-permission。

--sas-token

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

--timeout

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

--umask

创建文件或目录时，父文件夹没有默认 ACL，umask 将限制要创建的文件或目录的权限。 生成的权限由 p 和 ^u 提供，其中 p 是权限，而你是 umask。 有关详细信息，请参阅 https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#umask。

全局参数

--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 获取完整的调试日志。