Поделиться через

Recovery Points - Get

  • Ссылка
Служба:
Recovery Services - Backup
Версия API:
2024-10-01

Предоставляет сведения о резервных копиях данных, определенных с помощью 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=2024-10-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

Идентификатор подписки.
vaultName
 path True

string

Имя хранилища служб восстановления.
api-version
 query True

string

Версия клиентского API.

Ответы

Имя Тип Описание
200 OK

RecoveryPointResource

ХОРОШО
Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: 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=2024-10-01

Пример ответа

Код состояния:
200 
{
  "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

Конкретная точка восстановления рабочей нагрузки, в частности инкапсулирует точку восстановления full/diff
AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Точка восстановления, относясь к PointInTime в SAPHana
AzureWorkloadSAPHanaRecoveryPoint

Конкретная точка восстановления SAPHana, в частности инкапсулирует точки восстановления full/diff
AzureWorkloadSQLPointInTimeRecoveryPoint

Точка восстановления, конкретная для PointInTime
AzureWorkloadSQLRecoveryPoint

Конкретная точка восстановления SQL, в частности инкапсулирует точку восстановления full/diff вместе с расширенными сведениями
AzureWorkloadSQLRecoveryPointExtendedInfo

Подробные сведения о классе расширенных сведений
BEKDetails

BEK — это ключ шифрования bitlocker.
CloudError

Ответ об ошибке службы экземпляра контейнера.
CloudErrorBody

Ответ об ошибке службы экземпляра контейнера.
DiskInformation

Сведения о диске
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ExtendedLocation

Расширенное расположение точки восстановления, в которой была представлена виртуальная машина.
GenericRecoveryPoint

Универсальная копия резервных копий.
IaasVMRecoveryPoint

Рабочая нагрузка виртуальной машины IaaS, определенная копия резервного копирования.
KEKDetails

KEK — это ключ шифрования для BEK.
KeyAndSecretDetails

BEK — это ключ bitlocker. KEK — это ключ шифрования для BEK, если виртуальная машина была зашифрована, мы будем хранить следующие сведения:

  1. Secret(BEK) — URL+Backup Data + vaultId.
  2. Key(KEK) — URL+Backup Data + vaultId.
  3. Шифрование BeK и KEK могут иметь разные идентификаторы хранилища.
PointInTimeRange

Сведения о диапазонах журналов
RecoveryPointDiskConfiguration

Конфигурация диска
RecoveryPointMoveReadinessInfo
RecoveryPointProperties

Свойства точки восстановления
RecoveryPointResource

Базовый класс для копирования резервных копий. Резервные копии, относящиеся к рабочей нагрузке, являются производными от этого класса.
RecoveryPointTierInformationV2

Сведения о уровне восстановления версии 2
RecoveryPointTierStatus

Состояние уровня точки восстановления.
RecoveryPointTierType

Тип уровня точки восстановления.
RestorePointType

Тип точки восстановления
SQLDataDirectory

Сведения о SQLDataDirectory
SQLDataDirectoryType

Тип сопоставления каталога данных

AzureFileShareRecoveryPoint

Конкретная копия резервной копии рабочей нагрузки общей папки Azure.

Имя Тип Описание
fileShareSnapshotUri

string

Содержит URL-адрес моментального снимка общей папки, если применимо
objectType string:

AzureFileShareRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointSizeInGB

integer

Содержит размер точки восстановления
recoveryPointTime

string

Время создания этой копии резервного копирования.
recoveryPointType

string

Тип копии резервной копии. Указывает, является ли он согласованным резервным копированием или приложением.

AzureWorkloadPointInTimeRecoveryPoint

Точка восстановления, конкретная для PointInTime

Имя Тип Описание
objectType string:

AzureWorkloadPointInTimeRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTimeInUTC

string

Время UTC, в течение которого была создана точка восстановления
timeRanges

PointInTimeRange[]

Список диапазонов журналов
type

RestorePointType

Тип точки восстановления

AzureWorkloadRecoveryPoint

Конкретная точка восстановления рабочей нагрузки, в частности инкапсулирует точку восстановления full/diff

Имя Тип Описание
objectType string:

AzureWorkloadRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTimeInUTC

string

Время UTC, в течение которого была создана точка восстановления
type

RestorePointType

Тип точки восстановления

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Точка восстановления, относясь к PointInTime в SAPHana

Имя Тип Описание
objectType string:

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTimeInUTC

string

Время UTC, в течение которого была создана точка восстановления
timeRanges

PointInTimeRange[]

Список диапазонов журналов
type

RestorePointType

Тип точки восстановления

AzureWorkloadSAPHanaRecoveryPoint

Конкретная точка восстановления SAPHana, в частности инкапсулирует точки восстановления full/diff

Имя Тип Описание
objectType string:

AzureWorkloadSAPHanaRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTimeInUTC

string

Время UTC, в течение которого была создана точка восстановления
type

RestorePointType

Тип точки восстановления

AzureWorkloadSQLPointInTimeRecoveryPoint

Точка восстановления, конкретная для PointInTime

Имя Тип Описание
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Расширенные сведения, предоставляющие сведения о каталоге данных. Будет заполнено в двух случаях: когда доступ к определенной точке восстановления осуществляется с помощью GetRecoveryPoint Или при вызове ListRecoveryPoints для log RP только с фильтром запросов ExtendedInfo
objectType string:

AzureWorkloadSQLPointInTimeRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTimeInUTC

string

Время UTC, в течение которого была создана точка восстановления
timeRanges

PointInTimeRange[]

Список диапазонов журналов
type

RestorePointType

Тип точки восстановления

AzureWorkloadSQLRecoveryPoint

Конкретная точка восстановления SQL, в частности инкапсулирует точку восстановления full/diff вместе с расширенными сведениями

Имя Тип Описание
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Расширенные сведения, предоставляющие сведения о каталоге данных. Будет заполнено в двух случаях: когда доступ к определенной точке восстановления осуществляется с помощью GetRecoveryPoint Или при вызове ListRecoveryPoints для log RP только с фильтром запросов ExtendedInfo
objectType string:

AzureWorkloadSQLRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTimeInUTC

string

Время UTC, в течение которого была создана точка восстановления
type

RestorePointType

Тип точки восстановления

AzureWorkloadSQLRecoveryPointExtendedInfo

Подробные сведения о классе расширенных сведений

Имя Тип Описание
dataDirectoryPaths

SQLDataDirectory[]

Список путей к каталогу данных во время операции восстановления.
dataDirectoryTimeInUTC

string

Время в формате UTC, в котором были записаны сведения о каталоге данных

BEKDetails

BEK — это ключ шифрования bitlocker.

Имя Тип Описание
secretData

string

Данные BEK.
secretUrl

string

Секрет — BEK.
secretVaultId

string

Идентификатор Хранилища ключей, в котором хранится этот секрет.

CloudError

Ответ об ошибке службы экземпляра контейнера.

Имя Тип Описание
error

CloudErrorBody

Объект ошибки.

CloudErrorBody

Ответ об ошибке службы экземпляра контейнера.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details

CloudErrorBody[]

Список дополнительных сведений об ошибке.
message

string

Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target

string

Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

DiskInformation

Сведения о диске

Имя Тип Описание
lun

integer

name

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Дополнительный тип сведений.

ExtendedLocation

Расширенное расположение точки восстановления, в которой была представлена виртуальная машина.

Имя Тип Описание
name

string

Имя расширенного расположения.
type

string

Тип расширенного расположения. Возможные значения: EdgeZone

GenericRecoveryPoint

Универсальная копия резервных копий.

Имя Тип Описание
friendlyName

string

Понятное имя копии резервной копии.
objectType string:

GenericRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointAdditionalInfo

string

Дополнительные сведения, связанные с этой копией резервного копирования.
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTime

string

Время создания этой копии резервного копирования.
recoveryPointType

string

Тип копии резервной копии.

IaasVMRecoveryPoint

Рабочая нагрузка виртуальной машины IaaS, определенная копия резервного копирования.

Имя Тип Описание
extendedLocation

ExtendedLocation

Расширенное расположение точки восстановления виртуальной машины должно иметь значение NULL, если виртуальная машина находится в общедоступном облаке.
isInstantIlrSessionActive

boolean

Сеанс для восстановления элементов из этой копии резервной копии по-прежнему активен.
isManagedVirtualMachine

boolean

Наличие виртуальной машины с управляемыми дисками
isPrivateAccessEnabledOnAnyDisk

boolean

Этот флаг обозначает, если любой из дисков в виртуальной машине использует параметр сети приватного доступа.
isSourceVMEncrypted

boolean

Определяет, зашифрована ли виртуальная машина при создании резервной копии.
keyAndSecret

KeyAndSecretDetails

Необходимые сведения для восстановления зашифрованной виртуальной машины. Применимо только в том случае, если isSourceVMEncrypted имеет значение true.
objectType string:

IaasVMRecoveryPoint

Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
originalStorageAccountOption

boolean

Исходный параметр учетной записи хранения
osType

string

Тип ОС
recoveryPointAdditionalInfo

string

Дополнительные сведения, связанные с этой копией резервного копирования.
recoveryPointDiskConfiguration

RecoveryPointDiskConfiguration

Конфигурация диска
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Право на перемещение RP на другой уровень
recoveryPointProperties

RecoveryPointProperties

Свойства точки восстановления
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Сведения о уровне точки восстановления.
recoveryPointTime

string

Время создания этой копии резервного копирования.
recoveryPointType

string

Тип копии резервной копии.
securityType

string

Тип безопасности диска
sourceVMStorageType

string

Тип хранилища виртуальной машины, резервная копия которой создается.
virtualMachineSize

string

Размер виртуальной машины
zones

string[]

Определяет зону виртуальной машины во время резервного копирования. Применимо только для закрепленных между зонами виртуальных машин

KEKDetails

KEK — это ключ шифрования для BEK.

Имя Тип Описание
keyBackupData

string

Данные KEK.
keyUrl

string

Ключ — KEK.
keyVaultId

string

Идентификатор Key Vault, в котором хранится этот ключ.

KeyAndSecretDetails

BEK — это ключ bitlocker. KEK — это ключ шифрования для BEK, если виртуальная машина была зашифрована, мы будем хранить следующие сведения:

  1. Secret(BEK) — URL+Backup Data + vaultId.
  2. Key(KEK) — URL+Backup Data + vaultId.
  3. Шифрование BeK и KEK могут иметь разные идентификаторы хранилища.
Имя Тип Описание
bekDetails

BEKDetails

BEK — это ключ шифрования bitlocker.
encryptionMechanism

string

Механизм шифрования: None/ SinglePass/ DoublePass
kekDetails

KEKDetails

KEK — это ключ шифрования для BEK.

PointInTimeRange

Сведения о диапазонах журналов

Имя Тип Описание
endTime

string

Время окончания диапазона времени для восстановления журнала.
startTime

string

Время начала диапазона времени для восстановления журнала.

RecoveryPointDiskConfiguration

Конфигурация диска

Имя Тип Описание
excludedDiskList

DiskInformation[]

Сведения о дисках, исключенных из резервной копии
includedDiskList

DiskInformation[]

Сведения о дисках, включенных в резервное копирование
numberOfDisksAttachedToVm

integer

Количество дисков, подключенных к виртуальной машине
numberOfDisksIncludedInBackup

integer

Количество дисков, включенных в резервное копирование

RecoveryPointMoveReadinessInfo

Имя Тип Описание
additionalInfo

string

isReadyForMove

boolean

RecoveryPointProperties

Свойства точки восстановления

Имя Тип Описание
expiryTime

string

Время истечения срока действия точки восстановления в формате UTC.
isSoftDeleted

boolean

Bool, чтобы указать, находится ли RP в состоянии обратимого удаления или нет
ruleName

string

Имя правила, помеченное на точке восстановления, которая управляет жизненным циклом

RecoveryPointResource

Базовый класс для копирования резервных копий. Резервные копии, относящиеся к рабочей нагрузке, являются производными от этого класса.

Имя Тип Описание
eTag

string

Необязательный ETag.
id

string

Идентификатор ресурса представляет полный путь к ресурсу.
location

string

Расположение ресурса.
name

string

Имя ресурса, связанное с ресурсом.
properties RecoveryPoint:

Свойства RecoveryPointResource
tags

object

Теги ресурсов.
type

string

Тип ресурса представляет полный путь к пространству имен формы/ResourceType/ResourceType/...

RecoveryPointTierInformationV2

Сведения о уровне восстановления версии 2

Имя Тип Описание
extendedInfo

object

Состояние уровня точки восстановления.
status

RecoveryPointTierStatus

Состояние уровня точки восстановления.
type

RecoveryPointTierType

Тип уровня точки восстановления.

RecoveryPointTierStatus

Состояние уровня точки восстановления.

Имя Тип Описание
Deleted

string

Disabled

string

Invalid

string

Rehydrated

string

Valid

string

RecoveryPointTierType

Тип уровня точки восстановления.

Имя Тип Описание
ArchivedRP

string

HardenedRP

string

InstantRP

string

Invalid

string

RestorePointType

Тип точки восстановления

Имя Тип Описание
Differential

string

Full

string

Incremental

string

Invalid

string

Log

string

SnapshotCopyOnlyFull

string

SnapshotFull

string

SQLDataDirectory

Сведения о SQLDataDirectory

Имя Тип Описание
logicalName

string

Логическое имя файла
path

string

Путь к файлу
type

SQLDataDirectoryType

Тип сопоставления каталога данных

SQLDataDirectoryType

Тип сопоставления каталога данных

Имя Тип Описание
Data

string

Invalid

string

Log

string