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

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

名称 必需 类型 说明
containerName
path True

string

与备份项关联的容器名称。

fabricName
path True

string

与备份项关联的结构名称。

protectedItemName
path True

string

备份了需要提取其备份数据的项名称。

recoveryPointId
path True

string

RecoveryPointID 表示要提取的备份数据。

resourceGroupName
path True

string

恢复服务保管库所在的资源组的名称。

subscriptionId
path True

string

订阅 ID。

vaultName
path True

string

恢复服务保管库的名称。

api-version
query True

string

客户端 API 版本。

响应

名称 类型 说明
200 OK

RecoveryPointResource

好的

Other Status Codes

CloudError

描述操作失败的原因的错误响应。

安全性

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 文件共享工作负荷的备份副本。

AzureWorkloadPointInTimeRecoveryPoint

特定于 PointInTime 的恢复点

AzureWorkloadRecoveryPoint

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

AzureWorkloadSAPAsePointInTimeRecoveryPoint

特定于 SAPAse 中 PointInTime 的恢复点

AzureWorkloadSAPAseRecoveryPoint

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

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

特定于 SAPHana 中 PointInTime 的恢复点

AzureWorkloadSAPHanaRecoveryPoint

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

AzureWorkloadSQLPointInTimeRecoveryPoint

特定于 PointInTime 的恢复点

AzureWorkloadSQLRecoveryPoint

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

AzureWorkloadSQLRecoveryPointExtendedInfo

扩展信息类详细信息

BEKDetails

BEK 是 bitlocker 加密密钥。

CloudError

容器实例服务的错误响应。

CloudErrorBody

容器实例服务的错误响应。

DiskInformation

磁盘信息

ErrorAdditionalInfo

资源管理错误附加信息。

ExtendedLocation

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

GenericRecoveryPoint

通用备份副本。

IaasVMRecoveryPoint

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

KEKDetails

KEK 是 BEK 的加密密钥。

KeyAndSecretDetails

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

  1. Secret(BEK) - URL + 备份数据 + vaultId。
  2. Key(KEK) - URL + 备份数据 + vaultId。
  3. EncryptionMechanism BEK 和 KEK 可能具有不同的保管库 ID。
PointInTimeRange

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

RecoveryPointDiskConfiguration

磁盘配置

RecoveryPointMoveReadinessInfo
RecoveryPointProperties

恢复点的属性

RecoveryPointResource

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

RecoveryPointTierInformation

恢复点层信息。

RecoveryPointTierInformationV2

RecoveryPoint 层信息 V2

RecoveryPointTierStatus

恢复点层状态。

RecoveryPointTierType

恢复点层类型。

RestorePointType

还原点的类型

SQLDataDirectory

SQLDataDirectory 信息

SQLDataDirectoryType

数据目录映射的类型

AzureFileShareRecoveryPoint

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

名称 类型 说明
fileShareSnapshotUri

string

包含文件共享快照的 URL(如果适用)

objectType string:

AzureFileShareRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointSizeInGB

integer (int32)

包含恢复点大小

recoveryPointTierDetails

RecoveryPointTierInformation[]

恢复点层信息。

recoveryPointTime

string (date-time)

创建此备份副本的时间。

recoveryPointType

string

备份副本的类型。 指定它是崩溃一致的备份还是应用一致。

AzureWorkloadPointInTimeRecoveryPoint

特定于 PointInTime 的恢复点

名称 类型 说明
objectType string:

AzureWorkloadPointInTimeRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

要移动到另一层的 RP 资格

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

恢复点层信息。

recoveryPointTimeInUTC

string (date-time)

创建恢复点的 UTC 时间

timeRanges

PointInTimeRange[]

日志范围列表

type

RestorePointType

还原点的类型

AzureWorkloadRecoveryPoint

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

名称 类型 说明
objectType string:

AzureWorkloadRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

要移动到另一层的 RP 资格

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

恢复点层信息。

recoveryPointTimeInUTC

string (date-time)

创建恢复点的 UTC 时间

type

RestorePointType

还原点的类型

AzureWorkloadSAPAsePointInTimeRecoveryPoint

特定于 SAPAse 中 PointInTime 的恢复点

名称 类型 说明
objectType string:

AzureWorkloadSAPAsePointInTimeRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

要移动到另一层的 RP 资格

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

恢复点层信息。

recoveryPointTimeInUTC

string (date-time)

创建恢复点的 UTC 时间

timeRanges

PointInTimeRange[]

日志范围列表

type

RestorePointType

还原点的类型

AzureWorkloadSAPAseRecoveryPoint

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

名称 类型 说明
objectType string:

AzureWorkloadSAPAseRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

要移动到另一层的 RP 资格

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

恢复点层信息。

recoveryPointTimeInUTC

string (date-time)

创建恢复点的 UTC 时间

type

RestorePointType

还原点的类型

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

特定于 SAPHana 中 PointInTime 的恢复点

名称 类型 说明
objectType string:

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

要移动到另一层的 RP 资格

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

恢复点层信息。

recoveryPointTimeInUTC

string (date-time)

创建恢复点的 UTC 时间

timeRanges

PointInTimeRange[]

日志范围列表

type

RestorePointType

还原点的类型

AzureWorkloadSAPHanaRecoveryPoint

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

名称 类型 说明
objectType string:

AzureWorkloadSAPHanaRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

要移动到另一层的 RP 资格

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTierDetails

RecoveryPointTierInformationV2[]

恢复点层信息。

recoveryPointTimeInUTC

string (date-time)

创建恢复点的 UTC 时间

type

RestorePointType

还原点的类型

AzureWorkloadSQLPointInTimeRecoveryPoint

特定于 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

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

扩展信息类详细信息

名称 类型 说明
dataDirectoryPaths

SQLDataDirectory[]

还原操作期间的数据目录路径列表。

dataDirectoryTimeInUTC

string (date-time)

捕获数据目录信息的 UTC 时间

BEKDetails

BEK 是 bitlocker 加密密钥。

名称 类型 说明
secretData

string

BEK 数据。

secretUrl

string

机密为 BEK。

secretVaultId

string

存储此机密的 Key Vault 的 ID。

CloudError

容器实例服务的错误响应。

名称 类型 说明
error

CloudErrorBody

错误对象。

CloudErrorBody

容器实例服务的错误响应。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

CloudErrorBody[]

有关错误的其他详细信息的列表。

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:

GenericRecoveryPoint

此属性将用作用于确定类型多态链中特定类型的鉴别器。

recoveryPointAdditionalInfo

string

与此备份副本关联的其他信息。

recoveryPointProperties

RecoveryPointProperties

恢复点的属性

recoveryPointTime

string (date-time)

创建此备份副本的时间。

recoveryPointType

string

备份副本的类型。

IaasVMRecoveryPoint

特定于 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

KEK 是 BEK 的加密密钥。

名称 类型 说明
keyBackupData

string

KEK 数据。

keyUrl

string

关键是 KEK。

keyVaultId

string

存储此密钥的 Key Vault ID。

KeyAndSecretDetails

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

  1. Secret(BEK) - URL + 备份数据 + vaultId。
  2. Key(KEK) - URL + 备份数据 + vaultId。
  3. EncryptionMechanism BEK 和 KEK 可能具有不同的保管库 ID。
名称 类型 说明
bekDetails

BEKDetails

BEK 是 bitlocker 加密密钥。

encryptionMechanism

string

加密机制:None/SinglePass/DoublePass

kekDetails

KEKDetails

KEK 是 BEK 的加密密钥。

PointInTimeRange

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

名称 类型 说明
endTime

string (date-time)

日志恢复的时间范围的结束时间。

startTime

string (date-time)

日志恢复的时间范围的开始时间。

RecoveryPointDiskConfiguration

磁盘配置

名称 类型 说明
excludedDiskList

DiskInformation[]

从备份中排除的磁盘的信息

includedDiskList

DiskInformation[]

备份中包含的磁盘信息

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

RecoveryPointTierStatus

恢复点层状态。

type

RecoveryPointTierType

恢复点层类型。

RecoveryPointTierInformationV2

RecoveryPoint 层信息 V2

名称 类型 说明
extendedInfo

object

恢复点层状态。

status

RecoveryPointTierStatus

恢复点层状态。

type

RecoveryPointTierType

恢复点层类型。

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

数据目录映射的类型

SQLDataDirectoryType

数据目录映射的类型

说明
Data
Invalid
Log