Recovery Points - Get
Предоставляет сведения о резервных копиях данных, определенных с помощью RecoveryPointID. Это асинхронная операция. Чтобы узнать состояние операции, вызовите API GetProtectedItemOperationResult.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}?api-version=2026-01-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
container
|
path | True |
string |
Имя контейнера, данные которого необходимо получить. |
|
fabric
|
path | True |
string |
Имя ресурса BackupFabricResource |
|
protected
|
path | True |
string |
Резервное имя элемента, данные которого должны быть получены. |
|
recovery
|
path | True |
string |
RecoveryPointID представляет резервную копию данных, которые необходимо получить. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя регистронезависимо. |
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
vault
|
path | True |
string |
Имя ресурса VaultResource |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Azure Active Directory OAuth2 Flow.
Тип:
oauth2
Flow:
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=2026-01-01
Пример ответа
{
"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"
]
}
}
Определения
| Имя | Описание |
|---|---|
|
Azure |
Azure File Share, специфичная для рабочей нагрузки, резервная копия. |
|
Azure |
Точка восстановления, конкретная для PointInTime |
|
Azure |
Конкретная точка восстановления рабочей нагрузки, в частности инкапсулирует точку восстановления full/diff |
|
Azure |
Точка восстановления, относясь к PointInTime в SAPAse |
|
Azure |
Конкретная точка восстановления SAPAse, в частности инкапсулирует точки восстановления full/diff |
|
Azure |
Точка восстановления, относясь к PointInTime в SAPHana |
|
Azure |
Конкретная точка восстановления SAPHana, в частности инкапсулирует точки восстановления full/diff |
|
Azure |
Точка восстановления, конкретная для PointInTime |
|
Azure |
Конкретная точка восстановления SQL, в частности инкапсулирует точку восстановления full/diff вместе с расширенными сведениями |
|
Azure |
Подробные сведения о классе расширенных сведений |
| BEKDetails |
BEK — это ключ шифрования bitlocker. |
|
created |
Тип удостоверения, создавшего ресурс. |
|
Disk |
Сведения о диске |
|
Error |
Класс Error Detail, который инкапсулирует код, сообщение и рекомендации. |
|
Error |
Ответ на ошибку |
|
Extended |
Расширенное расположение точки восстановления, в которой была представлена виртуальная машина. |
|
Generic |
Универсальная копия резервных копий. |
|
Iaas |
Рабочая нагрузка виртуальной машины IaaS, определенная копия резервного копирования. |
| KEKDetails |
KEK — это ключ шифрования для BEK. |
|
Key |
BEK — это ключ bitlocker. KEK — это ключ шифрования для BEK, если виртуальная машина была зашифрована, мы будем хранить следующие сведения:
|
|
Point |
Сведения о диапазонах журналов |
|
Recovery |
Конфигурация дисков |
|
Recovery |
|
|
Recovery |
Свойства точки восстановления |
|
Recovery |
Базовый класс для копирования резервных копий. Резервные копии, относящиеся к рабочей нагрузке, являются производными от этого класса. |
|
Recovery |
Сведения о уровне точки восстановления. |
|
Recovery |
Сведения о уровне восстановления версии 2 |
|
Recovery |
Состояние уровня точки восстановления. |
|
Recovery |
Тип уровня точки восстановления. |
|
Restore |
Тип точки восстановления |
|
SQLData |
Сведения о SQLDataDirectory |
|
SQLData |
Тип сопоставления каталога данных |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
AzureFileShareRecoveryPoint
Azure File Share, специфичная для рабочей нагрузки, резервная копия.
| Имя | Тип | Описание |
|---|---|---|
| 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
Конкретная точка восстановления рабочей нагрузки, в частности инкапсулирует точку восстановления full/diff
| Имя | Тип | Описание |
|---|---|---|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTimeInUTC |
string (date-time) |
Время UTC, в течение которого была создана точка восстановления |
| type |
Тип точки восстановления |
AzureWorkloadSAPAsePointInTimeRecoveryPoint
Точка восстановления, относясь к PointInTime в SAPAse
| Имя | Тип | Описание |
|---|---|---|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTimeInUTC |
string (date-time) |
Время UTC, в течение которого была создана точка восстановления |
| timeRanges |
Список диапазонов журналов |
|
| type |
Тип точки восстановления |
AzureWorkloadSAPAseRecoveryPoint
Конкретная точка восстановления SAPAse, в частности инкапсулирует точки восстановления full/diff
| Имя | Тип | Описание |
|---|---|---|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTimeInUTC |
string (date-time) |
Время UTC, в течение которого была создана точка восстановления |
| type |
Тип точки восстановления |
AzureWorkloadSAPHanaPointInTimeRecoveryPoint
Точка восстановления, относясь к PointInTime в SAPHana
| Имя | Тип | Описание |
|---|---|---|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTimeInUTC |
string (date-time) |
Время UTC, в течение которого была создана точка восстановления |
| timeRanges |
Список диапазонов журналов |
|
| type |
Тип точки восстановления |
AzureWorkloadSAPHanaRecoveryPoint
Конкретная точка восстановления SAPHana, в частности инкапсулирует точки восстановления full/diff
| Имя | Тип | Описание |
|---|---|---|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTimeInUTC |
string (date-time) |
Время UTC, в течение которого была создана точка восстановления |
| type |
Тип точки восстановления |
AzureWorkloadSQLPointInTimeRecoveryPoint
Точка восстановления, конкретная для PointInTime
| Имя | Тип | Описание |
|---|---|---|
| extendedInfo |
Расширенные сведения, предоставляющие сведения о каталоге данных. Будет заполнено в двух случаях: когда доступ к определенной точке восстановления осуществляется с помощью GetRecoveryPoint Или при вызове ListRecoveryPoints для log RP только с фильтром запросов ExtendedInfo |
|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTimeInUTC |
string (date-time) |
Время UTC, в течение которого была создана точка восстановления |
| timeRanges |
Список диапазонов журналов |
|
| type |
Тип точки восстановления |
AzureWorkloadSQLRecoveryPoint
Конкретная точка восстановления SQL, в частности инкапсулирует точку восстановления full/diff вместе с расширенными сведениями
| Имя | Тип | Описание |
|---|---|---|
| extendedInfo |
Расширенные сведения, предоставляющие сведения о каталоге данных. Будет заполнено в двух случаях: когда доступ к определенной точке восстановления осуществляется с помощью GetRecoveryPoint Или при вызове ListRecoveryPoints для log RP только с фильтром запросов ExtendedInfo |
|
| 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 |
ID Key Vault, где хранится этот Секрет. |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DiskInformation
Сведения о диске
| Имя | Тип | Описание |
|---|---|---|
| lun |
integer (int32) |
|
| name |
string |
ErrorDetail
Класс Error Detail, который инкапсулирует код, сообщение и рекомендации.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| message |
string |
Сообщение об ошибке, связанное с кодом. |
| recommendations |
string[] |
Список строк рекомендаций. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
ExtendedLocation
Расширенное расположение точки восстановления, в которой была представлена виртуальная машина.
| Имя | Тип | Описание |
|---|---|---|
| name |
string |
Имя расширенного расположения. |
| type |
string |
Тип расширенного расположения. Возможные значения: EdgeZone |
GenericRecoveryPoint
Универсальная копия резервных копий.
| Имя | Тип | Описание |
|---|---|---|
| friendlyName |
string |
Понятное имя копии резервной копии. |
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| recoveryPointAdditionalInfo |
string |
Дополнительные сведения, связанные с этой копией резервного копирования. |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTime |
string (date-time) |
Время создания этой копии резервного копирования. |
| recoveryPointType |
string |
Тип копии резервной копии. |
IaasVMRecoveryPoint
Рабочая нагрузка виртуальной машины IaaS, определенная копия резервного копирования.
| Имя | Тип | Описание |
|---|---|---|
| extendedLocation |
Расширенное расположение точки восстановления виртуальной машины должно иметь значение NULL, если виртуальная машина находится в общедоступном облаке. |
|
| isInstantIlrSessionActive |
boolean |
Сеанс для восстановления элементов из этой копии резервной копии по-прежнему активен. |
| isManagedVirtualMachine |
boolean |
Является ли VM с Управляемые диски |
| isPrivateAccessEnabledOnAnyDisk |
boolean |
Этот флаг обозначает, если любой из дисков в виртуальной машине использует параметр сети приватного доступа. |
| isSourceVMEncrypted |
boolean |
Определяет, зашифрована ли виртуальная машина при создании резервной копии. |
| keyAndSecret |
Необходимые сведения для восстановления зашифрованной виртуальной машины. Применимо только в том случае, если isSourceVMEncrypted имеет значение true. |
|
| objectType | string: |
Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов. |
| originalStorageAccountOption |
boolean |
Исходный параметр учетной записи хранения |
| osType |
string |
Тип ОС |
| recoveryPointAdditionalInfo |
string |
Дополнительные сведения, связанные с этой копией резервного копирования. |
| recoveryPointDiskConfiguration |
Конфигурация дисков |
|
| recoveryPointMoveReadinessInfo |
<string,
Recovery |
Право на перемещение RP на другой уровень |
| recoveryPointProperties |
Свойства точки восстановления |
|
| recoveryPointTierDetails |
Сведения о уровне точки восстановления. |
|
| recoveryPointTime |
string (date-time) |
Время создания этой копии резервного копирования. |
| recoveryPointType |
string |
Тип копии резервной копии. |
| securityType |
string |
Тип безопасности диска |
| sourceVMStorageType |
string |
Тип хранилища виртуальной машины, резервная копия которой создается. |
| virtualMachineSize |
string |
Размер виртуальной машины |
| zones |
string[] |
Определяет зону виртуальной машины во время резервного копирования. Применимо только для закрепленных между зонами виртуальных машин |
KEKDetails
KEK — это ключ шифрования для BEK.
| Имя | Тип | Описание |
|---|---|---|
| keyBackupData |
string |
Данные KEK. |
| keyUrl |
string |
Ключ — KEK. |
| keyVaultId |
string |
Key Vault ID, где хранится этот Ключ. |
KeyAndSecretDetails
BEK — это ключ bitlocker. KEK — это ключ шифрования для BEK, если виртуальная машина была зашифрована, мы будем хранить следующие сведения:
- Secret(BEK) — URL+Backup Data + vaultId.
- Key(KEK) — URL+Backup Data + vaultId.
- Шифрование BeK и KEK могут иметь разные идентификаторы хранилища.
| Имя | Тип | Описание |
|---|---|---|
| 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) |
Количество дисков, подключенных к виртуальной машине |
| numberOfDisksIncludedInBackup |
integer (int32) |
Количество дисков, включенных в резервное копирование |
RecoveryPointMoveReadinessInfo
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
string |
|
| isReadyForMove |
boolean |
RecoveryPointProperties
Свойства точки восстановления
| Имя | Тип | Описание |
|---|---|---|
| expiryTime |
string |
Время истечения срока действия точки восстановления в формате UTC. |
| isSoftDeleted |
boolean |
Bool, чтобы указать, находится ли RP в состоянии обратимого удаления или нет |
| ruleName |
string |
Имя правила, помеченное на точке восстановления, которая управляет жизненным циклом |
RecoveryPointResource
Базовый класс для копирования резервных копий. Резервные копии, относящиеся к рабочей нагрузке, являются производными от этого класса.
| Имя | Тип | Описание |
|---|---|---|
| eTag |
string |
Необязательный ETag. |
| id |
string |
Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Географическое расположение, в котором находится ресурс |
| name |
string |
Имя ресурса |
| properties |
RecoveryPoint:
|
Свойства RecoveryPointResource |
| systemData |
Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy. |
|
| tags |
object |
Теги ресурсов. |
| type |
string |
Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения» |
RecoveryPointTierInformation
Сведения о уровне точки восстановления.
| Имя | Тип | Описание |
|---|---|---|
| extendedInfo |
object |
Состояние уровня точки восстановления. |
| status |
Состояние уровня точки восстановления. |
|
| type |
Тип уровня точки восстановления. |
RecoveryPointTierInformationV2
Сведения о уровне восстановления версии 2
| Имя | Тип | Описание |
|---|---|---|
| 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 |
Тип удостоверения, который последний раз изменил ресурс. |