你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az storage blob copy
注意
此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展,使其受益于其扩展功能。 详细了解扩展。
管理 blob 复制操作。 用于az storage blob show
检查 blob 的状态。
命令
名称 | 说明 | 类型 | 状态 |
---|---|---|---|
az storage blob copy cancel |
中止正在进行的复制操作。 |
核心 | GA |
az storage blob copy start |
异步复制 Blob。 用于 |
核心 | GA |
az storage blob copy start (storage-blob-preview 扩展) |
启动复制 Blob 作业。 |
分机 | GA |
az storage blob copy start-batch |
将多个 Blob 复制到 Blob 容器。 用于 |
核心 | GA |
az storage blob copy cancel
中止正在进行的复制操作。
这将保留长度为零和完整元数据的目标 Blob。 如果复制操作已结束,则会引发错误。
az storage blob copy cancel --copy-id
--destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--lease-id]
[--sas-token]
[--timeout]
必需参数
要中止的复制操作。 这可以是 ID 字符串,也可以是 BlobProperties 的实例。
目标 Blob 的名称。 如果存在,将覆盖它。
容器名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_标准版RVICE_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 copy start
异步复制 Blob。 用于az storage blob show
检查 blob 的状态。
az storage blob copy start --destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-if-match]
[--destination-if-modified-since]
[--destination-if-none-match]
[--destination-if-unmodified-since]
[--destination-lease-id]
[--destination-tags-condition]
[--metadata]
[--rehydrate-priority]
[--requires-sync {false, true}]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-container]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--source-path]
[--source-sas]
[--source-share]
[--source-snapshot]
[--source-tags-condition]
[--source-uri]
[--tags]
[--tier]
[--timeout]
示例
异步复制 Blob。 使用“az storage blob show”检查 blob 的状态。
az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos
异步复制 Blob。 使用“az storage blob show”检查 blob 的状态。
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos
复制 Blob 特定版本
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://my-account.blob.core.windows.net/my-container/my-blob?versionId=2022-03-21T18:28:44.4431011Z --auth-mode login
必需参数
目标 Blob 的名称。 如果存在,将覆盖它。
容器名称。
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
定义目标处 Blob 的类型。 “Detect”的值根据源 Blob 类型确定类型。
ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 指定此条件标头,仅当目标 Blob 自指定日期/时间以来已修改时,才复制 Blob。 如果未修改目标 Blob,Blob 服务将返回状态代码 412(前置条件失败)。
ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 仅当目标 Blob 自指定日期/时间以来尚未修改时,才指定此条件标头来复制 Blob。 如果目标 Blob 已修改,Blob 服务将返回状态代码 412(前置条件失败)。
为此标头指定的租约 ID 必须与引入 blob 的租约 ID 匹配。 如果请求不包含租约 ID 或无效,则操作将失败,状态代码为 412(前置条件失败)。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
指示用于解除存档 Blob 冻结的优先级。
强制在复制完成之前,服务不会返回响应。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源 Blob 的存储帐户密钥。
源 Blob 的存储帐户名称。
源存储帐户的 Blob 名称。
源存储帐户的容器名称。
ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 指定此条件标头,仅当源 Blob 自指定日期/时间以来已修改时,才复制 Blob。
ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 仅当源 Blob 自指定日期/时间以来尚未修改时,才指定此条件标头来复制 Blob。
仅当给定的租约 ID 与源 Blob 的活动租约 ID 匹配时,才指定此操作来执行复制 Blob 操作。
源存储帐户的文件路径。
源存储帐户的共享访问签名。
源存储帐户的共享名称。
源存储帐户的 blob 快照。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
长度最多为 2 知识库(KB)的 URL,用于指定 Azure 文件或 Blob。 该值应采用 URL 编码,因为它将显示在请求 URI 中。 如果源位于另一个帐户中,则源必须是公共的,或者必须通过共享访问签名进行身份验证。 如果源是公共的,则无需身份验证。 示例:https://myaccount.blob.core.windows.net/mycontainer/myblob
、https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
、https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az storage blob copy start (storage-blob-preview 扩展)
启动复制 Blob 作业。
az storage blob copy start --destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-if-match]
[--destination-if-modified-since]
[--destination-if-none-match]
[--destination-if-unmodified-since]
[--destination-lease-id]
[--destination-tags-condition]
[--metadata]
[--rehydrate-priority]
[--requires-sync {false, true}]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-container]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--source-path]
[--source-sas]
[--source-share]
[--source-snapshot]
[--source-tags-condition]
[--source-uri]
[--tags]
[--tier]
[--timeout]
示例
异步复制 Blob。 使用“az storage blob show”检查 blob 的状态。
az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos
异步复制 Blob。 使用“az storage blob show”检查 blob 的状态。
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos
必需参数
目标 Blob 的名称。 如果存在,将覆盖它。
容器名称。
可选参数
存储帐户密钥。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
定义目标处 Blob 的类型。 “Detect”的值根据源 Blob 类型确定类型。
ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 指定此条件标头,仅当目标 Blob 自指定日期/时间以来已修改时,才复制 Blob。 如果未修改目标 Blob,Blob 服务将返回状态代码 412(前置条件失败)。
ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 仅当目标 Blob 自指定日期/时间以来尚未修改时,才指定此条件标头来复制 Blob。 如果目标 Blob 已修改,Blob 服务将返回状态代码 412(前置条件失败)。
为此标头指定的租约 ID 必须与引入 blob 的租约 ID 匹配。 如果请求不包含租约 ID 或无效,则操作将失败,状态代码为 412(前置条件失败)。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
空格分隔键=值对中的元数据。 这会覆盖任何现有元数据。
指示用于解除存档 Blob 冻结的优先级。
强制在复制完成之前,服务不会返回响应。
共享访问签名(SAS)。 必须与存储帐户名称结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源 Blob 的存储帐户密钥。
源 Blob 的存储帐户名称。
源存储帐户的 Blob 名称。
源存储帐户的容器名称。
ETag 值或 wild卡 字符 \. 仅当资源的 ETag 与指定的值匹配时,才指定此标头来执行该操作。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 指定此条件标头,仅当源 Blob 自指定日期/时间以来已修改时,才复制 Blob。
ETag 值或 wild卡 字符 ()。仅当资源的 ETag 与指定的值不匹配时,才指定此标头来执行该操作。指定 wild卡 字符 () 以仅在资源不存在时执行该操作,如果资源不存在,则操作失败。
一个日期时间值。 Azure 预期传入的日期值为 UTC。 如果包含时区,则任何非 UTC 日期/时间都将转换为 UTC。 如果在没有时区信息的情况下传入日期,则假定日期为 UTC。 仅当源 Blob 自指定日期/时间以来尚未修改时,才指定此条件标头来复制 Blob。
仅当给定的租约 ID 与源 Blob 的活动租约 ID 匹配时,才指定此操作来执行复制 Blob 操作。
源存储帐户的文件路径。
源存储帐户的共享访问签名。
源存储帐户的共享名称。
源存储帐户的 blob 快照。
指定 Blob 标记上的 SQL where 子句,以仅对具有匹配值的 Blob 进行操作。
长度最多为 2 知识库(KB)的 URL,用于指定 Azure 文件或 Blob。 该值应采用 URL 编码,因为它将显示在请求 URI 中。 如果源位于另一个帐户中,则源必须是公共的,或者必须通过共享访问签名进行身份验证。 如果源是公共的,则无需身份验证。 示例:https://myaccount.blob.core.windows.net/mycontainer/myblob
、https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
、https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
。
空格分隔标记:key[=value] [key[=value] ...]。标记区分大小写。 标记集最多可以包含 10 个标记。 标记键必须介于 1 到 128 个字符之间,标记值必须介于 0 到 256 个字符之间。 有效的标记键和值字符包括:小写字母和大写字母、数字(0-9)、空格(
)、加(+)、减号(-)、句点(.)、solidus(/)、冒号(:)、等号(=)、下划线(_)。
要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。
请求超时(以秒为单位)。 适用于对服务的每个调用。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az storage blob copy start-batch
将多个 Blob 复制到 Blob 容器。 用于az storage blob show
检查 blob 的状态。
az storage blob copy start-batch [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-container]
[--destination-path]
[--dryrun]
[--pattern]
[--rehydrate-priority]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-container]
[--source-sas]
[--source-share]
[--source-uri]
[--tier]
示例
将多个 Blob 复制到 Blob 容器。 使用“az storage blob show”检查 blob 的状态。 (自动生成)
az storage blob copy start-batch --account-key 00000000 --account-name MyAccount --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-container MySourceContainer
可选参数
存储帐户密钥。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_KEY。
存储帐户名称。 相关环境变量:AZURE_STORAGE_ACCOUNT。 必须与存储帐户密钥或 SAS 令牌结合使用。 如果两者都不存在,该命令将尝试使用经过身份验证的 Azure 帐户查询存储帐户密钥。 如果执行了大量存储命令,可能会命中 API 配额。
运行命令的模式。 “登录”模式将直接使用登录凭据进行身份验证。 如果未提供帐户的身份验证参数,则旧版“密钥”模式将尝试查询帐户密钥。 环境变量:AZURE_STORAGE_AUTH_MODE。
存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show
。 环境变量:AZURE_STORAGE_标准版RVICE_ENDPOINT。
存储帐户连接字符串。 环境变量:AZURE_STORAGE_CONNECTION_STRING。
定义目标处 Blob 的类型。 “Detect”的值根据源 Blob 类型确定类型。
将所选源文件或 Blob 复制到的 Blob 容器。
将前面追加到 Blob 名称的目标路径。
列出要上传的文件或 Blob。 不会发生实际数据传输。
用于在源中填充文件或 Blob 的模式。 支持的模式为“*”、“?”、“[seq]”和“[!seq]”。 有关详细信息,请参阅 https://docs.python.org/3.7/library/fnmatch.html。
在 --pattern 中使用“*”时,它将匹配任何字符,包括目录分隔符“/”。
指示用于解除存档 Blob 冻结的优先级。
共享访问签名(SAS)。 必须与存储帐户名称或服务终结点结合使用。 环境变量:AZURE_STORAGE_SAS_TOKEN。
源存储帐户的帐户密钥。
从中将文件或 Blob 复制到目标的源存储帐户。 如果省略,则使用目标帐户。
从中复制 Blob 的源容器。
源存储帐户的共享访问签名。
从中复制文件的源共享。
一个 URI,指定从中复制文件或 Blob 的文件共享或 Blob 容器。
如果源位于另一个帐户中,则源必须是公共的,或者必须使用共享访问签名进行身份验证。
要将 Blob 设置为的层值。 对于页 Blob,层与 Blob 的大小和允许的 IOPS 数相关联。 可能的值为 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,这仅适用于高级存储帐户上的页 Blob:对于块 Blob,可能的值为 Archive、Cold、Cool 和 Hot。 这仅适用于标准存储帐户上的块 Blob。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。