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

az storage fs directory

管理 Azure Data Lake 存储 Gen2 帐户中的目录。

命令

名称 说明 类型 状态
az storage fs directory create

在 ADLS Gen2 文件系统中创建目录。

核心 GA
az storage fs directory delete

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

核心 GA
az storage fs directory download

将 ADLS Gen2 文件系统中的目录文件下载到本地文件路径。

核心 预览
az storage fs directory exists

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

核心 GA
az storage fs directory generate-sas

为 ADLS Gen2 帐户中的目录生成 SAS 令牌。

核心 GA
az storage fs directory list

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

核心 GA
az storage fs directory metadata

管理文件系统中目录的元数据。

核心 GA
az storage fs directory metadata show

返回指定目录的所有用户定义的元数据。

核心 GA
az storage fs directory metadata update

为指定的文件系统设置一个或多个用户定义的名称值对。

核心 GA
az storage fs directory move

在 ADLS Gen2 文件系统中移动目录。

核心 GA
az storage fs directory show

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

核心 GA
az storage fs directory upload

将文件或子目录上传到 ADLS Gen2 文件系统中的目录。

核心 预览

az storage fs directory create

在 ADLS Gen2 文件系统中创建目录。

az storage fs directory create --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--metadata]
                               [--permissions]
                               [--sas-token]
                               [--timeout]
                               [--umask]

示例

在 ADLS Gen2 文件系统中创建目录。

az storage fs directory create -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

通过 连接字符串 在 ADLS Gen2 文件系统中创建目录。

az storage fs directory create -n dir -f myfilesystem --connection-string myconnectionstring

必需参数

--file-system -f

文件系统名称(即容器名称)。

--name -n

目录的名称。

可选参数

--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。

--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 directory delete

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

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

示例

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

az storage fs directory delete -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

删除 ADLS Gen2 文件系统中的目录。 (自动生成)

az storage fs directory delete --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir --yes

必需参数

--file-system -f

文件系统名称(即容器名称)。

--name -n

目录的名称。

可选参数

--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 directory download

预览

此命令处于预览阶段,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

将 ADLS Gen2 文件系统中的目录文件下载到本地文件路径。

az storage fs directory download --destination-path
                                 --file-system
                                 [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--recursive]
                                 [--sas-token]
                                 [--source-path]

示例

在 ADLS Gen2 文件系统的目录中下载单个文件。

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s "path/to/file" -d "<local-path>"

下载整个 ADLS Gen2 文件系统。

az storage fs directory download -f myfilesystem --account-name mystorageaccount  -d "<local-path>" --recursive

下载 ADLS Gen2 文件系统中的整个目录。

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s SourceDirectoryPath -d "<local-path>" --recursive

在 ADLS Gen2 文件系统中下载整个子目录。

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s "path/to/subdirectory" -d "<local-path>" --recursive

必需参数

--destination-path -d

要下载的目标本地目录路径。

--file-system -f

下载源文件系统。

可选参数

--account-key

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

--account-name

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

--connection-string

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

--recursive -r

以递归方式下载文件。 如果启用,将下载所有文件(包括子目录中的文件)。

--sas-token

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

--source-path -s

下载源目录路径。 它应该是文件系统的绝对路径。

全局参数
--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 directory exists

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

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

示例

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

az storage fs directory exists -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

检查 ADLS Gen2 文件系统中是否存在目录。 (自动生成)

az storage fs directory exists --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir

必需参数

--file-system -f

文件系统名称(即容器名称)。

--name -n

目录的名称。

可选参数

--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 directory generate-sas

为 ADLS Gen2 帐户中的目录生成 SAS 令牌。

az storage fs directory generate-sas --file-system
                                     --name
                                     [--account-key]
                                     [--account-name]
                                     [--as-user]
                                     [--auth-mode {key, login}]
                                     [--blob-endpoint]
                                     [--cache-control]
                                     [--connection-string]
                                     [--content-disposition]
                                     [--content-encoding]
                                     [--content-language]
                                     [--content-type]
                                     [--encryption-scope]
                                     [--expiry]
                                     [--full-uri]
                                     [--https-only]
                                     [--ip]
                                     [--permissions]
                                     [--policy-name]
                                     [--start]

示例

为目录生成 SAS 令牌,并使用它上传文件。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage fs directory generate-sas --name dir/ --file-system myfilesystem --https-only --permissions dlrw --expiry $end -o tsv

必需参数

--file-system -f

文件系统名称(即容器名称)。

--name -n

目录的名称。

可选参数

--account-key

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

--account-name

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

--as-user

指示此命令返回使用用户委托密钥签名的 SAS。 如果指定此参数,则需要过期参数和“--auth-mode login”。

默认值: False
--auth-mode

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

接受的值: key, login
--blob-endpoint

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

--cache-control

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

--connection-string

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

--content-disposition

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

--content-encoding

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

--content-language

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

--content-type

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

--encryption-scope

指定发出的请求的加密范围,以便对所有写入操作进行服务加密。

--expiry

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

--full-uri

指示此命令返回完整的 Blob URI 和共享访问签名令牌。

默认值: False
--https-only

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

--ip

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

--permissions

SAS 授予的权限。 允许的值:(a)dd (c)reate (d)elete (e)xecute (l)ist (m)ove (o)wnership (p)ermissions (r)ead (w)rite. 如果使用指定此值的 --id 引用存储访问策略,请不要使用。 可以组合使用。

--policy-name

存储访问策略的名称。

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

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

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

示例

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

az storage fs directory list -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

列出 ADLS Gen2 文件系统的“dir/”中的目录。

az storage fs directory list --path dir -f myfilesystem --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。

--num-results

指定要返回的最大结果数。

--path

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

--recursive

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

接受的值: 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 directory move

在 ADLS Gen2 文件系统中移动目录。

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

示例

在 ADLS Gen2 文件系统中移动目录。

az storage fs directory move --new-directory newfs/dir -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

在 ADLS Gen2 文件系统中移动目录。 (自动生成)

az storage fs directory move --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir --new-directory newfs/dir

必需参数

--file-system -f

文件系统名称(即容器名称)。

--name -n

目录的名称。

--new-directory -d

用户希望移动到的新目录名称。 该值必须采用以下格式:“{filesystem}/{directory}/{subdirectory}”。

可选参数

--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 directory show

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

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

示例

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

az storage fs directory show -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

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

az storage fs directory show -n dir/subdir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

显示 ADLS Gen2 文件系统中目录的属性。 (自动生成)

az storage fs directory show --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir

必需参数

--file-system -f

文件系统名称(即容器名称)。

--name -n

目录的名称。

可选参数

--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 directory upload

预览

此命令处于预览阶段,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus

将文件或子目录上传到 ADLS Gen2 文件系统中的目录。

az storage fs directory upload --file-system
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--destination-path]
                               [--recursive]
                               [--sas-token]

示例

将单个文件上传到存储 Blob 目录。

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/file" -d directory

将本地目录上传到 ADLS Gen2 文件系统中的根目录。

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/directory" --recursive

将本地目录上传到 ADLS Gen2 文件系统中的目录。

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/directory" -d directory --recursive

将本地目录中的一组文件上传到 ADLS Gen2 文件系统中的目录。

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/file*" -d directory --recursive

必需参数

--file-system -f

上传目标文件系统。

--source -s

要从中上传的源文件路径。

可选参数

--account-key

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

--account-name

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

--connection-string

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

--destination-path -d

上传目标目录路径。 它应该是文件系统的绝对路径。 如果指定的目标路径不存在,则将创建新的目录路径。

--recursive -r

以递归方式上传文件。 如果启用,将上传所有文件(包括子目录中的文件)。

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