Recovery Points - List
列出备份项的备份副本。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints?api-version=2025-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints?api-version=2025-08-01&$filter={$filter}
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
container
|
path | True |
string |
需要获取其详细信息的容器的名称。 |
|
fabric
|
path | True |
string |
BackupFabricResource 的名称 |
|
protected
|
path | True |
string |
要获取其详细信息的备份项名称。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
资源组的名称。 此名称不区分大小写。 |
|
subscription
|
path | True |
string minLength: 1 |
目标订阅的 ID。 |
|
vault
|
path | True |
string |
VaultResource 的名称 |
|
api-version
|
query | True |
string minLength: 1 |
要用于此操作的 API 版本。 |
|
$filter
|
query |
string |
OData 筛选器选项。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
Azure作已成功完成。 |
|
| Other Status Codes |
意外的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
| 名称 | 说明 |
|---|---|
| user_impersonation | 模拟用户帐户 |
示例
Get Protected Azure Vm Recovery Points
示例请求
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?api-version=2025-08-01
示例响应
{
"nextLink": null,
"value": [
{
"name": "22244821112382",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
"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/22244821112382",
"properties": {
"isInstantIlrSessionActive": false,
"isManagedVirtualMachine": true,
"isSourceVMEncrypted": false,
"objectType": "IaasVMRecoveryPoint",
"originalStorageAccountOption": false,
"recoveryPointAdditionalInfo": "",
"recoveryPointMoveReadinessInfo": {
"Archive": {
"isReadyForMove": true
}
},
"recoveryPointTierDetails": [
{
"type": "InstantRP",
"status": "Deleted"
},
{
"type": "HardenedRP",
"status": "Valid"
}
],
"recoveryPointTime": "2017-12-21T22:48:25.4353958Z",
"recoveryPointType": "CrashConsistent",
"sourceVMStorageType": "NormalStorage",
"virtualMachineSize": "Standard_D1"
}
},
{
"name": "24977149827250",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
"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/24977149827250",
"properties": {
"isInstantIlrSessionActive": false,
"isManagedVirtualMachine": true,
"isPrivateAccessEnabledOnAnyDisk": true,
"isSourceVMEncrypted": false,
"objectType": "IaasVMRecoveryPoint",
"originalStorageAccountOption": false,
"recoveryPointAdditionalInfo": "",
"recoveryPointMoveReadinessInfo": {
"ArchivedRP": {
"additionalInfo": "Recovery point cannot be moved to archive tier since it has already been moved.",
"isReadyForMove": false
}
},
"recoveryPointTierDetails": [
{
"type": "InstantRP",
"status": "Deleted"
},
{
"type": "HardenedRP",
"status": "Deleted"
},
{
"type": "ArchivedRP",
"extendedInfo": {
"RehydratedRPExpiryTime": "2020-12-21T22:48:25.4353958Z"
},
"status": "Rehydrated"
}
],
"recoveryPointTime": "2017-12-20T22:49:44.3317945Z",
"recoveryPointType": "CrashConsistent",
"sourceVMStorageType": "NormalStorage",
"virtualMachineSize": "Standard_D1",
"zones": [
"1"
]
}
},
{
"name": "70477518625276",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/FijiValidation-asr-microsoftrrdclab3-408/providers/Microsoft.RecoveryServices/vaults/testVault408/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;fijivalidation-asr-microsoftrrdclab3-408;vm408/protectedItems/VM;iaasvmcontainerv2;fijivalidation-asr-microsoftrrdclab3-408;vm408/recoveryPoints/70477518625276",
"properties": {
"extendedLocation": {
"name": "microsoftrrdclab3",
"type": "EdgeZone"
},
"isInstantIlrSessionActive": false,
"isManagedVirtualMachine": true,
"isPrivateAccessEnabledOnAnyDisk": false,
"isSourceVMEncrypted": true,
"objectType": "IaasVMRecoveryPoint",
"originalStorageAccountOption": false,
"osType": "Windows",
"recoveryPointAdditionalInfo": "",
"recoveryPointMoveReadinessInfo": {
"ArchivedRP": {
"additionalInfo": "We're still determining if this Recovery Point can be moved.. Please check again after some time.",
"isReadyForMove": false
}
},
"recoveryPointTierDetails": [
{
"type": "InstantRP",
"status": "Valid"
},
{
"type": "HardenedRP",
"status": "Valid"
}
],
"recoveryPointTime": "2023-09-22T20:02:00.1225746Z",
"recoveryPointType": "CrashConsistent",
"securityType": "None",
"sourceVMStorageType": "PremiumVMOnPartialPremiumStorage",
"virtualMachineSize": "Standard_D2s_v3"
}
}
]
}
定义
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。 |
createdByType
创建资源的标识的类型。
| 值 | 说明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DiskInformation
磁盘信息
| 名称 | 类型 | 说明 |
|---|---|---|
| lun |
integer (int32) |
|
| name |
string |
ErrorDetail
Error Detail 类,用于封装 Code、Message 和 Recommendations。
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
错误代码。 |
| message |
string |
与代码相关的错误消息。 |
| recommendations |
string[] |
建议字符串列表。 |
ErrorResponse
错误响应
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
错误对象。 |
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。 示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
资源所在的地理位置 |
| name |
string |
资源的名称 |
| properties |
RecoveryPoint:
|
RecoveryPointResource 属性 |
| systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
| tags |
object |
资源标记。 |
| type |
string |
资源类型。 例如,“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
RecoveryPointResourceList
RecoveryPoint 资源列表
| 名称 | 类型 | 说明 |
|---|---|---|
| nextLink |
string |
用于提取下一页资源的 URI,每个 API 调用最多返回每页 200 个资源。 如果资源总数超过 200,请使用 ListNext() 提取下一页。 |
| value |
资源列表。 |
RecoveryPointTierInformation
恢复点层信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| extendedInfo |
object |
恢复点层状态。 |
| status |
恢复点层状态。 |
|
| type |
恢复点层类型。 |
RecoveryPointTierInformationV2
RecoveryPoint 层信息 V2
| 名称 | 类型 | 说明 |
|---|---|---|
| extendedInfo |
object |
恢复点层状态。 |
| status |
恢复点层状态。 |
|
| type |
恢复点层类型。 |
RecoveryPointTierStatus
恢复点层状态。
| 值 | 说明 |
|---|---|
| Invalid | |
| Valid | |
| Disabled | |
| Deleted | |
| Rehydrated |
RecoveryPointTierType
恢复点层类型。
| 值 | 说明 |
|---|---|
| Invalid | |
| InstantRP | |
| HardenedRP | |
| ArchivedRP |
RestorePointType
还原点的类型
| 值 | 说明 |
|---|---|
| Invalid | |
| Full | |
| Log | |
| Differential | |
| Incremental | |
| SnapshotFull | |
| SnapshotCopyOnlyFull |
SQLDataDirectory
SQLDataDirectory 信息
| 名称 | 类型 | 说明 |
|---|---|---|
| logicalName |
string |
文件的逻辑名称 |
| path |
string |
文件路径 |
| type |
数据目录映射的类型 |
SQLDataDirectoryType
数据目录映射的类型
| 值 | 说明 |
|---|---|
| Invalid | |
| Data | |
| Log |
systemData
与创建和上次修改资源相关的元数据。
| 名称 | 类型 | 说明 |
|---|---|---|
| createdAt |
string (date-time) |
资源创建时间戳(UTC)。 |
| createdBy |
string |
创建资源的标识。 |
| createdByType |
创建资源的标识的类型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的资源时间戳(UTC) |
| lastModifiedBy |
string |
上次修改资源的标识。 |
| lastModifiedByType |
上次修改资源的标识的类型。 |