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

az storage fs

参考

在 Azure Data Lake 存储 Gen2 帐户中管理文件系统。

命令

名称	说明	类型	状态
az storage fs access	管理 Azure Data Lake 存储 Gen2 帐户的文件系统访问权限和权限。	核心	GA
az storage fs access remove-recursive	删除 Azure Data Lake 存储 Gen2 帐户中路径和子路径上的访问控制。	核心	GA
az storage fs access set	在 Azure Data Lake 存储 Gen2 帐户中设置路径（目录或文件）的访问控制属性。	核心	GA
az storage fs access set-recursive	在 Azure Data Lake 存储 Gen2 帐户中的路径和子路径上设置访问控制。	核心	GA
az storage fs access show	在 Azure Data Lake 存储 Gen2 帐户中显示路径（目录或文件）的访问控制属性。	核心	GA
az storage fs access update-recursive	修改 Azure Data Lake 存储 Gen2 帐户中路径和子路径上的访问控制。	核心	GA
az storage fs create	为 Azure Data Lake 存储 Gen2 帐户创建文件系统。	核心	GA
az storage fs delete	删除 ADLS Gen2 帐户中的文件系统。	核心	GA
az storage fs directory	管理 Azure Data Lake 存储 Gen2 帐户中的目录。	核心	GA
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 exists	检查 ADLS Gen2 帐户中是否存在文件系统。	核心	GA
az storage fs file	管理 Azure Data Lake 存储 Gen2 帐户中的文件。	核心	GA
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 generate-sas	在 ADLS Gen2 帐户中为文件系统生成 SAS 令牌。	核心	预览
az storage fs list	列出 ADLS Gen2 帐户中的文件系统。	核心	GA
az storage fs list-deleted-path	列出指定文件系统下的已删除（文件或目录）路径。	核心	GA
az storage fs metadata	管理文件系统的元数据。	核心	GA
az storage fs metadata show	返回指定文件系统的所有用户定义的元数据。	核心	GA
az storage fs metadata update	为指定的文件系统设置一个或多个用户定义的名称值对。	核心	GA
az storage fs service-properties	管理存储 Datalake 服务属性。	核心	GA
az storage fs service-properties show	显示存储帐户的数据湖服务的属性，包括 Azure 存储 Analytics。	核心	GA
az storage fs service-properties update	更新存储帐户的数据湖服务的属性，包括 Azure 存储 Analytics。	核心	GA
az storage fs show	在 ADLS Gen2 帐户中显示文件系统的属性。	核心	GA
az storage fs undelete-path	还原软删除的路径。	核心	GA

az storage fs create

编辑

为 Azure Data Lake 存储 Gen2 帐户创建文件系统。

az storage fs create --name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--connection-string]
                     [--default-encryption-scope]
                     [--metadata]
                     [--prevent-encryption-scope-override {false, true}]
                     [--public-access {file, filesystem, off}]
                     [--sas-token]
                     [--timeout]

示例

为 Azure Data Lake 存储 Gen2 帐户创建文件系统。

az storage fs create -n fsname --account-name mystorageaccount --account-key 0000-0000

为 Azure Data Lake 存储 Gen2 帐户创建文件系统并启用公共访问。

az storage fs create -n fsname --public-access file --account-name mystorageaccount --account-key 0000-0000

为 Azure Data Lake 存储 Gen2 帐户创建文件系统。（自动生成）

az storage fs create --account-name mystorageaccount --auth-mode login --name fsname

必需参数

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

--default-encryption-scope -d

指定要在文件系统上设置的默认加密范围，并用于将来的所有写入。

--metadata

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

--prevent-encryption-scope-override -p

如果为 true，则阻止任何请求指定与文件系统上设置的范围不同的加密范围。默认值为 false。

接受的值: false, true

--public-access

指定是否可以公开访问文件系统中的数据和访问级别。

接受的值: file, filesystem, off

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

编辑

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

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

示例

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

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

必需参数

--name -n

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

可选参数

--account-key

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

--account-name

--auth-mode

接受的值: key, login

--blob-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 exists

编辑

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

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

示例

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

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

必需参数

--name -n

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

可选参数

--account-key

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

--account-name

--auth-mode

接受的值: key, login

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

编辑

预览

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

在 ADLS Gen2 帐户中为文件系统生成 SAS 令牌。

az storage fs generate-sas --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 generate-sas -n myfilesystem --https-only --permissions dlrw --expiry $end -o tsv

必需参数

--name -n

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

可选参数

--account-key

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

--account-name

--as-user

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

默认值: False

--auth-mode

接受的值: key, login

--blob-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 list

编辑

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

az storage fs list [--account-key]
                   [--account-name]
                   [--auth-mode {key, login}]
                   [--blob-endpoint]
                   [--connection-string]
                   [--include-metadata {false, true}]
                   [--prefix]
                   [--sas-token]

示例

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

az storage fs list --account-name myadlsaccount --account-key 0000-0000

可选参数

--account-key

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

--account-name

--auth-mode

接受的值: key, login

--blob-endpoint

--connection-string

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

--include-metadata

指定在响应中返回文件系统元数据。默认值为“False”。

接受的值: false, true

--prefix

筛选结果以仅返回名称以指定前缀开头的文件系统。

--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 list-deleted-path

编辑

列出指定文件系统下的已删除（文件或目录）路径。

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

示例

列出指定的文件系统下已删除的（文件或目录）路径。

az storage fs list-deleted-path -f myfilesystem --account-name mystorageccount --account-key 00000000

必需参数

--file-system -f

文件系统名称。

可选参数

--account-key

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

--account-name

--auth-mode

接受的值: key, login

--blob-endpoint

--connection-string

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

--marker

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

--num-results

指定要返回的最大数字。

--path-prefix

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

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

编辑

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

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

示例

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

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

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

az storage fs show --account-name myadlsaccount --auth-mode login --name myfilesystem

必需参数

--name -n

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

可选参数

--account-key

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

--account-name

--auth-mode

接受的值: key, login

--blob-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 undelete-path

编辑

还原软删除的路径。

仅当在删除保留策略中设置的指定天数内使用时，操作才会成功。

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

示例

还原软删除的路径。

az storage fs undelete-path -f myfilesystem --deleted-path-name dir --deletion-id 0000 --account-name mystorageccount --account-key 00000000

必需参数

--deleted-path-name

指定要还原的路径（文件或目录）。

--deletion-id

指定要还原的已删除路径的版本。：关键字 (keyword) int timeout：超时参数以秒为单位表示。

--file-system -f

文件系统名称。

可选参数

--account-key

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

--account-name

--auth-mode

接受的值: key, login

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

命令

az storage fs create

示例

必需参数

可选参数

az storage fs delete

示例

必需参数

可选参数

az storage fs exists

示例

必需参数

可选参数

az storage fs generate-sas

示例

必需参数

可选参数

az storage fs list

示例

可选参数

az storage fs list-deleted-path

示例

必需参数

可选参数

az storage fs show

示例

必需参数

可选参数

az storage fs undelete-path

示例

必需参数

可选参数

反馈

其他资源