对象复制以异步方式在源存储帐户和目标帐户之间复制块 blob。 有关对象复制的详细信息,请参阅 对象复制。
配置对象复制时,需要创建复制策略,以指定源存储帐户和目标帐户。 复制策略包括一个或多个规则,用于指定源容器和目标容器,并指明复制源容器中的哪些块 blob。
本文介绍了如何使用 Azure 门户、PowerShell 或 Azure CLI 为存储帐户配置对象复制。 还可以使用 Azure 存储资源提供程序客户端库之一来配置对象复制。
Note: 具有分层命名空间 (Azure Data Lake Storage Gen2) 的帐户尚不支持此功能。 若要了解详细信息,请参阅 Azure Data Lake Storage Gen2 中可用的 Blob 存储功能。
创建复制策略和规则
在配置对象复制前,如果还没有源存储帐户和目标存储帐户,请先创建它们。 这两个帐户都必须是常规用途 v2 存储帐户。 有关详细信息,请参阅创建 Azure 存储帐户。
对象复制需要同时为源帐户和目标帐户启用 blob 版本管理,并且为源帐户启用了 blob 更改源。 若要了解有关 blob 版本控制的详细信息,请参阅 blob 版本控制。 若要了解有关更改源的详细信息,请参阅 Azure Blob 存储中的更改源支持。 请记住,启用这些功能可能会产生额外的成本。
存储帐户可用作最多两个目标帐户的源帐户。 源帐户和目标帐户可能位于同一区域或不同区域。 它们也可以驻留在不同的订阅中,并以不同的 Azure Active Directory (Azure AD) 租户。 只能为每对帐户创建一个复制策略。
配置对象复制时,可以通过 Azure 存储资源提供程序在目标帐户上创建复制策略。 创建复制策略后,Azure 存储为其分配策略 ID。 然后,你必须使用策略 ID 将该复制策略与源帐户相关联。 源帐户和目标帐户上的策略 ID 必须相同,才能进行复制。
若要为存储帐户配置对象复制策略,你必须分配有 Azure 资源管理器 参与者 角色,范围为存储帐户级别或更高级别。 有关详细信息,请参阅 azure RBAC) 文档中基于 Azure 角色的访问控制中的 azure 内置角色 (。
当你有权访问两个存储帐户时,配置对象复制
如果你有权访问源和目标存储帐户,则可以在两个帐户上配置对象复制策略。
在 Azure 门户中配置对象复制前,如果还没有源容器和目标容器,请在它们各自的存储帐户中创建它们。 此外,在源帐户上启用 blob 版本控制和更改源,并在目标帐户上启用 blob 版本控制。
Azure 门户
在为目标帐户配置策略后,Azure 门户会自动在源帐户上创建策略。
若要在 Azure 门户中创建复制策略,请按照以下步骤操作:
-
在 Azure 门户中,转到源存储帐户。
-
在 Blob 服务 下,选择 对象复制。
-
选择 " 设置复制规则"。
-
选择目标订阅和存储帐户。
-
在“容器对”部分中,选择源帐户中的源容器,以及目标帐户中的目标容器。 每个复制策略最多可以创建 10 个容器对。
下图展示了一组复制规则。
-
如果需要,指定一个或多个筛选器,以便只复制与前缀模式匹配的 blob。 例如,如果指定前缀
b,则只会复制名称以此字母开头的 blob。 可以将虚拟目录指定为前缀的一部分。 前缀字符串不支持通配符。下图展示了限制在复制规则中复制哪些 blob 的筛选器。
-
默认情况下,复制范围设置为只复制新对象。 若要复制容器中的所有对象,或从自定义日期和时间开始复制对象,请选择“更改”链接,然后为容器对配置复制范围。
下图显示了从指定的日期和时间开始复制对象的自定义复制范围。
-
选择“保存并应用”,以创建复制策略,并开始复制数据。
配置对象复制后,Azure 门户会显示复制策略和规则,如下图所示。
PowerShell
若要使用 PowerShell 创建复制策略,请先安装 2.5.0 PowerShell 模块的版本或更高版本。 有关如何安装 Azure PowerShell 的详细信息,请参阅使用 PowerShellGet 安装 Azure PowerShell。
下面的示例展示了如何在源帐户和目标帐户上创建复制策略。 请注意将尖括号中的值替换为你自己的值:
# Sign in to your Azure account.
Connect-AzAccount
# Set variables.
$rgName = "<resource-group>"
$srcAccountName = "<source-storage-account>"
$destAccountName = "<destination-storage-account>"
$srcContainerName1 = "source-container1"
$destContainerName1 = "dest-container1"
$srcContainerName2 = "source-container2"
$destContainerName2 = "dest-container2"
# Enable blob versioning and change feed on the source account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgname `
-StorageAccountName $srcAccountName `
-EnableChangeFeed $true `
-IsVersioningEnabled $true
# Enable blob versioning on the destination account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgname `
-StorageAccountName $destAccountName `
-IsVersioningEnabled $true
# List the service properties for both accounts.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgname `
-StorageAccountName $srcAccountName
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgname `
-StorageAccountName $destAccountName
# Create containers in the source and destination accounts.
Get-AzStorageAccount -ResourceGroupName $rgname -StorageAccountName $srcAccountName |
New-AzStorageContainer $srcContainerName1
Get-AzStorageAccount -ResourceGroupName $rgname -StorageAccountName $destAccountName |
New-AzStorageContainer $destContainerName1
Get-AzStorageAccount -ResourceGroupName $rgname -StorageAccountName $srcAccountName |
New-AzStorageContainer $srcContainerName2
Get-AzStorageAccount -ResourceGroupName $rgname -StorageAccountName $destAccountName |
New-AzStorageContainer $destContainerName2
# Define replication rules for each container.
$rule1 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName1 `
-DestinationContainer $destContainerName1 `
-PrefixMatch b
$rule2 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName2 `
-DestinationContainer $destContainerName2 `
-MinCreationTime 2020-05-10T00:00:00Z
# Create the replication policy on the destination account.
$destPolicy = Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgname `
-StorageAccountName $destAccountName `
-PolicyId default `
-SourceAccount $srcAccountName `
-Rule $rule1,$rule2
# Create the same policy on the source account.
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgname `
-StorageAccountName $srcAccountName `
-InputObject $destPolicy
Azure CLI
若要使用 Azure CLI 创建复制策略,请先安装 Azure CLI 2.11.1 或更高版本。 有关详细信息,请参阅 Azure CLI 入门。
接下来,在源和目标存储帐户上启用 blob 版本控制,并通过调用 az storage account blob-service-properties update 命令启用源帐户的更改源。 请注意将尖括号中的值替换为你自己的值:
az login
az storage account blob-service-properties update \
--resource-group <resource-group> \
--account-name <source-storage-account> \
--enable-versioning \
--enable-change-feed
az storage account blob-service-properties update \
--resource-group <resource-group> \
--account-name <dest-storage-account> \
--enable-versioning
在它们各自的存储帐户中创建源容器和目标容器。
az storage container create \
--account-name <source-storage-account> \
--name source-container-1 \
--auth-mode login
az storage container create \
--account-name <source-storage-account> \
--name source-container-2 \
--auth-mode login
az storage container create \
--account-name <dest-storage-account> \
--name dest-container-1 \
--auth-mode login
az storage container create \
--account-name <dest-storage-account> \
--name dest-container-1 \
--auth-mode login
通过调用 az storage account 或-policy create,在目标帐户上创建新的复制策略和关联的规则。
az storage account or-policy create \
--account-name <dest-storage-account> \
--resource-group <resource-group> \
--source-account <source-storage-account> \
--destination-account <dest-storage-account> \
--source-container source-container-1 \
--destination-container dest-container-1 \
--min-creation-time '2020-09-10T00:00:00Z' \
--prefix-match a
创建新策略时,Azure 存储会为其设置策略 ID。 若要向策略添加其他规则,请调用 az storage account 或-policy rule add 并提供策略 ID。
az storage account or-policy rule add \
--account-name <dest-storage-account> \
--resource-group <resource-group> \
--source-container source-container-2 \
--destination-container dest-container-2 \
--policy-id <policy-id> \
--prefix-match b
接下来,使用策略 ID 在源帐户上创建策略。
az storage account or-policy show \
--resource-group <resource-group> \
--account-name <dest-storage-account> \
--policy-id <policy-id> |
az storage account or-policy create --resource-group <resource-group> \
--account-name <source-storage-account> \
--policy "@-"
仅当你有权访问目标帐户时,配置对象复制
如果你没有访问源存储帐户的权限,则可以在目标帐户上配置对象复制,并向另一个用户提供一个包含策略定义的 JSON 文件,以便在源帐户上创建相同的策略。 例如,如果源帐户与目标帐户位于不同的 Azure AD 租户中,则可以使用此方法配置对象复制。
请记住,你必须被分配到作用域为目标存储帐户级别或更高级别的 Azure 资源管理器 参与者 角色才能创建策略。 有关详细信息,请参阅 azure RBAC) 文档中基于 Azure 角色的访问控制中的 azure 内置角色 (。
下表总结了每个方案中的 JSON 文件中的策略 ID 和规则 Id 要使用的值。
| 为此帐户创建 JSON 文件时 .。。 | 将策略 ID 和规则 Id 设置为此值 .。。 |
|---|---|
| 目标帐户 | 字符串值 默认 值。 Azure 存储将为你创建策略 ID 和规则 Id。 |
| 源帐户 | 当你将在目标帐户上定义的策略作为 JSON 文件下载时,将返回策略 ID 和规则 Id 的值。 |
下面的示例定义了一个目标帐户的复制策略,该策略包含一个与前缀 b 匹配的规则,并为要复制的 blob 设置最小创建时间。 请注意将尖括号中的值替换为你自己的值:
{
"properties": {
"policyId": "default",
"sourceAccount": "<source-account>",
"destinationAccount": "<dest-account>",
"rules": [
{
"ruleId": "default",
"sourceContainer": "<source-container>",
"destinationContainer": "<destination-container>",
"filters": {
"prefixMatch": [
"b"
],
"minCreationTime": "2020-08-028T00:00:00Z"
}
}
]
}
}
Azure 门户
若要使用 Azure 门户中的 JSON 文件在目标帐户上配置对象复制,请执行以下步骤:
-
创建一个本地 JSON 文件,用于定义针对目标帐户的复制策略。 将 policyId 字段设置为 默认值 ,以便 Azure 存储区将定义策略 ID。
若要创建定义复制策略的 JSON 文件,一种简单的方法是先在 Azure 门户中的两个存储帐户之间创建测试复制策略。 然后,你可以下载复制规则并根据需要修改 JSON 文件。
-
在 Azure 门户中导航到目标帐户的 对象复制 设置。
-
选择 " 上载复制规则"。
-
上传 JSON 文件。 Azure 门户显示要创建的策略和规则,如下图所示。
-
选择 " 上传 ",在目标帐户上创建复制策略。
然后,你可以下载包含策略定义的 JSON 文件,你可以向其他用户提供该文件来配置源帐户。 若要下载此 JSON 文件,请执行以下步骤:
-
在 Azure 门户中导航到目标帐户的 对象复制 设置。
-
选择要下载的策略旁边的 " 更多 " 按钮,然后选择 " 下载规则",如下图所示。
-
将 JSON 文件保存到本地计算机,以便与其他用户共享,以便在源帐户上配置策略。
下载的 JSON 文件包含 Azure 存储为目标帐户上的策略创建的策略 ID。 必须使用相同的策略 ID 在源帐户上配置对象复制。
请记住,通过 Azure 门户上载 JSON 文件以创建目标帐户的复制策略时,不会在源帐户中自动创建相同的策略。 在 Azure 存储开始复制对象之前,其他用户必须在源帐户上创建策略。
PowerShell
若要从 PowerShell 下载包含目标帐户的复制策略定义的 JSON 文件,请调用 AzStorageObjectReplicationPolicy 命令以返回策略。 然后,将策略转换为 JSON,并将其另存为本地文件,如下面的示例中所示。 请记住,用尖括号替换值,并将文件路径替换为自己的值:
$rgName = "<resource-group>"
$destAccountName = "<destination-storage-account>"
$destPolicy = Get-AzStorageObjectReplicationPolicy -ResourceGroupName $rgname `
-StorageAccountName $destAccountName
$destPolicy | ConvertTo-Json -Depth 5 > c:\temp\json.txt
若要在 PowerShell 中使用 JSON 文件定义源帐户的复制策略,请检索本地文件,并将 JSON 转换为对象。 然后,调用 AzStorageObjectReplicationPolicy 命令在源帐户上配置策略,如以下示例中所示。 请记住,用尖括号替换值,并将文件路径替换为自己的值:
$object = Get-Content -Path C:\temp\json.txt | ConvertFrom-Json
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgname `
-StorageAccountName $srcAccountName `
-PolicyId $object.PolicyId `
-SourceAccount $object.SourceAccount `
-DestinationAccount $object.DestinationAccount `
-Rule $object.Rules
Azure CLI
若要从 Azure CLI 将目标帐户的复制策略定义写入 JSON 文件,请调用 az storage account 或-policy show 命令并输出到文件。
下面的示例将策略定义写入 policy.js上 的名为的 JSON 文件。 请记住,用尖括号替换值,并将文件路径替换为自己的值:
az storage account or-policy show \
--account-name <dest-account-name> \
--policy-id <policy-id> > policy.json
若要使用 JSON 文件在 Azure CLI 的源帐户上配置复制策略,请调用 az storage account 或-policy create 命令并引用文件上的 policy.js 。 请记住,用尖括号替换值,并将文件路径替换为自己的值:
az storage account or-policy create \
-resource-group <resource-group> \
--source-account <source-account-name> \
--policy @policy.json
检查 blob 的复制状态
你可以使用 Azure 门户、PowerShell 或 Azure CLI 检查源帐户中的 blob 的复制状态。 复制完成或失败之前,不会填充对象复制属性。
Azure 门户
若要检查 Azure 门户中源帐户的 blob 的复制状态,请执行以下步骤:
- 导航到 Azure 门户中的源帐户。
- 找到包含源 blob 的容器。
- 选择要显示其属性的 blob。 如果 blob 已成功复制,则会在 " 对象复制 " 部分看到状态设置为 "已 完成"。 还列出了用于管理此容器的对象复制的规则的复制策略 ID 和 ID。
PowerShell
若要使用 PowerShell 检查源帐户中 blob 的复制状态,请获取 "对象复制 ReplicationStatus " 属性的值,如以下示例中所示。 请注意将尖括号中的值替换为你自己的值:
$ctxSrc = (Get-AzStorageAccount -ResourceGroupName $rgname `
-StorageAccountName $srcAccountName).Context
$blobSrc = Get-AzStorageBlob -Container $srcContainerName1 `
-Context $ctxSrc `
-Blob <blob-name>
$blobSrc.BlobProperties.ObjectReplicationSourceProperties[0].Rules[0].ReplicationStatus
Azure CLI
若要使用 Azure CLI 检查源帐户中的 blob 的复制状态,请获取 "对象复制 状态 " 属性的值,如以下示例中所示:
az storage blob show \
--account-name <source-account-name> \
--container-name <source-container-name> \
--name <source-blob-name> \
--query 'objectReplicationSourceProperties[].rules[].status' \
--output tsv \
--auth-mode login
如果源帐户中 blob 的复制状态指示失败,则调查以下可能的原因:
- 请确保已在目标帐户上配置对象复制策略。
- 验证目标容器是否仍然存在。
- 如果源 blob 已使用客户提供的密钥在写入操作过程中进行了加密,则对象复制将失败。 有关客户提供的密钥的详细信息,请参阅在对 Blob 存储的请求中提供加密密钥。
删除复制策略
若要删除复制策略及其关联的规则,请使用 Azure 门户、PowerShell 或 CLI。
Azure 门户
若要在 Azure 门户中删除复制策略,请按照以下步骤操作:
- 在 Azure 门户中,转到源存储帐户。
- 在“设置”下,选择“对象复制”。
- 单击策略名称旁边的“更多”按钮。
- 选择“删除规则”。
PowerShell
若要删除复制策略,请从源帐户和目标帐户中都删除复制策略。 删除策略还会删除与之关联的任何规则。
# Remove the policy from the destination account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgname `
-StorageAccountName $destAccountName `
-PolicyId $destPolicy.PolicyId
# Remove the policy from the source account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgname `
-StorageAccountName $srcAccountName `
-PolicyId $destPolicy.PolicyId
Azure CLI
若要删除复制策略,请从源帐户和目标帐户中都删除复制策略。 删除策略还会删除与之关联的任何规则。
az storage account or-policy delete \
--policy-id <policy-id> \
--account-name <source-storage-account> \
--resource-group <resource-group>
az storage account or-policy delete \
--policy-id <policy-id> \
--account-name <dest-storage-account> \
--resource-group <resource-group>
后续步骤
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 tamram)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
