你当前正在访问 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 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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
如果 Blob 具有关联的快照,则为必需。 值包括:“only”:仅删除 blob 快照。 “include”:删除 Blob 以及所有快照。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
快照参数是一个不透明的 DateTime 值,如果存在,则指定要删除的 Blob 快照。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
如果 Blob 具有关联的快照,则为必需。 “only”:仅删除 blob 快照。 “include”:删除 Blob 以及所有快照。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 Blob 快照。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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"
必需参数
将从中删除文件的 Blob 容器。
源可以是容器 URL 或容器名称。 当源是容器 URL 时,将从 URL 分析存储帐户名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
如果 Blob 具有关联的快照,则为必需。
显示要执行的操作摘要,而不是实际删除文件。
如果指定了此项,它将忽略包括 --if-modified-since 和 --if-unmodified-since 的所有前置条件参数。 因此,不使用 --dryrun 命令删除文件 (s) 可能与结果列表不同,其中包含 --dryrun 标志。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 \.
仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。 指定通配符 \ 仅在资源不存在时执行该操作,并在操作不存在时失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
Blob 的活动租约 ID。
用于在源中填充文件或 Blob 的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html。
在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。 还可以尝试使用 --include 和 --exclude 使用 azure cli >= 2.0.70 的“az storage remove”命令来匹配多个模式。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
用于下载 blob 部分的字节范围的结束。 如果提供了end_range,则必须提供start_range。 start_range和end_range参数是包容性的。 例如:start_range=0,end_range=511 将下载前 512 字节的 blob。
要写出到的文件的路径。 如果未指定,将使用 stdout,max_connections设置为 1。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
要下载的并行连接数。
Blob 名称。
包括此标志以禁用命令的进度报告。
打开文件时要使用的模式。 请注意,仅指定追加open_mode会阻止并行下载。 因此,如果使用此open_mode,则必须将max_connections设置为 1。
指定时覆盖现有文件。 默认值为 true。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 Blob 快照。
用于下载 blob 部分的字节范围的开始。 如果未提供end_range,则下载start_range后的所有字节。 start_range和end_range参数是包容性的。 例如:start_range=0,end_range=511 将下载前 512 字节的 blob。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
如果为 true,则计算 Blob 的每个区块的 MD5 哈希。 存储服务检查随已发送的哈希一起到达的内容的哈希。 如果使用 http 而不是 https(默认值),则这主要用于检测网络上的 bitflip(默认值)。 请注意,此 MD5 哈希未随 Blob 一起存储。 另请注意,如果启用,则不会使用内存高效算法,因为计算 MD5 哈希需要缓冲整个块,并且这样做会破坏内存高效算法的目的。
可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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"
必需参数
此下载操作的现有目标文件夹。
从中下载文件的 Blob 容器。
源可以是容器 URL 或容器名称。 当源是容器 URL 时,将从 URL 分析存储帐户名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
显示要执行的操作摘要,而不是实际下载文件。
要下载的并行连接数。
包括此标志以禁用命令的进度报告。
指定时覆盖现有文件。 默认值为 false。
用于在源中填充文件或 Blob 的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html。
在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
快照参数是一个不透明的 DateTime 值,如果存在,则指定快照。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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]
必需参数
要查找其标记与指定条件匹配的 blob 的表达式。 例如 “”yourtagname“='firsttag' 和 ”yourtagname2“='secondtag'”。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
要在指定容器下列出 Blob 时使用。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
指示此命令返回使用用户委托密钥签名的 SAS。 如果指定此参数,则需要过期参数和“--auth-mode login”。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
使用此共享访问签名访问资源时,Cache-Control 的响应标头值。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
使用此共享访问签名访问资源时,Content-Disposition 的响应标头值。
使用此共享访问签名访问资源时,内容编码的响应标头值。
使用此共享访问签名访问资源时,Content-Language 的响应标头值。
使用此共享访问签名访问资源时,Content-Type 的响应标头值。
用于加密服务上的数据的预定义加密范围。
指定 SAS 无效的 UTC 日期时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。
指示此命令返回完整的 Blob URI 和共享访问签名令牌。
仅允许使用 HTTPS 协议发出的请求。 如果省略,则允许来自 HTTP 和 HTTPS 协议的请求。
指定要从中接受请求的 IP 地址或 IP 地址范围。 仅支持 IPv4 样式地址。
Blob 名称。
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 引用存储访问策略,请不要使用。 可以组合使用。
容器 ACL 中存储的访问策略的名称。
可选的 Blob 快照 ID。 不透明的 DateTime 值,如果存在,则指定要授予权限的 Blob 快照。
指定 SAS 生效的 UTC 日期/时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --policy-name 引用存储的访问策略,请不要使用。 默认为请求的时间。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
容器名称。
Blob 名称。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
指示此命令返回使用用户委托密钥签名的 SAS。 如果指定此参数,则需要过期参数和“--auth-mode login”。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
当访问此共享访问签名的资源时,Cache-Control 的响应标头值。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
当访问此共享访问签名的资源时,Content-Disposition 的响应标头值。
当访问此共享访问签名的资源时,Content-Encoding 的响应标头值。
当访问此共享访问签名的资源时,Content-Language 的响应标头值。
当访问此共享访问签名的资源时,Content-Type 的响应标头值。
指定 SAS 无效的 UTC 日期时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --id 引用存储访问策略,请不要使用。
指示此命令返回完整的 Blob URI 和共享访问签名令牌。
仅允许使用 HTTPS 协议发出的请求。 如果省略,则允许来自 HTTP 和 HTTPS 协议的请求。
指定要从中接受请求的 IP 地址或 IP 地址范围。 如果请求源自的 IP 地址与 SAS 令牌上指定的 IP 地址或地址范围不匹配,则不会对请求进行身份验证。 例如,在 SAS 上指定 ip=168.1.5.65 或 ip=168.1.5.60-168.1.5.70 会将请求限制为这些 IP 地址。
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 引用存储的访问策略,请不要使用。 可以组合使用。
容器 ACL 中存储的访问策略的名称。
快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 Blob 快照。
指定 SAS 生效的 UTC 日期/时间(Y-m-d'T'H:M'Z')。 如果使用指定此值的 --id 引用存储访问策略,请不要使用。 默认为请求的时间。
可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
容器名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
当请求包含此参数时,该操作在结果列表中返回一个 BlobPrefix 元素,该元素充当其名称以相同子字符串开头的所有 blob 的占位符,以分隔符字符的外观开头。 分隔符可以是单个字符或字符串。
指定要包含在响应中的一个或多个其他数据集。 选项包括:(c)opy、(d)eleted、(m)etadata、(s)napshots、(v)ersions、(t)ags、(i)mmutabilitypolicy、(l)egalhold、(d)eletedwithversions。 可以组合使用。
一个字符串值,该值标识要在下一个列表操作中返回的容器列表部分。 如果列表操作未返回剩余的所有容器,则返回响应正文中的 NextMarker 值,该容器将随当前页一起列出。 如果指定,此生成器将从上一个生成器停止的点开始返回结果。
指定要返回的最大数字。 如果请求未指定num_results,或指定大于 5000 的值,服务器将返回最多 5000 个项目。 请注意,如果列表操作跨越分区边界,则服务将返回一个继续标记,用于检索其余结果。 提供“*”以全部返回。
筛选结果以仅返回名称以指定前缀开头的 blob。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
指定后,在结果中显示 nextMarker。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az storage blob move
此命令处于预览阶段,正在开发中。 参考和支持级别: 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
必需参数
容器名称。
目标 Blob 名称。 它应该是容器下的绝对路径。 例如'topdir1/dirbar'。
源 Blob 名称。 它应该是容器下的绝对路径。 例如'topdir1/dirsubfoo'。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
可选。 new_path的租约 ID。 new_path必须具有活动租约,并且租约 ID 必须匹配。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
可选。 ETag 值。 仅当源的 ETag 与指定的值匹配时,才指定此标头来执行重命名操作。
可选。 日期和时间值。 仅当源自指定日期和时间以来已修改时,才指定此标头来执行重命名操作。
可选。 ETag 值或特殊通配符 (“*”) 值。 仅当源的 ETag 与指定的值不匹配时,才指定此标头来执行重命名操作。
可选。 日期和时间值。 仅当源自指定日期和时间以来尚未修改时,才指定此标头来执行重命名操作。
可选。 source_path的租约 ID。 source_path必须具有活动租约,并且租约 ID 必须匹配。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
SQL 中的查询表达式。 查询表达式的最大大小为 256KiB。 有关表达式语法的详细信息,请参阅 https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
用于分隔列的字符串。
用作转义字符的字符串。 默认值为空。
Blob 数据是否在第一行中包含标头。 默认值为 False,表示将返回数据(包括第一行)。 如果设置为 True,则数据将只返回第一行。
用于分隔记录的字符串。
用于引用特定字段的字符串。
用于分隔记录的字符串。
Blob 中当前存储的数据的序列化类型。 默认值是将 Blob 数据视为采用默认方言格式的 CSV 数据。指定 Blob 格式时,将根据该配置文件重新格式化 Blob 数据。 如果选择 json
,请相应地指定 Output Json Text Configuration Arguments
;如果选择 csv
,请指定 Output Delimited Text Configuration Arguments
。
如果 Blob 具有活动租约,则为必需。
Blob 名称。
用于分隔列的字符串。
用作转义字符的字符串。 默认值为空。
Blob 数据是否在第一行中包含标头。 默认值为 False,表示将返回数据(包括第一行)。 如果设置为 True,则数据将只返回第一行。
用于分隔记录的字符串。
用于引用特定字段的字符串。
用于分隔记录的字符串。
数据流的输出序列化类型。 默认情况下,数据将返回,因为它在 Blob 中表示。 通过提供输出格式,Blob 数据将根据该配置文件重新格式化。 如果选择 json
,请相应地指定 Output Json Text Configuration Arguments
;如果选择 csv
,请指定 Output Delimited Text Configuration Arguments
。
指定要保存结果的文件路径。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
存储帐户名称。
将 Blob 还原到指定的时间,该时间应为 UTC 日期/时间(Y-m-d'T'H:M:S'Z')。
可选参数
要还原的 Blob 范围。 需要两个值来为每个 blob 范围指定start_range和end_range,例如 -r blob1 blob2。 注意:空表示帐户以起始范围值开头,表示结束范围的帐户结束。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
容器名称。
Blob 名称。
最大长度为 2 KB 的 URL,用于指定文件或 Blob。 该值应采用 URL 编码,因为它将显示在请求 URI 中。 如果源位于另一个帐户中,则源必须是公共的,或者必须通过共享访问签名进行身份验证。 如果源是公共的,则无需身份验证。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
用于加密服务上的数据的预定义加密范围。 可以使用管理 API 创建加密范围,并按名称在此处引用。 如果在容器中定义了默认加密范围,则如果容器级作用域配置为允许替代,则此值将替代它。 否则将引发错误。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。 值可以是 BlobLeaseClient 对象或租约 ID 作为字符串。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
要将 Blob 设置为的标准 Blob 层值。 对于此版本的库,这仅适用于标准存储帐户上的块 Blob。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az storage blob set-legal-hold
设置 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
必需参数
容器名称。
指定是否应在 Blob 上设置法定保留。
Blob 名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
要将 Blob 设置为的层值。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
Blob 名称。
指示用于解除存档 Blob 冻结的优先级。 只能在 Blob 上设置优先级一次,默认值为 Standard。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
超时参数以秒为单位表示。 此方法可能会对 Azure 服务进行多次调用,超时将分别应用于每个调用。
Blob 类型。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
要将 Blob 设置为的层值。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
Blob 名称。
指示用于解除存档 Blob 冻结的优先级。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
超时参数以秒为单位表示。 此方法可能会对 Azure 服务进行多次调用,超时将分别应用于每个调用。
Blob 类型。
可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 Blob 快照。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
快照参数是一个不透明的 DateTime 值,如果存在,则指定要检索的 Blob 快照。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
可选的 Blob 版本 ID。 此参数仅用于启用版本控制帐户。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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]
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az storage blob sync
此命令处于预览阶段,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
以递归方式将 blob 同步到存储 Blob 容器。
az storage blob sync --container
--source
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--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
必需参数
同步目标容器。
要从中同步的源文件路径。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
定义是否从源中不存在的目标中删除额外文件。 可设置为 true、false 或 prompt。 如果设置为 prompt,则在计划要删除的文件和 Blob 之前,系统会向用户提问。
将前面追加到 Blob 名称的目标路径。
排除这些路径。 此选项不支持通配符 \. 检查相对路径前缀。 例如:myFolder;myFolder/subDirName/file.pdf。
排除名称与模式列表匹配的这些文件。 例如: .jpg;。pdf;exactName。 此选项支持通配符 (*)。
仅包含名称与模式列表匹配的这些文件。 例如: .jpg;。pdf;exactName。 此选项支持通配符 (*)。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
将传递到 azcopy 的其他选项,因为它是。 请在一个 --
之后放置所有额外的选项。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
Blob 名称。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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]
必需参数
容器名称。
Blob 名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
如果设置了此标志,则设置以下任何一个或多个属性(--content-cache-control、--content-disposition、-content-encoding、--content-language、--content-md5、--content-type)时,所有这些属性都设置在一起。 如果在设置以下至少一个属性时未为给定属性提供值,则将清除该属性。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
缓存控制字符串。
传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。
内容编码类型。
内容语言。
内容的 MD5 哈希。
内容 MIME 类型。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
Blob 的完整终结点 URL,包括 SAS 令牌和快照(如果使用)。 这可以是主终结点,也可以是辅助终结点,具体取决于当前 location_mode
终结点。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
容器名称。
缓存控制字符串。
传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。
内容编码类型。
内容语言。
内容的 MD5 哈希。
内容 MIME 类型。
要上传的 Blob 数据。
用于加密服务上的数据的预定义加密范围。
要作为 Blob 内容上传的文件的路径。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定通配符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
如果 Blob 具有活动租约,则为必需。
要从流中读取的字节数。 这是可选的,但应提供以获得最佳性能。 与 --data 合作。
Blob 大小超过 64MB 时要使用的最大并行连接数。
追加 blob 允许的最大长度(以字节为单位)。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
Blob 名称。
包括此标志以禁用命令的进度报告。
要上传的 Blob 是否应覆盖当前数据。 如果为 True,Blob 上传操作将覆盖现有数据。 如果设置为 False,则 ResourceExistsError 操作将失败。 上述异常是追加 blob 类型:如果设置为 False 且数据已存在,则不会引发错误,并将数据追加到现有 Blob。 如果 set overwrite=True,则将删除现有的追加 blob,并创建一个新 blob。 默认为 False。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
服务用来调节数据流的套接字超时(秒)。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。
请求超时(以秒为单位)。 适用于对服务的每个调用。
对于 *.vhd 文件,默认为“page”,否则为“block”。
指定为 Blob 的每个区块计算 MD5 哈希,并在区块到达时由服务验证。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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"
必需参数
将上传文件的 Blob 容器。
目标可以是容器 URL 或容器名称。 当目标为容器 URL 时,将从 URL 分析存储帐户名称。
要上传的文件所在的目录。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
缓存控制字符串。
传达有关如何处理响应有效负载的其他信息,还可用于附加其他元数据。
内容编码类型。
内容语言。
内容的 MD5 哈希。
内容 MIME 类型。
将前面追加到 Blob 名称的目标路径。
显示要执行的操作摘要,而不是实际上传文件。
ETag 值或通配符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')修改后才开始。
ETag 值或通配符 \.
仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。 指定通配符 \ 仅在资源不存在时执行该操作,并在操作不存在时失败。
仅当自提供的 UTC 日期时间(Y-m-d'T'H:M'Z')以来未修改时才开始。
Blob 的活动租约 ID。
Blob 大小超过 64MB 时要使用的最大并行连接数。
追加 blob 允许的最大长度(以字节为单位)。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
包括此标志以禁用命令的进度报告。
要上传的 Blob 是否应覆盖当前数据。 如果为 True,Blob 上传操作将覆盖现有数据。 如果设置为 False,则 ResourceExistsError 操作将失败。 上述异常是追加 blob 类型:如果设置为 False 且数据已存在,则不会引发错误,并将数据追加到现有 Blob。 如果 set overwrite=True,则将删除现有的追加 blob,并创建一个新 blob。 默认为 False。
用于在源中填充文件或 Blob 的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html。
在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。
请求超时(以秒为单位)。 适用于对服务的每个调用。
对于 *.vhd 文件,默认为“page”,否则为“block”。 该设置将覆盖每个文件的 Blob 类型。
指定为 Blob 的每个区块计算 MD5 哈希,并在区块到达时由服务验证。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --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
必需参数
容器名称。
Blob 名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_SERVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
要使用的协议。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
唯一标识快照的字符串值。 此查询参数的值指示快照版本。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。