Recovery Points - Get
提供使用 RecoveryPointID 标识的已备份数据的信息。 这是一个异步操作。 若要了解操作的状态,请调用 GetProtectedItemOperationResult API。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}?api-version=2025-02-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
container
|
path | True |
string |
与备份项关联的容器名称。 |
fabric
|
path | True |
string |
与备份项关联的结构名称。 |
protected
|
path | True |
string |
备份了需要提取其备份数据的项名称。 |
recovery
|
path | True |
string |
RecoveryPointID 表示要提取的备份数据。 |
resource
|
path | True |
string |
恢复服务保管库所在的资源组的名称。 |
subscription
|
path | True |
string |
订阅 ID。 |
vault
|
path | True |
string |
恢复服务保管库的名称。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
好的 |
|
Other Status Codes |
描述操作失败的原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户。 |
示例
Get Azure Vm Recovery Point Details
示例请求
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/26083826328862?api-version=2025-02-01
示例响应
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/26083826328862",
"name": "26083826328862",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
"properties": {
"objectType": "IaasVMRecoveryPoint",
"recoveryPointType": "CrashConsistent",
"recoveryPointTime": "2017-11-22T22:32:46.6088472Z",
"recoveryPointAdditionalInfo": "",
"sourceVMStorageType": "NormalStorage",
"isSourceVMEncrypted": false,
"isInstantIlrSessionActive": false,
"recoveryPointTierDetails": [
{
"type": "HardenedRP",
"status": "Valid"
}
],
"recoveryPointMoveReadinessInfo": {
"ArchivedRP": {
"isReadyForMove": true
}
},
"isManagedVirtualMachine": true,
"virtualMachineSize": "Standard_D1",
"originalStorageAccountOption": false,
"zones": [
"1"
],
"isPrivateAccessEnabledOnAnyDisk": true
}
}
定义
AzureFileShareRecoveryPoint
特定于 Azure 文件共享工作负荷的备份副本。
名称 | 类型 | 说明 |
---|---|---|
fileShareSnapshotUri |
string |
包含文件共享快照的 URL(如果适用) |
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointSizeInGB |
integer (int32) |
包含恢复点大小 |
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTime |
string (date-time) |
创建此备份副本的时间。 |
recoveryPointType |
string |
备份副本的类型。 指定它是崩溃一致的备份还是应用一致。 |
AzureWorkloadPointInTimeRecoveryPoint
特定于 PointInTime 的恢复点
名称 | 类型 | 说明 |
---|---|---|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
timeRanges |
日志范围列表 |
|
type |
还原点的类型 |
AzureWorkloadRecoveryPoint
特定于工作负荷的恢复点,专门封装完整/差异恢复点
名称 | 类型 | 说明 |
---|---|---|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
type |
还原点的类型 |
AzureWorkloadSAPAsePointInTimeRecoveryPoint
特定于 SAPAse 中 PointInTime 的恢复点
名称 | 类型 | 说明 |
---|---|---|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
timeRanges |
日志范围列表 |
|
type |
还原点的类型 |
AzureWorkloadSAPAseRecoveryPoint
SAPAse 特定的恢复点,专门封装完整/差异恢复点
名称 | 类型 | 说明 |
---|---|---|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
type |
还原点的类型 |
AzureWorkloadSAPHanaPointInTimeRecoveryPoint
特定于 SAPHana 中 PointInTime 的恢复点
名称 | 类型 | 说明 |
---|---|---|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
timeRanges |
日志范围列表 |
|
type |
还原点的类型 |
AzureWorkloadSAPHanaRecoveryPoint
SAPHana 特定的恢复点,专门封装完整/差异恢复点
名称 | 类型 | 说明 |
---|---|---|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
type |
还原点的类型 |
AzureWorkloadSQLPointInTimeRecoveryPoint
特定于 PointInTime 的恢复点
名称 | 类型 | 说明 |
---|---|---|
extendedInfo |
提供数据目录详细信息的扩展信息。 将在两种情况下填充:当使用 GetRecoveryPoint 访问特定恢复点时,或者在仅使用 ExtendedInfo 查询筛选器为 Log RP 调用 ListRecoveryPoints 时 |
|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
timeRanges |
日志范围列表 |
|
type |
还原点的类型 |
AzureWorkloadSQLRecoveryPoint
SQL 特定的恢复点,专门封装完整/差异恢复点以及扩展信息
名称 | 类型 | 说明 |
---|---|---|
extendedInfo |
提供数据目录详细信息的扩展信息。 将在两种情况下填充:当使用 GetRecoveryPoint 访问特定恢复点时,或者在仅使用 ExtendedInfo 查询筛选器为 Log RP 调用 ListRecoveryPoints 时 |
|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTimeInUTC |
string (date-time) |
创建恢复点的 UTC 时间 |
type |
还原点的类型 |
AzureWorkloadSQLRecoveryPointExtendedInfo
扩展信息类详细信息
名称 | 类型 | 说明 |
---|---|---|
dataDirectoryPaths |
还原操作期间的数据目录路径列表。 |
|
dataDirectoryTimeInUTC |
string (date-time) |
捕获数据目录信息的 UTC 时间 |
BEKDetails
BEK 是 bitlocker 加密密钥。
名称 | 类型 | 说明 |
---|---|---|
secretData |
string |
BEK 数据。 |
secretUrl |
string |
机密为 BEK。 |
secretVaultId |
string |
存储此机密的 Key Vault 的 ID。 |
CloudError
容器实例服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
CloudErrorBody
容器实例服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
有关错误的其他详细信息的列表。 |
|
message |
string |
描述错误的消息,旨在适合在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,错误属性的名称。 |
DiskInformation
磁盘信息
名称 | 类型 | 说明 |
---|---|---|
lun |
integer (int32) |
|
name |
string |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ExtendedLocation
VM 所在的恢复点的扩展位置。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
扩展位置的名称。 |
type |
string |
扩展位置的类型。 可能的值包括:“EdgeZone” |
GenericRecoveryPoint
通用备份副本。
名称 | 类型 | 说明 |
---|---|---|
friendlyName |
string |
备份副本的友好名称。 |
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
recoveryPointAdditionalInfo |
string |
与此备份副本关联的其他信息。 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTime |
string (date-time) |
创建此备份副本的时间。 |
recoveryPointType |
string |
备份副本的类型。 |
IaasVMRecoveryPoint
特定于 IaaS VM 工作负荷的备份副本。
名称 | 类型 | 说明 |
---|---|---|
extendedLocation |
如果 VM 在公有云中,则 VM 恢复点的扩展位置应为 null |
|
isInstantIlrSessionActive |
boolean |
要从此备份副本恢复项的会话是否仍然处于活动状态。 |
isManagedVirtualMachine |
boolean |
VM 是否与托管磁盘一起 |
isPrivateAccessEnabledOnAnyDisk |
boolean |
此标志表示 VM 中的任何磁盘是否正在使用专用访问网络设置 |
isSourceVMEncrypted |
boolean |
标识创建备份副本时 VM 是否已加密。 |
keyAndSecret |
恢复加密 VM 所需的详细信息。 仅适用于 IsSourceVMEncrypted 为 true 时。 |
|
objectType | string: |
此属性将用作用于确定类型多态链中特定类型的鉴别器。 |
originalStorageAccountOption |
boolean |
原始存储帐户选项 |
osType |
string |
OS 类型 |
recoveryPointAdditionalInfo |
string |
与此备份副本关联的其他信息。 |
recoveryPointDiskConfiguration |
磁盘配置 |
|
recoveryPointMoveReadinessInfo |
<string,
Recovery |
要移动到另一层的 RP 资格 |
recoveryPointProperties |
恢复点的属性 |
|
recoveryPointTierDetails |
恢复点层信息。 |
|
recoveryPointTime |
string (date-time) |
创建此备份副本的时间。 |
recoveryPointType |
string |
备份副本的类型。 |
securityType |
string |
磁盘的安全类型 |
sourceVMStorageType |
string |
创建其备份副本的 VM 的存储类型。 |
virtualMachineSize |
string |
虚拟机大小 |
zones |
string[] |
标识备份时 VM 的区域。 仅适用于区域固定的 Vm |
KEKDetails
KEK 是 BEK 的加密密钥。
名称 | 类型 | 说明 |
---|---|---|
keyBackupData |
string |
KEK 数据。 |
keyUrl |
string |
关键是 KEK。 |
keyVaultId |
string |
存储此密钥的 Key Vault ID。 |
KeyAndSecretDetails
BEK 是 bitlocker 密钥。 KEK 是 BEK 的加密密钥,如果 VM 已加密,我们将存储以下详细信息:
- Secret(BEK) - URL + 备份数据 + vaultId。
- Key(KEK) - URL + 备份数据 + vaultId。
- EncryptionMechanism BEK 和 KEK 可能具有不同的保管库 ID。
名称 | 类型 | 说明 |
---|---|---|
bekDetails |
BEK 是 bitlocker 加密密钥。 |
|
encryptionMechanism |
string |
加密机制:None/SinglePass/DoublePass |
kekDetails |
KEK 是 BEK 的加密密钥。 |
PointInTimeRange
提供有关日志范围的详细信息
名称 | 类型 | 说明 |
---|---|---|
endTime |
string (date-time) |
日志恢复的时间范围的结束时间。 |
startTime |
string (date-time) |
日志恢复的时间范围的开始时间。 |
RecoveryPointDiskConfiguration
磁盘配置
名称 | 类型 | 说明 |
---|---|---|
excludedDiskList |
从备份中排除的磁盘的信息 |
|
includedDiskList |
备份中包含的磁盘信息 |
|
numberOfDisksAttachedToVm |
integer (int32) |
附加到 VM 的磁盘数 |
numberOfDisksIncludedInBackup |
integer (int32) |
备份中包含的磁盘数 |
RecoveryPointMoveReadinessInfo
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
string |
|
isReadyForMove |
boolean |
RecoveryPointProperties
恢复点的属性
名称 | 类型 | 说明 |
---|---|---|
expiryTime |
string |
UTC 恢复点的到期时间。 |
isSoftDeleted |
boolean |
布尔值,指示 RP 是否处于软删除状态 |
ruleName |
string |
在控制生命周期的恢复点上标记的规则名称 |
RecoveryPointResource
备份副本的基类。 特定于工作负荷的备份副本派生自此类。
名称 | 类型 | 说明 |
---|---|---|
eTag |
string |
可选 ETag。 |
id |
string |
资源 ID 表示资源的完整路径。 |
___location |
string |
资源位置。 |
name |
string |
与资源关联的资源名称。 |
properties |
RecoveryPoint:
|
RecoveryPointResource 属性 |
tags |
object |
资源标记。 |
type |
string |
资源类型表示命名空间/ResourceType/ResourceType/... |
RecoveryPointTierInformation
恢复点层信息。
名称 | 类型 | 说明 |
---|---|---|
extendedInfo |
object |
恢复点层状态。 |
status |
恢复点层状态。 |
|
type |
恢复点层类型。 |
RecoveryPointTierInformationV2
RecoveryPoint 层信息 V2
名称 | 类型 | 说明 |
---|---|---|
extendedInfo |
object |
恢复点层状态。 |
status |
恢复点层状态。 |
|
type |
恢复点层类型。 |
RecoveryPointTierStatus
恢复点层状态。
值 | 说明 |
---|---|
Deleted | |
Disabled | |
Invalid | |
Rehydrated | |
Valid |
RecoveryPointTierType
恢复点层类型。
值 | 说明 |
---|---|
ArchivedRP | |
HardenedRP | |
InstantRP | |
Invalid |
RestorePointType
还原点的类型
值 | 说明 |
---|---|
Differential | |
Full | |
Incremental | |
Invalid | |
Log | |
SnapshotCopyOnlyFull | |
SnapshotFull |
SQLDataDirectory
SQLDataDirectory 信息
名称 | 类型 | 说明 |
---|---|---|
logicalName |
string |
文件的逻辑名称 |
path |
string |
文件路径 |
type |
数据目录映射的类型 |
SQLDataDirectoryType
数据目录映射的类型
值 | 说明 |
---|---|
Data | |
Invalid | |
Log |