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

az storage blob

注意

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

管理非结构化数据 (blob) 的对象存储。

请为命令指定以下身份验证参数之一:--auth-mode、--account-key、--connection-string、--sas-token。 还可以使用相应的环境变量来存储身份验证凭据,例如AZURE_STORAGE_KEY、AZURE_STORAGE_CONNECTION_STRING和AZURE_STORAGE_SAS_TOKEN。

命令

名称 说明 类型 状态
az storage blob access

管理在启用分层命名空间时 blob 的访问控制属性。

扩展 预览和弃用
az storage blob access set

设置 Blob 的访问控制属性。

扩展 预览和弃用
az storage blob access show

显示 Blob 的访问控制属性。

扩展 预览和弃用
az storage blob access update

更新 Blob 的访问控制属性。

扩展 预览和弃用
az storage blob copy

管理 blob 复制操作。 用于az storage blob show检查 blob 的状态。

核心和扩展 GA
az storage blob copy cancel

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

核心 GA
az storage blob copy start

异步复制 Blob。 用于az storage blob show检查 blob 的状态。

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

启动复制 Blob 作业。

扩展 GA
az storage blob copy start-batch

将多个 Blob 复制到 Blob 容器。 用于az storage blob show检查 blob 的状态。

核心 GA
az storage blob delete

标记 blob 或快照以供删除。

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

标记 blob 或快照以供删除。

扩展 GA
az storage blob delete-batch

以递归方式从 Blob 容器中删除 Blob。

核心 GA
az storage blob directory

管理存储帐户容器中的 Blob 目录。

扩展 预览和弃用
az storage blob directory access

管理在启用分层命名空间时目录的访问控制属性。

扩展 预览和弃用
az storage blob directory access set

设置目录的访问控制属性。

扩展 预览和弃用
az storage blob directory access show

显示目录的访问控制属性。

扩展 预览和弃用
az storage blob directory access update

更新目录的访问控制属性。

扩展 预览和弃用
az storage blob directory create

在存储容器中创建存储 Blob 目录。

扩展 预览和弃用
az storage blob directory delete

删除存储容器中的存储 Blob 目录。

扩展 预览和弃用
az storage blob directory download

将 Blob 下载到本地文件路径。

扩展 预览和弃用
az storage blob directory exists

检查存储容器中是否存在 Blob 目录。

扩展 预览和弃用
az storage blob directory list

列出存储目录中的 Blob 和 Blob 子目录。

扩展 预览和弃用
az storage blob directory metadata

管理目录元数据。

扩展 预览和弃用
az storage blob directory metadata show

显示指定 Blob 目录的所有用户定义的元数据。

扩展 预览和弃用
az storage blob directory metadata update

将指定 Blob 目录的用户定义元数据设置为一个或多个名称值对。

扩展 预览和弃用
az storage blob directory move

将存储目录移到存储容器中的另一个存储 Blob 目录。

扩展 预览和弃用
az storage blob directory show

在存储容器中显示存储 Blob 目录属性。

扩展 预览和弃用
az storage blob directory upload

将 Blob 或子目录上传到存储 Blob 目录。

扩展 预览和弃用
az storage blob download

将 Blob 下载到文件路径。

核心 GA
az storage blob download-batch

以递归方式从 Blob 容器下载 Blob。

核心 GA
az storage blob exists

检查容器中是否存在 Blob。

核心 GA
az storage blob filter

列出标记与给定搜索表达式匹配的所有容器中的 blob。

扩展 预览
az storage blob generate-sas

为 Blob 生成共享访问签名。

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

为 Blob 生成共享访问签名。

扩展 GA
az storage blob immutability-policy

管理 Blob 不可变性策略。

核心 GA
az storage blob immutability-policy delete

删除 Blob 的不可变性策略。

核心 GA
az storage blob immutability-policy set

设置 Blob 的不可变性策略。

核心 GA
az storage blob incremental-copy

管理 blob 增量复制操作。

核心 GA
az storage blob incremental-copy cancel

中止挂起的copy_blob操作,并将目标 Blob 保留长度为零和完整元数据。

核心 GA
az storage blob incremental-copy start

异步复制 blob 的增量副本。

核心 GA
az storage blob lease

管理存储 blob 租约。

核心 GA
az storage blob lease acquire

请求新的租约。

核心 GA
az storage blob lease break

如果容器或 Blob 具有活动租约,则中断租约。

核心 GA
az storage blob lease change

更改活动租约的租约 ID。

核心 GA
az storage blob lease release

释放租约。

核心 GA
az storage blob lease renew

续订租约。

核心 GA
az storage blob list

列出给定容器中的 Blob。

核心 GA
az storage blob metadata

管理 blob 元数据。

核心 GA
az storage blob metadata show

返回指定 blob 或快照的所有用户定义的元数据。

核心 GA
az storage blob metadata update

将 Blob 的用户定义元数据设置为一个或多个名称值对。

核心 GA
az storage blob move

在存储容器中移动 Blob。

扩展 预览和弃用
az storage blob query

允许用户通过提供简单的查询表达式来选择/投影 blob 或 blob 快照数据。

核心 预览
az storage blob restore

还原指定 blob 范围内的 Blob。

核心 GA
az storage blob rewrite

创建一个新的块 Blob,其中从给定 URL 读取 Blob 的内容。

核心 预览
az storage blob service-properties

管理存储 blob 服务属性。

核心和扩展 GA
az storage blob service-properties delete-policy

管理存储 blob delete-policy 服务属性。

核心 GA
az storage blob service-properties delete-policy show

显示存储 blob 删除策略。

核心 GA
az storage blob service-properties delete-policy update

更新存储 Blob 删除策略。

核心 GA
az storage blob service-properties show

获取存储帐户的 Blob 服务的属性,包括Azure 存储分析。

核心 GA
az storage blob service-properties update

更新存储 blob 服务属性。

核心 GA
az storage blob service-properties update (storage-blob-preview 扩展)

更新存储 blob 服务属性。

扩展 GA
az storage blob set-legal-hold

设置 Blob 法定保留。

核心 GA
az storage blob set-tier

设置 Blob 上的块层或页层。

核心 GA
az storage blob set-tier (storage-blob-preview 扩展)

设置 Blob 上的块层或页层。

扩展 GA
az storage blob show

获取 Blob 的详细信息。

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

获取 Blob 的详细信息。

扩展 GA
az storage blob snapshot

创建 blob 的快照。

核心 GA
az storage blob sync

以递归方式将 blob 同步到存储 Blob 容器。

核心 预览
az storage blob tag

管理 Blob 标记。

扩展 预览
az storage blob tag list

获取 blob 或特定 Blob 版本的标记,或快照。

扩展 预览
az storage blob tag set

在 blob 或特定 blob 版本上设置标记,但不快照。

扩展 预览
az storage blob undelete

还原软删除的 blob 或快照。

核心 GA
az storage blob update

在 blob 上设置系统属性。

核心 GA
az storage blob upload

将文件上传到存储 Blob。

核心 GA
az storage blob upload-batch

将文件从本地目录上传到 Blob 容器。

核心 GA
az storage blob url

创建 URL 以访问 Blob。

核心 GA

az storage blob delete

标记 blob 或快照以供删除。

Blob 标记为以后在垃圾回收期间删除。 若要删除 blob,还必须删除其所有快照。 可以同时删除这两者。

az storage blob delete [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]

示例

删除 Blob。

az storage blob delete -c mycontainer -n MyBlob

使用登录凭据删除 Blob。

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--delete-snapshots

如果 blob 具有关联的快照,则为必需。 值包括:“only”:仅删除 blob 快照。 “include”:删除 blob 以及所有快照。

接受的值: include, only
--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--name -n

Blob 名称。

--sas-token

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定要删除的 blob 快照。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--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 blob delete (storage-blob-preview 扩展)

标记 blob 或快照以供删除。

Blob 标记为以后在垃圾回收期间删除。 若要删除 blob,还必须删除其所有快照。 可以同时删除这两者。

az storage blob delete [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]
                       [--version-id]

示例

删除 Blob。

az storage blob delete -c mycontainer -n MyBlob

使用登录凭据删除 Blob。

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--delete-snapshots

如果 blob 具有关联的快照,则为必需。 “only”:仅删除 blob 快照。 “include”:删除 blob 以及所有快照。

接受的值: include, only
--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--name -n

Blob 名称。

--sas-token

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 blob 快照。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--timeout

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

--version-id

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

全局参数
--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 blob delete-batch

以递归方式从 Blob 容器中删除 Blob。

az storage blob delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--delete-snapshots {include, only}]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

示例

删除容器中以“.py”结尾的所有 blob,该容器未修改 10 天。

date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern "*.py" --if-unmodified-since $date --auth-mode login

删除名为“mycontainer”的容器中名为“dir”的目录中的所有 blob。

az storage blob delete-batch -s mycontainer --pattern "dir/*"

删除容器中格式为“cli-2018-xx-xx.txt”或“cli-2019-xx-xx.txt”的 blob。

az storage blob delete-batch -s mycontainer --pattern "cli-201[89]-??-??.txt"

删除容器中格式为“cli-201x-xx-xx.txt”的所有 blob,cli-2018-xx-xx.txt“和”cli-2019-xx-xx.txt”。

az storage blob delete-batch -s mycontainer --pattern "cli-201[!89]-??-??.txt"

必需参数

--source -s

将从中删除文件的 Blob 容器。

源可以是容器 URL 或容器名称。 当源是容器 URL 时,将从 URL 分析存储帐户名称。

可选参数

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

--delete-snapshots

如果 blob 具有关联的快照,则为必需。

接受的值: include, only
--dryrun

显示要执行的操作摘要,而不是实际删除文件。

如果指定了此项,它将忽略包括 --if-modified-since 和 --if-unmodified-since 的所有前置条件参数。 因此,不使用 --dryrun 命令删除文件 (s) 可能与结果列表不同,其中包含 --dryrun 标志。

默认值: False
--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 \.

仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。 指定 wild卡 字符 \ 仅在资源不存在时执行该操作;如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

Blob 的活动租约 ID。

--pattern

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

在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。 还可以尝试使用 --include 和 --exclude 使用 azure cli >= 2.0.70 的“az storage remove”命令来匹配多个模式。

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

将 Blob 下载到文件路径。

az storage blob download [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--end-range]
                         [--file]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--max-connections]
                         [--name]
                         [--no-progress]
                         [--open-mode]
                         [--overwrite {false, true}]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--tags-condition]
                         [--timeout]
                         [--validate-content]
                         [--version-id]

示例

下载 Blob。

az storage blob download -f /path/to/file -c mycontainer -n MyBlob

将 blob 内容下载到 stdout(管道支持)。

az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--end-range

用于下载 blob 部分的字节范围的结束。 如果提供了end_range,则必须提供start_range。 start_range和end_range参数是包容性的。 例如:start_range=0,end_range=511 将下载前 512 字节的 blob。

--file -f

要写出到的文件的路径。 如果未指定,将使用 stdout,max_connections设置为 1。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--max-connections

要下载的并行连接数。

默认值: 2
--name -n

Blob 名称。

--no-progress

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

默认值: False
--open-mode

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

默认值: wb
--overwrite

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

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

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 blob 快照。

--start-range

用于下载 blob 部分的字节范围的开始。 如果未提供end_range,则下载start_range后的所有字节。 start_range和end_range参数是包容性的。 例如:start_range=0,end_range=511 将下载前 512 字节的 blob。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--timeout

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

--validate-content

如果为 true,则计算 Blob 的每个区块的 MD5 哈希。 存储服务检查已随发送的哈希一起到达的内容的哈希。 如果使用 http 而不是 https(默认值),则这主要用于检测网络上的 bitflip(默认值)。 请注意,此 MD5 哈希未随 Blob 一起存储。 另请注意,如果启用,则不会使用内存高效算法,因为计算 MD5 哈希需要缓冲整个块,并且这样做会破坏内存高效算法的目的。

默认值: False
--version-id

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

全局参数
--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 blob download-batch

以递归方式从 Blob 容器下载 Blob。

az storage blob download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--overwrite {false, true}]
                               [--pattern]
                               [--sas-token]

示例

下载以.py结尾的所有 blob

az storage blob download-batch -d . --pattern "*.py" -s mycontainer --account-name mystorageaccount --account-key 00000000

从名为“mycontainer”的容器下载名为“dir”的目录中的所有 blob。

az storage blob download-batch -d . -s mycontainer --pattern "dir/*"

将容器中格式为“cli-2018-xx-xx.txt”或“cli-2019-xx-xx.txt”的所有 blob 下载到当前路径。

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[89]-??-??.txt"

将容器中格式为“cli-201x-xx-xx.txt cli-2018-xx-xx.txt”和“cli-2019-xx-xx.txt”的所有 blob 下载到当前路径。

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[!89]-??-??.txt"

必需参数

--destination -d

此下载操作的现有目标文件夹。

--source -s

从中下载文件的 Blob 容器。

源可以是容器 URL 或容器名称。 当源是容器 URL 时,将从 URL 分析存储帐户名称。

可选参数

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

--dryrun

显示要执行的操作摘要,而不是实际下载文件。

默认值: False
--max-connections

要下载的并行连接数。

默认值: 2
--no-progress

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

默认值: False
--overwrite

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

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

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

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

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

检查容器中是否存在 Blob。

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

示例

检查容器中是否存在 Blob。 (自动生成)

az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--name -n

Blob 名称。

--sas-token

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定快照。

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

预览

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

列出标记与给定搜索表达式匹配的所有容器中的 blob。

az storage blob filter --tag-filter
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--connection-string]
                       [--container-name]
                       [--sas-token]

必需参数

--tag-filter

要查找其标记与指定条件匹配的 blob 的表达式。 例如 “”yourtagname“='firsttag' 和 ”yourtagname2“='secondtag'”。

可选参数

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

--container-name -c

要在指定容器下列出 Blob 时使用。

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

为 Blob 生成共享访问签名。

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

示例

为具有只读权限的 Blob 生成 SAS 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

为指定 IP 范围的 Blob 生成 SAS 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

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

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--cache-control

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

--connection-string

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

--container-name -c

容器名称。

--content-disposition

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

--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 样式地址。

--name -n

Blob 名称。

--permissions

SAS 授予的权限。 允许的值:(a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete。 如果使用指定此值的 --id 引用存储访问策略,请不要使用。 可以组合使用。

--policy-name

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

--snapshot

可选 blob 快照 ID。 不透明的 DateTime 值,如果存在,则指定要授予权限的 blob 快照。

--start

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

--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 blob generate-sas (storage-blob-preview 扩展)

为 Blob 生成共享访问签名。

az storage blob generate-sas --container-name
                             --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]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--version-id]

示例

为具有只读权限的 Blob 生成 SAS 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

为指定 IP 范围的 Blob 生成 SAS 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

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

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

必需参数

--container-name -c

容器名称。

--name -n

Blob 名称。

可选参数

--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 的响应标头值。

--expiry

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

--full-uri

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

默认值: False
--https-only

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

--ip

指定要从中接受请求的 IP 地址或 IP 地址范围。 如果请求源自的 IP 地址与 SAS 令牌上指定的 IP 地址或地址范围不匹配,则不会对请求进行身份验证。 例如,在 SAS 上指定 ip=168.1.5.65 或 ip=168.1.5.60-168.1.5.70 会将请求限制为这些 IP 地址。

--permissions

SAS 授予的权限。 允许的值:(a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (m)ove (p)ermanent_delete (r)ead (s)et_immutability_policy (t)ag (w)rite。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。 可以组合使用。

--policy-name

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 blob 快照。

--start

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

--version-id
预览

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

全局参数
--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 blob list

列出给定容器中的 Blob。

az storage blob list --container-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--connection-string]
                     [--delimiter]
                     [--include]
                     [--marker]
                     [--num-results]
                     [--prefix]
                     [--sas-token]
                     [--show-next-marker]
                     [--timeout]

示例

列出名称以“foo”开头的容器中的所有存储 Blob;将匹配“foo”、“foobar”和“foo/bar”等名称

az storage blob list -c mycontainer --prefix foo

必需参数

--container-name -c

容器名称。

可选参数

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

--delimiter

当请求包含此参数时,该操作在结果列表中返回一个 BlobPrefix 元素,该元素充当其名称以相同子字符串开头的所有 blob 的占位符,以分隔符字符的外观开头。 分隔符可以是单个字符或字符串。

--include

指定要包含在响应中的一个或多个其他数据集。 选项包括:(c)opy、(d)eleted、(m)etadata、(s)napshots、(v)ersions、(t)ags、(i)mmutabilitypolicy、(l)egalhold、(d)eletedwithversions。 可以组合使用。

--marker

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

--num-results

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

默认值: 5000
--prefix

筛选结果以仅返回名称以指定前缀开头的 blob。

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

预览 已放弃

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

此命令已弃用,将在将来的版本中删除。 请改用“az storage fs file move”。 有关详细信息,请转到 https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

在存储容器中移动 Blob。

az storage blob move --container-name
                     --destination-blob
                     --source-blob
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--lease-id]
                     [--sas-token]
                     [--source-if-match]
                     [--source-if-modified-since]
                     [--source-if-none-match]
                     [--source-if-unmodified-since]
                     [--source-lease-id]
                     [--timeout]

示例

在存储容器中移动 Blob。

az storage blob move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount

必需参数

--container-name -c

容器名称。

--destination-blob -d

目标 Blob 名称。 它应该是容器下的绝对路径。 例如'topdir1/dirbar'。

--source-blob -s

源 Blob 名称。 它应该是容器下的绝对路径。 例如'topdir1/dirsubfoo'。

可选参数

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--connection-string

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

--lease-id

可选。 new_path的租约 ID。 new_path必须具有活动租约,并且租约 ID 必须匹配。

--sas-token

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

--source-if-match

可选。 ETag 值。 仅当源的 ETag 与指定的值匹配时,才指定此标头来执行重命名操作。

--source-if-modified-since

可选。 日期和时间值。 仅当源自指定日期和时间以来已修改时,才指定此标头来执行重命名操作。

--source-if-none-match

可选。 ETag 值或特殊 wild卡 (“*”) 值。 仅当源的 ETag 与指定的值不匹配时,才指定此标头来执行重命名操作。

--source-if-unmodified-since

可选。 日期和时间值。 仅当源自指定日期和时间以来尚未修改时,才指定此标头来执行重命名操作。

--source-lease-id

可选。 source_path的租约 ID。 source_path必须具有活动租约,并且租约 ID 必须匹配。

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

预览

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

允许用户通过提供简单的查询表达式来选择/投影 blob 或 blob 快照数据。

az storage blob query --query-expression
                      [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--blob-endpoint]
                      [--blob-url]
                      [--connection-string]
                      [--container-name]
                      [--if-match]
                      [--if-modified-since]
                      [--if-none-match]
                      [--if-unmodified-since]
                      [--in-column-separator]
                      [--in-escape-char]
                      [--in-has-header]
                      [--in-line-separator]
                      [--in-quote-char]
                      [--in-record-separator]
                      [--input-format {csv, json}]
                      [--lease-id]
                      [--name]
                      [--out-column-separator]
                      [--out-escape-char]
                      [--out-has-header]
                      [--out-line-separator]
                      [--out-quote-char]
                      [--out-record-separator]
                      [--output-format {csv, json}]
                      [--result-file]
                      [--sas-token]
                      [--tags-condition]
                      [--timeout]

示例

允许用户通过提供简单的查询表达式在 Blob 上选择/投影。

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage"

允许用户通过提供简单的查询表达式并在目标文件中保存来选择/投影 blob。

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage" --result-file result.csv

必需参数

--query-expression

SQL 中的查询表达式。 查询表达式的最大大小为 256KiB。 有关表达式语法的详细信息,请参阅 https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--in-column-separator

用于分隔列的字符串。

默认值: ,
--in-escape-char

用作转义字符的字符串。 默认值为空。

--in-has-header

Blob 数据是否在第一行中包含标头。 默认值为 False,表示将返回数据(包括第一行)。 如果设置为 True,则数据将只返回第一行。

默认值: False
--in-line-separator

用于分隔记录的字符串。

默认值:
--in-quote-char

用于引用特定字段的字符串。

默认值: "
--in-record-separator

用于分隔记录的字符串。

默认值:
--input-format

Blob 中当前存储的数据的序列化类型。 默认值是将 Blob 数据视为采用默认方言格式的 CSV 数据。指定 Blob 格式时,将根据该配置文件重新格式化 Blob 数据。 如果选择 json,请相应地指定 Output Json Text Configuration Arguments ;如果选择 csv,请指定 Output Delimited Text Configuration Arguments

接受的值: csv, json
--lease-id

如果 Blob 具有活动租约,则为必需。

--name -n

Blob 名称。

--out-column-separator

用于分隔列的字符串。

默认值: ,
--out-escape-char

用作转义字符的字符串。 默认值为空。

--out-has-header

Blob 数据是否在第一行中包含标头。 默认值为 False,表示将返回数据(包括第一行)。 如果设置为 True,则数据将只返回第一行。

默认值: False
--out-line-separator

用于分隔记录的字符串。

默认值:
--out-quote-char

用于引用特定字段的字符串。

默认值: "
--out-record-separator

用于分隔记录的字符串。

默认值:
--output-format

数据流的输出序列化类型。 默认情况下,数据将返回,因为它在 Blob 中表示。 通过提供输出格式,Blob 数据将根据该配置文件重新格式化。 如果选择 json,请相应地指定 Output Json Text Configuration Arguments ;如果选择 csv,请指定 Output Delimited Text Configuration Arguments

接受的值: csv, json
--result-file

指定要保存结果的文件路径。

--sas-token

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

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

还原指定 blob 范围内的 Blob。

az storage blob restore --account-name
                        --time-to-restore
                        [--blob-range]
                        [--no-wait]
                        [--resource-group]

示例

在两个指定的 Blob 范围内还原 Blob。 例如(container1/blob1、container2/blob2)和(container2/blob3.)。container2/blob4)。

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4

从帐户开始到帐户结束,还原指定 blob 范围内的 Blob。

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""

还原指定 blob 范围内的 Blob。

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2

使用“az storage account show”还原指定 blob 范围内的 blob,而无需等待并查询 blob 还原状态。

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait

必需参数

--account-name -n

存储帐户名称。

--time-to-restore -t

将 Blob 还原到指定的时间,该时间应为 UTC 日期/时间(Y-m-d'T'H:M:S'Z')。

可选参数

--blob-range -r

要还原的 Blob 范围。 需要两个值来为每个 blob 范围指定start_range和end_range,例如 -r blob1 blob2。 注意:空表示帐户以起始范围值开头,表示结束范围的帐户结束。

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<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 blob rewrite

预览

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

创建一个新的块 Blob,其中从给定 URL 读取 Blob 的内容。

现有 Blob 的内容将用新 Blob 覆盖。

az storage blob rewrite --container-name
                        --name
                        --source-uri
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--encryption-scope]
                        [--if-match]
                        [--if-modified-since]
                        [--if-none-match]
                        [--if-unmodified-since]
                        [--lease-id]
                        [--sas-token]
                        [--tags-condition]
                        [--tier {Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
                        [--timeout]

示例

更新现有 Blob 的加密范围。

az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

必需参数

--container-name -c

容器名称。

--name -n

Blob 名称。

--source-uri -u

长度最多为 2 知识库(KB)的 URL,用于指定文件或 blob。 该值应采用 URL 编码,因为它将显示在请求 URI 中。 如果源位于另一个帐户中,则源必须是公共的,或者必须通过共享访问签名进行身份验证。 如果源是公共的,则无需身份验证。

可选参数

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

--encryption-scope

用于加密服务上的数据的预定义加密范围。 可以使用管理 API 创建加密范围,并按名称在此处引用。 如果在容器中定义了默认加密范围,则如果容器级作用域配置为允许替代,则此值将替代它。 否则将引发错误。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。 值可以是 BlobLeaseClient 对象或租约 ID 作为字符串。

--sas-token

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--tier

要将 Blob 设置为的标准 Blob 层值。 对于此版本的库,这仅适用于标准存储帐户上的块 Blob。

接受的值: Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80
--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 获取完整的调试日志。

设置 Blob 法定保留。

az storage blob set-legal-hold --container-name
                               --legal-hold {false, true}
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

配置 Blob 法定保留。

az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

清除 Blob 法定保留。

az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
--container-name -c

容器名称。

--legal-hold

指定是否应在 Blob 上设置法定保留。

接受的值: false, true
--name -n

Blob 名称。

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

设置 Blob 上的块层或页层。

对于块 Blob,此命令仅支持标准存储帐户上的块 Blob。 对于页 Blob,此命令仅支持高级帐户上的页 Blob。

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--timeout]
                         [--type {block, page}]

示例

设置 Blob 上的块层或页层。 (自动生成)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

必需参数

--tier

要将 Blob 设置为的层值。

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--name -n

Blob 名称。

--rehydrate-priority -r
预览

指示用于解除存档 Blob 冻结的优先级。 只能在 Blob 上设置优先级一次,默认值为 Standard。

接受的值: High, Standard
--sas-token

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

--timeout

超时参数以秒为单位表示。 此方法可能会对 Azure 服务进行多次调用,超时将分别应用于每个调用。

--type -t

Blob 类型。

接受的值: block, page
默认值: block
全局参数
--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 blob set-tier (storage-blob-preview 扩展)

设置 Blob 上的块层或页层。

对于块 Blob,此命令仅支持标准存储帐户上的块 Blob。 对于页 Blob,此命令仅支持高级帐户上的页 Blob。

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]
                         [--type {block, page}]
                         [--version-id]

示例

设置 Blob 上的块层或页层。 (自动生成)

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

必需参数

--tier

要将 Blob 设置为的层值。

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--name -n

Blob 名称。

--rehydrate-priority -r
预览

指示用于解除存档 Blob 冻结的优先级。

接受的值: High, Standard
--sas-token

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--timeout

超时参数以秒为单位表示。 此方法可能会对 Azure 服务进行多次调用,超时将分别应用于每个调用。

--type -t

Blob 类型。

接受的值: block, page
默认值: block
--version-id

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

全局参数
--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 blob show

获取 Blob 的详细信息。

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]

示例

显示 Blob 的所有属性。

az storage blob show -c mycontainer -n MyBlob

获取 Blob 的详细信息(自动生成)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--name -n

Blob 名称。

--sas-token

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 blob 快照。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--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 blob show (storage-blob-preview 扩展)

获取 Blob 的详细信息。

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]
                     [--version-id]

示例

显示 Blob 的所有属性。

az storage blob show -c mycontainer -n MyBlob

获取 Blob 的详细信息(自动生成)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--name -n

Blob 名称。

--sas-token

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

--snapshot

快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 blob 快照。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--timeout

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

--version-id
预览

可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。

全局参数
--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 blob snapshot

创建 blob 的快照。

快照是在某一时间点拍摄的只读版本的 Blob。 它可以读取、复制或删除,但不能修改。 利用快照,可以在某个时间点备份显示的 Blob。 blob 的快照的名称与从中获取快照的基本 Blob 相同,并追加了 DateTime 值以指示快照的拍摄时间。

az storage blob snapshot [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--metadata]
                         [--name]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--metadata

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

--name -n

Blob 名称。

--sas-token

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

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

预览

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

以递归方式将 blob 同步到存储 Blob 容器。

az storage blob sync --container
                     --source
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]
                     [<EXTRA_OPTIONS>]

示例

将单个 Blob 同步到容器。

az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob

将目录同步到容器。

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"

使用 azcopy 选项直通将目录同步到容器(在本例中将上传带形限制为 20 MBit/s)。

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory" -- --cap-mbps=20

必需参数

--container -c

同步目标容器。

--source -s

要从中同步的源文件路径。

可选参数

--account-key

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

--account-name

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

--connection-string

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

--delete-destination

定义是否从源中不存在的目标中删除额外文件。 可设置为 true、false 或 prompt。 如果设置为 prompt,则在计划要删除的文件和 Blob 之前,系统会向用户提问。

接受的值: false, prompt, true
默认值: true
--destination -d

将前面追加到 Blob 名称的目标路径。

--exclude-path

排除这些路径。 此选项不支持 wild卡 characters \. 检查相对路径前缀。 例如:myFolder;myFolder/subDirName/file.pdf。

--exclude-pattern

排除名称与模式列表匹配的这些文件。 例如: .jpg;。Pdf;exactName。 此选项支持通配符 (*)。

--include-pattern

仅包含名称与模式列表匹配的这些文件。 例如: .jpg;。Pdf;exactName。 此选项支持通配符 (*)。

--sas-token

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

<EXTRA_OPTIONS>
实验

将传递到 azcopy 的其他选项,因为它是。 请在一个 --之后放置所有额外的选项。

全局参数
--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 blob undelete

还原软删除的 blob 或快照。

仅当在删除保留策略中设置的指定天数内使用时,操作才会成功。 尝试取消删除未软删除的 blob 或快照将成功,而不会进行任何更改。

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

示例

取消删除 Blob。

az storage blob undelete -c mycontainer -n MyBlob

使用登录凭据取消删除 Blob。

az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

--name -n

Blob 名称。

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

在 blob 上设置系统属性。

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

az storage blob update --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--clear-content-settings {false, true}]
                       [--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]
                       [--lease-id]
                       [--sas-token]
                       [--tags-condition]
                       [--timeout]

必需参数

--container-name -c

容器名称。

--name -n

Blob 名称。

可选参数

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

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

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--sas-token

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

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

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

将文件上传到存储 Blob。

从文件路径创建新 Blob,或使用自动分块和进度通知更新现有 Blob 的内容。

az storage blob upload [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--data]
                       [--encryption-scope]
                       [--file]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--length]
                       [--max-connections]
                       [--maxsize-condition]
                       [--metadata]
                       [--name]
                       [--no-progress]
                       [--overwrite {false, true}]
                       [--sas-token]
                       [--socket-timeout]
                       [--tags]
                       [--tags-condition]
                       [--tier]
                       [--timeout]
                       [--type {append, block, page}]
                       [--validate-content]

示例

上传到 Blob。

az storage blob upload -f /path/to/file -c mycontainer -n MyBlob

上传到具有 blob sas URL 的 Blob。

az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted

将文件上传到存储 Blob。 (自动生成)

az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob

将字符串上传到 Blob。

az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

上传到管道。

echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

可选参数

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

--blob-url

Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode终结点。

--connection-string

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

--container-name -c

容器名称。

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

缓存控制字符串。

--content-disposition

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

--content-encoding

内容编码类型。

--content-language

内容语言。

--content-md5

内容的 MD5 哈希。

--content-type

内容 MIME 类型。

--data
预览

要上传的 Blob 数据。

--encryption-scope

用于加密服务上的数据的预定义加密范围。

--file -f

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

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

如果 Blob 具有活动租约,则为必需。

--length
预览

要从流中读取的字节数。 这是可选的,但应提供以获得最佳性能。 与 --data 合作。

--max-connections

Blob 大小超过 64MB 时要使用的最大并行连接数。

默认值: 2
--maxsize-condition

追加 blob 允许的最大长度(以字节为单位)。

--metadata

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

--name -n

Blob 名称。

--no-progress

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

默认值: False
--overwrite

要上传的 Blob 是否应覆盖当前数据。 如果为 True,Blob 上传操作将覆盖现有数据。 如果设置为 False,则 ResourceExistsError 操作将失败。 上述异常是追加 blob 类型:如果设置为 False 且数据已存在,则不会引发错误,并将数据追加到现有 Blob。 如果 set overwrite=True,则将删除现有的追加 blob,并创建一个新 blob。 默认为 False。

接受的值: false, true
--sas-token

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

--socket-timeout

服务用来调节数据流的套接字超时(秒)。

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--tier

要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。

--timeout

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

--type -t

对于 *.vhd 文件,默认为“page”,否则为“block”。

接受的值: append, block, page
--validate-content

指定为 Blob 的每个区块计算 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 blob upload-batch

将文件从本地目录上传到 Blob 容器。

az storage blob upload-batch --destination
                             --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]
                             [--destination-path]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--max-connections]
                             [--maxsize-condition]
                             [--metadata]
                             [--no-progress]
                             [--overwrite {false, true}]
                             [--pattern]
                             [--sas-token]
                             [--tags]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

示例

上传以.py结尾的所有文件,除非 blob 存在,并且自给定日期以来已被修改。

az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern "*.py" --if-unmodified-since 2018-08-27T20:51Z

将所有文件从本地路径目录上传到名为“mycontainer”的容器。

az storage blob upload-batch -d mycontainer -s <path-to-directory>

在本地路径目录中上传格式为“cli-2018-xx-xx.txt”或“cli-2019-xx-xx.txt”的所有文件。

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[89]-??-??.txt"

在容器中上传格式为“cli-201x-xx-xx.txt cli-2018-xx-xx.txt”和“cli-2019-xx-xx.txt”的所有文件。

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[!89]-??-??.txt"

必需参数

--destination -d

将上传文件的 Blob 容器。

目标可以是容器 URL 或容器名称。 当目标为容器 URL 时,将从 URL 分析存储帐户名称。

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

--destination-path

将前面追加到 Blob 名称的目标路径。

--dryrun

显示要执行的操作摘要,而不是实际上传文件。

默认值: False
--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或 wild卡 字符 \.

仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。 指定 wild卡 字符 \ 仅在资源不存在时执行该操作;如果资源不存在,则操作失败。

--if-unmodified-since

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

--lease-id

Blob 的活动租约 ID。

--max-connections

Blob 大小超过 64MB 时要使用的最大并行连接数。

默认值: 2
--maxsize-condition

追加 blob 允许的最大长度(以字节为单位)。

--metadata

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

--no-progress

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

默认值: False
--overwrite

要上传的 Blob 是否应覆盖当前数据。 如果为 True,Blob 上传操作将覆盖现有数据。 如果设置为 False,则 ResourceExistsError 操作将失败。 上述异常是追加 blob 类型:如果设置为 False 且数据已存在,则不会引发错误,并将数据追加到现有 Blob。 如果 set overwrite=True,则将删除现有的追加 blob,并创建一个新 blob。 默认为 False。

接受的值: false, true
--pattern

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

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

--sas-token

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

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--tags-condition

指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。

--tier

要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。

--timeout

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

--type -t

对于 *.vhd 文件,默认为“page”,否则为“block”。 该设置将覆盖每个文件的 Blob 类型。

接受的值: append, block, page
--validate-content

指定为 Blob 的每个区块计算 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 blob url

创建 URL 以访问 Blob。

az storage blob url --container-name
                    --name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--blob-endpoint]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]
                    [--snapshot]

示例

创建 URL 以访问 Blob(自动生成)

az storage blob url --connection-string $connectionString --container-name container1 --name blob1

创建 URL 以访问 Blob(自动生成)

az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1

必需参数

--container-name -c

容器名称。

--name -n

Blob 名称。

可选参数

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

--protocol

要使用的协议。

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

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

--snapshot

唯一标识快照的字符串值。 此查询参数的值指示快照版本。

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