Compartir a través de

Recovery Points - Get

  • Referencia
Servicio:
Recovery Services - Backup
Versión de la API:
2024-10-01

Proporciona la información de los datos de copia de seguridad identificados mediante RecoveryPointID. Se trata de una operación asincrónica. Para conocer el estado de la operación, llame a la 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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
containerName
 path True

string

Nombre del contenedor asociado al elemento de copia de seguridad.
fabricName
 path True

string

Nombre del tejido asociado al elemento de copia de seguridad.
protectedItemName
 path True

string

Se ha copiado una copia de seguridad del nombre del elemento cuyos datos de copia de seguridad deben capturarse.
recoveryPointId
 path True

string

RecoveryPointID representa los datos de copia de seguridad que se van a capturar.
resourceGroupName
 path True

string

Nombre del grupo de recursos donde está presente el almacén de Recovery Services.
subscriptionId
 path True

string

Identificador de suscripción.
vaultName
 path True

string

Nombre del almacén de Recovery Services.
api-version
 query True

string

Versión de api de cliente.

Respuestas

Nombre Tipo Description
200 OK

RecoveryPointResource

De acuerdo
Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario.

Ejemplos

Get Azure Vm Recovery Point Details

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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
  }
}

Definiciones

Nombre Description
AzureFileShareRecoveryPoint

Copia de seguridad específica de la carga de trabajo del recurso compartido de archivos de Azure.
AzureWorkloadPointInTimeRecoveryPoint

Punto de recuperación específico de PointInTime
AzureWorkloadRecoveryPoint

Punto de recuperación específico de la carga de trabajo, encapsula específicamente el punto de recuperación completo o diff.
AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Punto de recuperación específico de PointInTime en SAPHana
AzureWorkloadSAPHanaRecoveryPoint

Punto de recuperación específico de SAPHana, encapsula específicamente puntos de recuperación completos o diff
AzureWorkloadSQLPointInTimeRecoveryPoint

Punto de recuperación específico de PointInTime
AzureWorkloadSQLRecoveryPoint

Punto de recuperación específico de SQL, encapsula específicamente el punto de recuperación completo o diff junto con la información extendida
AzureWorkloadSQLRecoveryPointExtendedInfo

Detalles de la clase de información extendida
BEKDetails

BEK es la clave de cifrado de BitLocker.
CloudError

Respuesta de error del servicio Container Instance.
CloudErrorBody

Respuesta de error del servicio Container Instance.
DiskInformation

Información del disco
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ExtendedLocation

Ubicación extendida del punto de recuperación donde estaba presente la máquina virtual.
GenericRecoveryPoint

Copia de seguridad genérica.
IaasVMRecoveryPoint

Copia de seguridad específica de la carga de trabajo de máquina virtual iaaS.
KEKDetails

KEK es la clave de cifrado para BEK.
KeyAndSecretDetails

BEK es la clave de BitLocker. KEK es la clave de cifrado para BEK Si la máquina virtual se cifró, almacenaremos los siguientes detalles:

  1. Secret(BEK): dirección URL + Datos de copia de seguridad + vaultId.
  2. Key(KEK): dirección URL + Datos de copia de seguridad + vaultId.
  3. EncryptionMechanism BEK y KEK pueden tener identificadores de almacén diferentes.
PointInTimeRange

Proporciona detalles para los intervalos de registro.
RecoveryPointDiskConfiguration

Configuración del disco
RecoveryPointMoveReadinessInfo
RecoveryPointProperties

Propiedades del punto de recuperación
RecoveryPointResource

Clase base para copias de seguridad. Las copias de seguridad específicas de la carga de trabajo se derivan de esta clase.
RecoveryPointTierInformationV2

Información de nivel de RecoveryPoint V2
RecoveryPointTierStatus

Estado del nivel de punto de recuperación.
RecoveryPointTierType

Tipo de nivel de punto de recuperación.
RestorePointType

Tipo de punto de restauración
SQLDataDirectory

Información de SQLDataDirectory
SQLDataDirectoryType

Tipo de asignación de directorios de datos

AzureFileShareRecoveryPoint

Copia de seguridad específica de la carga de trabajo del recurso compartido de archivos de Azure.

Nombre Tipo Description
fileShareSnapshotUri

string

Contiene la dirección URL a la instantánea del recurso compartido de archivos, si procede.
objectType string:

AzureFileShareRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointSizeInGB

integer

Contiene el tamaño del punto de recuperación.
recoveryPointTime

string

Hora en la que se creó esta copia de seguridad.
recoveryPointType

string

Tipo de copia de seguridad. Especifica si es una copia de seguridad coherente con bloqueos o una aplicación coherente.

AzureWorkloadPointInTimeRecoveryPoint

Punto de recuperación específico de PointInTime

Nombre Tipo Description
objectType string:

AzureWorkloadPointInTimeRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTimeInUTC

string

Hora UTC en la que se creó el punto de recuperación
timeRanges

PointInTimeRange[]

Lista de intervalos de registro
type

RestorePointType

Tipo de punto de restauración

AzureWorkloadRecoveryPoint

Punto de recuperación específico de la carga de trabajo, encapsula específicamente el punto de recuperación completo o diff.

Nombre Tipo Description
objectType string:

AzureWorkloadRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTimeInUTC

string

Hora UTC en la que se creó el punto de recuperación
type

RestorePointType

Tipo de punto de restauración

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Punto de recuperación específico de PointInTime en SAPHana

Nombre Tipo Description
objectType string:

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTimeInUTC

string

Hora UTC en la que se creó el punto de recuperación
timeRanges

PointInTimeRange[]

Lista de intervalos de registro
type

RestorePointType

Tipo de punto de restauración

AzureWorkloadSAPHanaRecoveryPoint

Punto de recuperación específico de SAPHana, encapsula específicamente puntos de recuperación completos o diff

Nombre Tipo Description
objectType string:

AzureWorkloadSAPHanaRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTimeInUTC

string

Hora UTC en la que se creó el punto de recuperación
type

RestorePointType

Tipo de punto de restauración

AzureWorkloadSQLPointInTimeRecoveryPoint

Punto de recuperación específico de PointInTime

Nombre Tipo Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Información extendida que proporciona detalles del directorio de datos. Se rellenará en dos casos: cuando se accede a un punto de recuperación específico mediante GetRecoveryPoint O cuando se llama a ListRecoveryPoints para el RP de registro solo con el filtro de consulta ExtendedInfo
objectType string:

AzureWorkloadSQLPointInTimeRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTimeInUTC

string

Hora UTC en la que se creó el punto de recuperación
timeRanges

PointInTimeRange[]

Lista de intervalos de registro
type

RestorePointType

Tipo de punto de restauración

AzureWorkloadSQLRecoveryPoint

Punto de recuperación específico de SQL, encapsula específicamente el punto de recuperación completo o diff junto con la información extendida

Nombre Tipo Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Información extendida que proporciona detalles del directorio de datos. Se rellenará en dos casos: cuando se accede a un punto de recuperación específico mediante GetRecoveryPoint O cuando se llama a ListRecoveryPoints para el RP de registro solo con el filtro de consulta ExtendedInfo
objectType string:

AzureWorkloadSQLRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTimeInUTC

string

Hora UTC en la que se creó el punto de recuperación
type

RestorePointType

Tipo de punto de restauración

AzureWorkloadSQLRecoveryPointExtendedInfo

Detalles de la clase de información extendida

Nombre Tipo Description
dataDirectoryPaths

SQLDataDirectory[]

Lista de rutas de acceso del directorio de datos durante la operación de restauración.
dataDirectoryTimeInUTC

string

Hora UTC en la que se capturó la información del directorio de datos

BEKDetails

BEK es la clave de cifrado de BitLocker.

Nombre Tipo Description
secretData

string

Datos BEK.
secretUrl

string

El secreto es BEK.
secretVaultId

string

Identificador del almacén de claves donde se almacena este secreto.

CloudError

Respuesta de error del servicio Container Instance.

Nombre Tipo Description
error

CloudErrorBody

Objeto de error.

CloudErrorBody

Respuesta de error del servicio Container Instance.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details

CloudErrorBody[]

Lista de detalles adicionales sobre el error.
message

string

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target

string

Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

DiskInformation

Información del disco

Nombre Tipo Description
lun

integer

name

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ExtendedLocation

Ubicación extendida del punto de recuperación donde estaba presente la máquina virtual.

Nombre Tipo Description
name

string

Nombre de la ubicación extendida.
type

string

Tipo de la ubicación extendida. Entre los valores posibles se incluyen: 'EdgeZone'

GenericRecoveryPoint

Copia de seguridad genérica.

Nombre Tipo Description
friendlyName

string

Nombre descriptivo de la copia de seguridad.
objectType string:

GenericRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
recoveryPointAdditionalInfo

string

Información adicional asociada a esta copia de seguridad.
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTime

string

Hora en la que se creó esta copia de seguridad.
recoveryPointType

string

Tipo de copia de seguridad.

IaasVMRecoveryPoint

Copia de seguridad específica de la carga de trabajo de máquina virtual iaaS.

Nombre Tipo Description
extendedLocation

ExtendedLocation

La ubicación extendida del punto de recuperación de la máquina virtual debe ser NULL si la máquina virtual está en la nube pública.
isInstantIlrSessionActive

boolean

Es la sesión para recuperar elementos de esta copia de seguridad aún activa.
isManagedVirtualMachine

boolean

Si la máquina virtual está con Managed Disks
isPrivateAccessEnabledOnAnyDisk

boolean

Esta marca indica si alguno de los discos de la máquina virtual usa la configuración de red de acceso privado.
isSourceVMEncrypted

boolean

Identifica si la máquina virtual se cifró cuando se crea la copia de seguridad.
keyAndSecret

KeyAndSecretDetails

Detalles necesarios para recuperar una máquina virtual cifrada. Solo es aplicable cuando IsSourceVMEncrypted es true.
objectType string:

IaasVMRecoveryPoint

Esta propiedad se usará como discriminador para decidir los tipos específicos en la cadena polimórfica de tipos.
originalStorageAccountOption

boolean

Opción de cuenta de almacenamiento original
osType

string

Tipo de sistema operativo
recoveryPointAdditionalInfo

string

Información adicional asociada a esta copia de seguridad.
recoveryPointDiskConfiguration

RecoveryPointDiskConfiguration

Configuración del disco
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Idoneidad del rp que se va a mover a otro nivel
recoveryPointProperties

RecoveryPointProperties

Propiedades del punto de recuperación
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Información del nivel de punto de recuperación.
recoveryPointTime

string

Hora en la que se creó esta copia de seguridad.
recoveryPointType

string

Tipo de copia de seguridad.
securityType

string

Tipo de seguridad del disco
sourceVMStorageType

string

Tipo de almacenamiento de la máquina virtual cuya copia de seguridad se crea.
virtualMachineSize

string

Tamaño de máquina virtual
zones

string[]

Identifica la zona de la máquina virtual en el momento de la copia de seguridad. Solo se aplica a máquinas virtuales ancladas por zona

KEKDetails

KEK es la clave de cifrado para BEK.

Nombre Tipo Description
keyBackupData

string

Datos KEK.
keyUrl

string

La clave es KEK.
keyVaultId

string

Id. de Key Vault donde se almacena esta clave.

KeyAndSecretDetails

BEK es la clave de BitLocker. KEK es la clave de cifrado para BEK Si la máquina virtual se cifró, almacenaremos los siguientes detalles:

  1. Secret(BEK): dirección URL + Datos de copia de seguridad + vaultId.
  2. Key(KEK): dirección URL + Datos de copia de seguridad + vaultId.
  3. EncryptionMechanism BEK y KEK pueden tener identificadores de almacén diferentes.
Nombre Tipo Description
bekDetails

BEKDetails

BEK es la clave de cifrado de BitLocker.
encryptionMechanism

string

Mecanismo de cifrado: None/ SinglePass/ DoublePass
kekDetails

KEKDetails

KEK es la clave de cifrado para BEK.

PointInTimeRange

Proporciona detalles para los intervalos de registro.

Nombre Tipo Description
endTime

string

Hora de finalización del intervalo de tiempo para la recuperación del registro.
startTime

string

Hora de inicio del intervalo de tiempo para la recuperación del registro.

RecoveryPointDiskConfiguration

Configuración del disco

Nombre Tipo Description
excludedDiskList

DiskInformation[]

Información de los discos excluidos de la copia de seguridad
includedDiskList

DiskInformation[]

Información de los discos incluidos en la copia de seguridad
numberOfDisksAttachedToVm

integer

Número de discos conectados a la máquina virtual
numberOfDisksIncludedInBackup

integer

Número de discos incluidos en la copia de seguridad

RecoveryPointMoveReadinessInfo

Nombre Tipo Description
additionalInfo

string

isReadyForMove

boolean

RecoveryPointProperties

Propiedades del punto de recuperación

Nombre Tipo Description
expiryTime

string

Hora de expiración del punto de recuperación en UTC.
isSoftDeleted

boolean

Bool para indicar si el RP está en estado de eliminación temporal o no
ruleName

string

Nombre de regla etiquetado en el punto de recuperación que rige el ciclo de vida

RecoveryPointResource

Clase base para copias de seguridad. Las copias de seguridad específicas de la carga de trabajo se derivan de esta clase.

Nombre Tipo Description
eTag

string

ETag opcional.
id

string

El identificador de recurso representa la ruta de acceso completa al recurso.
location

string

Ubicación del recurso.
name

string

Nombre del recurso asociado al recurso.
properties RecoveryPoint:

Propiedades recoveryPointResource
tags

object

Etiquetas de recursos.
type

string

El tipo de recurso representa la ruta de acceso completa del formulario Namespace/ResourceType/ResourceType/...

RecoveryPointTierInformationV2

Información de nivel de RecoveryPoint V2

Nombre Tipo Description
extendedInfo

object

Estado del nivel de punto de recuperación.
status

RecoveryPointTierStatus

Estado del nivel de punto de recuperación.
type

RecoveryPointTierType

Tipo de nivel de punto de recuperación.

RecoveryPointTierStatus

Estado del nivel de punto de recuperación.

Nombre Tipo Description
Deleted

string

Disabled

string

Invalid

string

Rehydrated

string

Valid

string

RecoveryPointTierType

Tipo de nivel de punto de recuperación.

Nombre Tipo Description
ArchivedRP

string

HardenedRP

string

InstantRP

string

Invalid

string

RestorePointType

Tipo de punto de restauración

Nombre Tipo Description
Differential

string

Full

string

Incremental

string

Invalid

string

Log

string

SnapshotCopyOnlyFull

string

SnapshotFull

string

SQLDataDirectory

Información de SQLDataDirectory

Nombre Tipo Description
logicalName

string

Nombre lógico del archivo
path

string

Ruta de acceso del archivo
type

SQLDataDirectoryType

Tipo de asignación de directorios de datos

SQLDataDirectoryType

Tipo de asignación de directorios de datos

Nombre Tipo Description
Data

string

Invalid

string

Log

string