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

az storage blob incremental-copy

  • 参考

管理 blob 增量复制操作。

命令

名称 说明 类型 状态
az storage blob incremental-copy cancel

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

 核心 GA
az storage blob incremental-copy start

异步复制 blob 的增量副本。

 核心 GA

az storage blob incremental-copy cancel

编辑

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

az storage blob incremental-copy cancel --container-name
                                        --copy-id
                                        --name
                                        [--account-key]
                                        [--account-name]
                                        [--auth-mode {key, login}]
                                        [--connection-string]
                                        [--lease-id]
                                        [--sas-token]
                                        [--timeout]

必需参数

--container-name -c

容器名称。

--copy-id

原始copy_blob操作的 copy.id 中提供的复制标识符。

--name -n

Blob 名称。

可选参数

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

如果目标 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 incremental-copy start

编辑

异步复制 blob 的增量副本。

此操作返回复制操作属性对象，包括可用于检查或中止复制操作的副本 ID。 Blob 服务尽力复制 Blob。 增量复制操作的源 Blob 必须是页 Blob。 对目标 blob 调用get_blob_properties以检查复制操作的状态。 完成复制时，将提交最终的 Blob。

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

示例

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

az storage blob incremental-copy start --source-container MySourceContainer --source-blob MyBlob --source-account-name MySourceAccount --source-account-key MySourceKey --source-snapshot MySnapshot --destination-container MyDestinationContainer --destination-blob MyDestinationBlob

异步复制 blob 的增量副本。 （自动生成）

az storage blob incremental-copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-blob MyBlob --source-container MySourceContainer --source-snapshot MySnapshot

异步复制 Blob 的增量副本。 （自动生成）

az storage blob incremental-copy start --connection-string myconnectionstring --destination-blob mydestinationblob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

必需参数

--destination-blob -b

目标 Blob 的名称。 如果存在，将覆盖它。

--destination-container -c

容器名称。

可选参数

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

--destination-if-match

ETag 值或 wild卡 字符 \. 仅当指定的 ETag 值与现有目标 Blob 的 ETag 值匹配时，才为此条件标头指定 ETag 值以复制 blob。 如果目标 Blob 的 ETag 与为 If-Match 指定的 ETag 不匹配，Blob 服务将返回状态代码 412（前置条件失败）。

--destination-if-modified-since

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

--destination-if-none-match

ETag 值或 wild卡 字符 （）。仅当指定的 ETag 值与目标 Blob 的 ETag 值不匹配时，才为此条件标头指定 ETag 值以复制 blob。指定 wild卡 字符 （） 以仅在目标 Blob 不存在时执行该操作。 如果未满足指定条件，Blob 服务将返回状态代码 412（前置条件失败）。

--destination-if-unmodified-since

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

--destination-lease-id

为此标头指定的租约 ID 必须与目标 Blob 的租约 ID 匹配。 如果请求不包含租约 ID 或无效，则操作将失败，状态代码为 412（前置条件失败）。

--metadata

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

--sas-token

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

--source-account-key

源 Blob 的存储帐户密钥。

--source-account-name

源 Blob 的存储帐户名称。

--source-blob

源存储帐户的 Blob 名称。

--source-container

源存储帐户的容器名称。

--source-lease-id

仅当给定的租约 ID 与源 Blob 的活动租约 ID 匹配时，才指定此操作来执行复制 Blob 操作。

--source-sas

源存储帐户的共享访问签名。

--source-snapshot

源存储帐户的 blob 快照。

--source-uri -u

长度最多为 2 知识库(KB) 的 URL，用于指定 Azure 页 Blob。 该值应采用 URL 编码，因为它将显示在请求 URI 中。 复制源必须是快照，并且包含有效的 SAS 令牌或公共令牌。 示例：https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>&sastoken。

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