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

Recovery Points - Get

服务:: Recovery Services - Backup

API 版本:: 2025-08-01

提供使用 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-08-01

URI 参数

名称	在	必需	类型	说明
containerName	path	True	string	需要获取其详细信息的容器的名称。
fabricName	path	True	string	BackupFabricResource 的名称
protectedItemName	path	True	string	要获取其详细信息的备份项名称。
recoveryPointId	path	True	string	RecoveryPointID 表示要提取的备份数据。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string minLength: 1	目标订阅的 ID。
vaultName	path	True	string	VaultResource 的名称
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	RecoveryPointResource	Azure作已成功完成。
Other Status Codes	ErrorResponse	意外的错误响应。

安全性

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

示例请求

HTTP

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

示例响应

状态代码:: 200

{
  "name": "26083826328862",
  "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/26083826328862",
  "properties": {
    "isInstantIlrSessionActive": false,
    "isManagedVirtualMachine": true,
    "isPrivateAccessEnabledOnAnyDisk": true,
    "isSourceVMEncrypted": false,
    "objectType": "IaasVMRecoveryPoint",
    "originalStorageAccountOption": false,
    "recoveryPointAdditionalInfo": "",
    "recoveryPointMoveReadinessInfo": {
      "ArchivedRP": {
        "isReadyForMove": true
      }
    },
    "recoveryPointTierDetails": [
      {
        "type": "HardenedRP",
        "status": "Valid"
      }
    ],
    "recoveryPointTime": "2017-11-22T22:32:46.6088472Z",
    "recoveryPointType": "CrashConsistent",
    "sourceVMStorageType": "NormalStorage",
    "virtualMachineSize": "Standard_D1",
    "zones": [
      "1"
    ]
  }
}

定义

名称	说明
AzureFileShareRecoveryPoint	特定于 Azure 文件共享工作负荷的备份副本。
AzureWorkloadPointInTimeRecoveryPoint	特定于 PointInTime 的恢复点
AzureWorkloadRecoveryPoint	特定于工作负荷的恢复点，专门封装完整/差异恢复点
AzureWorkloadSAPAsePointInTimeRecoveryPoint	特定于 SAPAse 中 PointInTime 的恢复点
AzureWorkloadSAPAseRecoveryPoint	SAPAse 特定的恢复点，专门封装完整/差异恢复点
AzureWorkloadSAPHanaPointInTimeRecoveryPoint	特定于 SAPHana 中 PointInTime 的恢复点
AzureWorkloadSAPHanaRecoveryPoint	SAPHana 特定的恢复点，专门封装完整/差异恢复点
AzureWorkloadSQLPointInTimeRecoveryPoint	特定于 PointInTime 的恢复点
AzureWorkloadSQLRecoveryPoint	SQL 特定的恢复点，专门封装完整/差异恢复点以及扩展信息
AzureWorkloadSQLRecoveryPointExtendedInfo	扩展信息类详细信息
BEKDetails	BEK 是 bitlocker 加密密钥。
createdByType	创建资源的标识的类型。
DiskInformation	磁盘信息
ErrorDetail	Error Detail 类，用于封装 Code、Message 和 Recommendations。
ErrorResponse	错误响应
ExtendedLocation	VM 所在的恢复点的扩展位置。
GenericRecoveryPoint	通用备份副本。
IaasVMRecoveryPoint	特定于 IaaS VM 工作负荷的备份副本。
KEKDetails	KEK 是 BEK 的加密密钥。
KeyAndSecretDetails	BEK 是 bitlocker 密钥。 KEK 是 BEK 的加密密钥，如果 VM 已加密，我们将存储以下详细信息： Secret（BEK） - URL + 备份数据 + vaultId。 Key（KEK） - URL + 备份数据 + vaultId。 EncryptionMechanism BEK 和 KEK 可能具有不同的保管库 ID。
PointInTimeRange	提供有关日志范围的详细信息
RecoveryPointDiskConfiguration	磁盘配置
RecoveryPointMoveReadinessInfo
RecoveryPointProperties	恢复点的属性
RecoveryPointResource	备份副本的基类。特定于工作负荷的备份副本派生自此类。
RecoveryPointTierInformation	恢复点层信息。
RecoveryPointTierInformationV2	RecoveryPoint 层信息 V2
RecoveryPointTierStatus	恢复点层状态。
RecoveryPointTierType	恢复点层类型。
RestorePointType	还原点的类型
SQLDataDirectory	SQLDataDirectory 信息
SQLDataDirectoryType	数据目录映射的类型
systemData	与创建和上次修改资源相关的元数据。

AzureFileShareRecoveryPoint

Object

特定于 Azure 文件共享工作负荷的备份副本。

名称	类型	说明
fileShareSnapshotUri	string	包含文件共享快照的 URL（如果适用）
objectType	string: AzureFileShareRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointSizeInGB	integer (int32)	包含恢复点大小
recoveryPointTierDetails	RecoveryPointTierInformation[]	恢复点层信息。
recoveryPointTime	string (date-time)	创建此备份副本的时间。
recoveryPointType	string	备份副本的类型。指定它是崩溃一致的备份还是应用一致。

AzureWorkloadPointInTimeRecoveryPoint

Object

特定于 PointInTime 的恢复点

名称	类型	说明
objectType	string: AzureWorkloadPointInTimeRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
timeRanges	PointInTimeRange[]	日志范围列表
type	RestorePointType	还原点的类型

AzureWorkloadRecoveryPoint

Object

特定于工作负荷的恢复点，专门封装完整/差异恢复点

名称	类型	说明
objectType	string: AzureWorkloadRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
type	RestorePointType	还原点的类型

AzureWorkloadSAPAsePointInTimeRecoveryPoint

Object

特定于 SAPAse 中 PointInTime 的恢复点

名称	类型	说明
objectType	string: AzureWorkloadSAPAsePointInTimeRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
timeRanges	PointInTimeRange[]	日志范围列表
type	RestorePointType	还原点的类型

AzureWorkloadSAPAseRecoveryPoint

Object

SAPAse 特定的恢复点，专门封装完整/差异恢复点

名称	类型	说明
objectType	string: AzureWorkloadSAPAseRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
type	RestorePointType	还原点的类型

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Object

特定于 SAPHana 中 PointInTime 的恢复点

名称	类型	说明
objectType	string: AzureWorkloadSAPHanaPointInTimeRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
timeRanges	PointInTimeRange[]	日志范围列表
type	RestorePointType	还原点的类型

AzureWorkloadSAPHanaRecoveryPoint

Object

SAPHana 特定的恢复点，专门封装完整/差异恢复点

名称	类型	说明
objectType	string: AzureWorkloadSAPHanaRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
type	RestorePointType	还原点的类型

AzureWorkloadSQLPointInTimeRecoveryPoint

Object

特定于 PointInTime 的恢复点

名称	类型	说明
extendedInfo	AzureWorkloadSQLRecoveryPointExtendedInfo	提供数据目录详细信息的扩展信息。将在两种情况下填充：当使用 GetRecoveryPoint 访问特定恢复点时，或者在仅使用 ExtendedInfo 查询筛选器为 Log RP 调用 ListRecoveryPoints 时
objectType	string: AzureWorkloadSQLPointInTimeRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
timeRanges	PointInTimeRange[]	日志范围列表
type	RestorePointType	还原点的类型

AzureWorkloadSQLRecoveryPoint

Object

SQL 特定的恢复点，专门封装完整/差异恢复点以及扩展信息

名称	类型	说明
extendedInfo	AzureWorkloadSQLRecoveryPointExtendedInfo	提供数据目录详细信息的扩展信息。将在两种情况下填充：当使用 GetRecoveryPoint 访问特定恢复点时，或者在仅使用 ExtendedInfo 查询筛选器为 Log RP 调用 ListRecoveryPoints 时
objectType	string: AzureWorkloadSQLRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTimeInUTC	string (date-time)	创建恢复点的 UTC 时间
type	RestorePointType	还原点的类型

AzureWorkloadSQLRecoveryPointExtendedInfo

Object

扩展信息类详细信息

名称	类型	说明
dataDirectoryPaths	SQLDataDirectory[]	还原操作期间的数据目录路径列表。
dataDirectoryTimeInUTC	string (date-time)	捕获数据目录信息的 UTC 时间

BEKDetails

Object

BEK 是 bitlocker 加密密钥。

名称	类型	说明
secretData	string	BEK 数据。
secretUrl	string	机密为 BEK。
secretVaultId	string	存储此机密的 Key Vault 的 ID。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

DiskInformation

Object

磁盘信息

名称	类型	说明
lun	integer (int32)
name	string

ErrorDetail

Object

Error Detail 类，用于封装 Code、Message 和 Recommendations。

名称	类型	说明
code	string	错误代码。
message	string	与代码相关的错误消息。
recommendations	string[]	建议字符串列表。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ExtendedLocation

Object

VM 所在的恢复点的扩展位置。

名称	类型	说明
name	string	扩展位置的名称。
type	string	扩展位置的类型。可能的值包括：“EdgeZone”

GenericRecoveryPoint

Object

通用备份副本。

名称	类型	说明
friendlyName	string	备份副本的友好名称。
objectType	string: GenericRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
recoveryPointAdditionalInfo	string	与此备份副本关联的其他信息。
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTime	string (date-time)	创建此备份副本的时间。
recoveryPointType	string	备份副本的类型。

IaasVMRecoveryPoint

Object

特定于 IaaS VM 工作负荷的备份副本。

名称	类型	说明
extendedLocation	ExtendedLocation	如果 VM 在公有云中，则 VM 恢复点的扩展位置应为 null
isInstantIlrSessionActive	boolean	要从此备份副本恢复项的会话是否仍然处于活动状态。
isManagedVirtualMachine	boolean	VM 是否与托管磁盘一起
isPrivateAccessEnabledOnAnyDisk	boolean	此标志表示 VM 中的任何磁盘是否正在使用专用访问网络设置
isSourceVMEncrypted	boolean	标识创建备份副本时 VM 是否已加密。
keyAndSecret	KeyAndSecretDetails	恢复加密 VM 所需的详细信息。仅适用于 IsSourceVMEncrypted 为 true 时。
objectType	string: IaasVMRecoveryPoint	此属性将用作用于确定类型多态链中特定类型的鉴别器。
originalStorageAccountOption	boolean	原始存储帐户选项
osType	string	OS 类型
recoveryPointAdditionalInfo	string	与此备份副本关联的其他信息。
recoveryPointDiskConfiguration	RecoveryPointDiskConfiguration	磁盘配置
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移动到另一层的 RP 资格
recoveryPointProperties	RecoveryPointProperties	恢复点的属性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢复点层信息。
recoveryPointTime	string (date-time)	创建此备份副本的时间。
recoveryPointType	string	备份副本的类型。
securityType	string	磁盘的安全类型
sourceVMStorageType	string	创建其备份副本的 VM 的存储类型。
virtualMachineSize	string	虚拟机大小
zones	string[]	标识备份时 VM 的区域。仅适用于区域固定的 Vm

KEKDetails

Object

KEK 是 BEK 的加密密钥。

名称	类型	说明
keyBackupData	string	KEK 数据。
keyUrl	string	关键是 KEK。
keyVaultId	string	存储此密钥的 Key Vault ID。

KeyAndSecretDetails

Object

BEK 是 bitlocker 密钥。 KEK 是 BEK 的加密密钥，如果 VM 已加密，我们将存储以下详细信息：

Secret（BEK） - URL + 备份数据 + vaultId。
Key（KEK） - URL + 备份数据 + vaultId。
EncryptionMechanism BEK 和 KEK 可能具有不同的保管库 ID。

名称	类型	说明
bekDetails	BEKDetails	BEK 是 bitlocker 加密密钥。
encryptionMechanism	string	加密机制：None/SinglePass/DoublePass
kekDetails	KEKDetails	KEK 是 BEK 的加密密钥。

PointInTimeRange

Object

提供有关日志范围的详细信息

名称	类型	说明
endTime	string (date-time)	日志恢复的时间范围的结束时间。
startTime	string (date-time)	日志恢复的时间范围的开始时间。

RecoveryPointDiskConfiguration

Object

磁盘配置

名称	类型	说明
excludedDiskList	DiskInformation[]	从备份中排除的磁盘的信息
includedDiskList	DiskInformation[]	备份中包含的磁盘信息
numberOfDisksAttachedToVm	integer (int32)	附加到 VM 的磁盘数
numberOfDisksIncludedInBackup	integer (int32)	备份中包含的磁盘数

RecoveryPointMoveReadinessInfo

Object

名称	类型	说明
additionalInfo	string
isReadyForMove	boolean

RecoveryPointProperties

Object

恢复点的属性

名称	类型	说明
expiryTime	string	UTC 恢复点的到期时间。
isSoftDeleted	boolean	布尔值，指示 RP 是否处于软删除状态
ruleName	string	在控制生命周期的恢复点上标记的规则名称

RecoveryPointResource

Object

备份副本的基类。特定于工作负荷的备份副本派生自此类。

名称	类型	说明
eTag	string	可选 ETag。
id	string	资源的完全限定资源 ID。示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	资源所在的地理位置
name	string	资源的名称
properties	RecoveryPoint: AzureFileShareRecoveryPoint AzureWorkloadPointInTimeRecoveryPoint AzureWorkloadRecoveryPoint AzureWorkloadSAPAsePointInTimeRecoveryPoint AzureWorkloadSAPAseRecoveryPoint AzureWorkloadSAPHanaPointInTimeRecoveryPoint AzureWorkloadSAPHanaRecoveryPoint AzureWorkloadSQLPointInTimeRecoveryPoint AzureWorkloadSQLRecoveryPoint GenericRecoveryPoint IaasVMRecoveryPoint	RecoveryPointResource 属性
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源类型。例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

RecoveryPointTierInformation

Object

恢复点层信息。

名称	类型	说明
extendedInfo	object	恢复点层状态。
status	RecoveryPointTierStatus	恢复点层状态。
type	RecoveryPointTierType	恢复点层类型。

RecoveryPointTierInformationV2

Object

RecoveryPoint 层信息 V2

名称	类型	说明
extendedInfo	object	恢复点层状态。
status	RecoveryPointTierStatus	恢复点层状态。
type	RecoveryPointTierType	恢复点层类型。

RecoveryPointTierStatus

枚举

恢复点层状态。

值	说明
Invalid
Valid
Disabled
Deleted
Rehydrated

RecoveryPointTierType

枚举

恢复点层类型。

值	说明
Invalid
InstantRP
HardenedRP
ArchivedRP

RestorePointType

枚举

还原点的类型

值	说明
Invalid
Full
Log
Differential
Incremental
SnapshotFull
SnapshotCopyOnlyFull

SQLDataDirectory

Object

SQLDataDirectory 信息

名称	类型	说明
logicalName	string	文件的逻辑名称
path	string	文件路径
type	SQLDataDirectoryType	数据目录映射的类型

SQLDataDirectoryType

枚举

数据目录映射的类型

值	说明
Invalid
Data
Log

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

通过

Recovery Points - Get

URI 参数

响应

安全性

azure_auth

作用域

示例

Get Azure Vm Recovery Point Details

示例请求

示例响应

定义

AzureFileShareRecoveryPoint

AzureWorkloadPointInTimeRecoveryPoint

AzureWorkloadRecoveryPoint

AzureWorkloadSAPAsePointInTimeRecoveryPoint

AzureWorkloadSAPAseRecoveryPoint

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

AzureWorkloadSAPHanaRecoveryPoint

AzureWorkloadSQLPointInTimeRecoveryPoint

AzureWorkloadSQLRecoveryPoint

AzureWorkloadSQLRecoveryPointExtendedInfo

BEKDetails

createdByType

DiskInformation

ErrorDetail

ErrorResponse

ExtendedLocation

GenericRecoveryPoint

IaasVMRecoveryPoint

KEKDetails

KeyAndSecretDetails

PointInTimeRange

RecoveryPointDiskConfiguration

RecoveryPointMoveReadinessInfo

RecoveryPointProperties

RecoveryPointResource

RecoveryPointTierInformation

RecoveryPointTierInformationV2

RecoveryPointTierStatus

RecoveryPointTierType

RestorePointType

SQLDataDirectory

SQLDataDirectoryType

systemData