Recovery Points - Get

Riferimento

Servizio:: Recovery Services - Backup

Versione API:: 2024-10-01

Fornisce le informazioni dei dati di cui è stato eseguito il backup identificati tramite RecoveryPointID. Si tratta di un'operazione asincrona. Per conoscere lo stato dell'operazione, chiamare l'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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
containerName	path	True	string	Nome del contenitore associato all'elemento di cui è stato eseguito il backup.
fabricName	path	True	string	Nome dell'infrastruttura associato all'elemento di cui è stato eseguito il backup.
protectedItemName	path	True	string	Nome dell'elemento di cui è necessario recuperare i dati di backup.
recoveryPointId	path	True	string	RecoveryPointID rappresenta i dati di cui eseguire il backup da recuperare.
resourceGroupName	path	True	string	Nome del gruppo di risorse in cui è presente l'insieme di credenziali dei servizi di ripristino.
subscriptionId	path	True	string	ID sottoscrizione.
vaultName	path	True	string	Nome dell'insieme di credenziali di Servizi di ripristino.
api-version	query	True	string	Versione dell'API client.

Risposte

Nome	Tipo	Descrizione
200 OK	RecoveryPointResource	OK
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente.

Esempio

Get Azure Vm Recovery Point Details

Esempio di richiesta

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=2024-10-01

Risposta di esempio

Codice di stato:: 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
  }
}

Definizioni

Nome	Descrizione
AzureFileShareRecoveryPoint	Copia di backup specifica del carico di lavoro condivisione file di Azure.
AzureWorkloadPointInTimeRecoveryPoint	Punto di ripristino specifico di PointInTime
AzureWorkloadRecoveryPoint	Punto di ripristino specifico del carico di lavoro, incapsula in modo specifico il punto di ripristino completo/diff
AzureWorkloadSAPHanaPointInTimeRecoveryPoint	Punto di ripristino specifico di PointInTime in SAPHana
AzureWorkloadSAPHanaRecoveryPoint	Punto di ripristino specifico di SAPHana, incapsula in modo specifico i punti di ripristino completi/diff
AzureWorkloadSQLPointInTimeRecoveryPoint	Punto di ripristino specifico di PointInTime
AzureWorkloadSQLRecoveryPoint	Punto di ripristino specifico di SQL, incapsula in modo specifico il punto di ripristino completo/diff insieme alle informazioni estese
AzureWorkloadSQLRecoveryPointExtendedInfo	Dettagli della classe info estesa
BEKDetails	BEK è la chiave di crittografia bitlocker.
CloudError	Risposta di errore del servizio Istanza contenitore.
CloudErrorBody	Risposta di errore del servizio Istanza contenitore.
DiskInformation	Informazioni sul disco
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ExtendedLocation	Posizione estesa del punto di ripristino in cui era presente la macchina virtuale.
GenericRecoveryPoint	Copia di backup generica.
IaasVMRecoveryPoint	Copia di backup specifica del carico di lavoro della macchina virtuale IaaS.
KEKDetails	KEK è la chiave di crittografia per BEK.
KeyAndSecretDetails	BEK è la chiave bitlocker. KEK è la chiave di crittografia per BEK Se la macchina virtuale è stata crittografata, verranno archiviati i dettagli seguenti: Secret(BEK) - URL + Backup Data + vaultId. Key(KEK) - URL + Backup Data + vaultId. EncryptionMechanism BEK e KEK possono avere id dell'insieme di credenziali diversi.
PointInTimeRange	Fornisce informazioni dettagliate per gli intervalli di log
RecoveryPointDiskConfiguration	Configurazione del disco
RecoveryPointMoveReadinessInfo
RecoveryPointProperties	Proprietà del punto di ripristino
RecoveryPointResource	Classe di base per le copie di backup. Le copie di backup specifiche del carico di lavoro derivano da questa classe.
RecoveryPointTierInformationV2	Informazioni sul livello RecoveryPoint V2
RecoveryPointTierStatus	Stato del livello del punto di ripristino.
RecoveryPointTierType	Tipo di livello del punto di ripristino.
RestorePointType	Tipo di punto di ripristino
SQLDataDirectory	Informazioni su SQLDataDirectory
SQLDataDirectoryType	Tipo di mapping della directory dati

AzureFileShareRecoveryPoint

Copia di backup specifica del carico di lavoro condivisione file di Azure.

Nome	Tipo	Descrizione
fileShareSnapshotUri	string	Contiene l'URL dello snapshot della condivisione file, se applicabile
objectType	string: AzureFileShareRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointSizeInGB	integer	Contiene le dimensioni del punto di ripristino
recoveryPointTime	string	Ora di creazione della copia di backup.
recoveryPointType	string	Tipo di copia di backup. Specifica se si tratta di un backup coerente con l'arresto anomalo del sistema o di un'app coerente.

AzureWorkloadPointInTimeRecoveryPoint

Punto di ripristino specifico di PointInTime

Nome	Tipo	Descrizione
objectType	string: AzureWorkloadPointInTimeRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTimeInUTC	string	Ora UTC in cui è stato creato il punto di ripristino
timeRanges	PointInTimeRange[]	Elenco di intervalli di log
type	RestorePointType	Tipo di punto di ripristino

AzureWorkloadRecoveryPoint

Punto di ripristino specifico del carico di lavoro, incapsula in modo specifico il punto di ripristino completo/diff

Nome	Tipo	Descrizione
objectType	string: AzureWorkloadRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTimeInUTC	string	Ora UTC in cui è stato creato il punto di ripristino
type	RestorePointType	Tipo di punto di ripristino

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Punto di ripristino specifico di PointInTime in SAPHana

Nome	Tipo	Descrizione
objectType	string: AzureWorkloadSAPHanaPointInTimeRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTimeInUTC	string	Ora UTC in cui è stato creato il punto di ripristino
timeRanges	PointInTimeRange[]	Elenco di intervalli di log
type	RestorePointType	Tipo di punto di ripristino

AzureWorkloadSAPHanaRecoveryPoint

Punto di ripristino specifico di SAPHana, incapsula in modo specifico i punti di ripristino completi/diff

Nome	Tipo	Descrizione
objectType	string: AzureWorkloadSAPHanaRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTimeInUTC	string	Ora UTC in cui è stato creato il punto di ripristino
type	RestorePointType	Tipo di punto di ripristino

AzureWorkloadSQLPointInTimeRecoveryPoint

Punto di ripristino specifico di PointInTime

Nome	Tipo	Descrizione
extendedInfo	AzureWorkloadSQLRecoveryPointExtendedInfo	Informazioni estese che forniscono i dettagli della directory dei dati. Verrà popolato in due casi: quando si accede a un punto di ripristino specifico tramite GetRecoveryPoint Oppure quando listRecoveryPoints viene chiamato solo per il rpo di log solo con il filtro di query ExtendedInfo
objectType	string: AzureWorkloadSQLPointInTimeRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTimeInUTC	string	Ora UTC in cui è stato creato il punto di ripristino
timeRanges	PointInTimeRange[]	Elenco di intervalli di log
type	RestorePointType	Tipo di punto di ripristino

AzureWorkloadSQLRecoveryPoint

Punto di ripristino specifico di SQL, incapsula in modo specifico il punto di ripristino completo/diff insieme alle informazioni estese

Nome	Tipo	Descrizione
extendedInfo	AzureWorkloadSQLRecoveryPointExtendedInfo	Informazioni estese che forniscono i dettagli della directory dei dati. Verrà popolato in due casi: quando si accede a un punto di ripristino specifico tramite GetRecoveryPoint Oppure quando listRecoveryPoints viene chiamato solo per il rpo di log solo con il filtro di query ExtendedInfo
objectType	string: AzureWorkloadSQLRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTimeInUTC	string	Ora UTC in cui è stato creato il punto di ripristino
type	RestorePointType	Tipo di punto di ripristino

AzureWorkloadSQLRecoveryPointExtendedInfo

Dettagli della classe info estesa

Nome	Tipo	Descrizione
dataDirectoryPaths	SQLDataDirectory[]	Elenco dei percorsi della directory dati durante l'operazione di ripristino.
dataDirectoryTimeInUTC	string	Ora UTC in cui sono state acquisite le informazioni sulla directory dei dati

BEKDetails

BEK è la chiave di crittografia bitlocker.

Nome	Tipo	Descrizione
secretData	string	Dati BEK.
secretUrl	string	Il segreto è BEK.
secretVaultId	string	ID dell'insieme di credenziali delle chiavi in cui è archiviato il segreto.

CloudError

Risposta di errore del servizio Istanza contenitore.

Nome	Tipo	Descrizione
error	CloudErrorBody	Oggetto error.

CloudErrorBody

Risposta di errore del servizio Istanza contenitore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	CloudErrorBody[]	Elenco di dettagli aggiuntivi sull'errore.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
target	string	Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

DiskInformation

Informazioni sul disco

Nome	Tipo	Descrizione
lun	integer
name	string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ExtendedLocation

Posizione estesa del punto di ripristino in cui era presente la macchina virtuale.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	string	Tipo della posizione estesa. I valori possibili includono: 'EdgeZone'

GenericRecoveryPoint

Copia di backup generica.

Nome	Tipo	Descrizione
friendlyName	string	Nome descrittivo della copia di backup.
objectType	string: GenericRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
recoveryPointAdditionalInfo	string	Informazioni aggiuntive associate a questa copia di backup.
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTime	string	Ora di creazione della copia di backup.
recoveryPointType	string	Tipo di copia di backup.

IaasVMRecoveryPoint

Copia di backup specifica del carico di lavoro della macchina virtuale IaaS.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	La posizione estesa del punto di ripristino della macchina virtuale deve essere Null se la macchina virtuale si trova nel cloud pubblico
isInstantIlrSessionActive	boolean	Sessione per ripristinare gli elementi da questa copia di backup ancora attiva.
isManagedVirtualMachine	boolean	Indica se la macchina virtuale è con Managed Disks
isPrivateAccessEnabledOnAnyDisk	boolean	Questo flag indica se uno dei dischi nella macchina virtuale usa l'impostazione Rete di accesso privato
isSourceVMEncrypted	boolean	Identifica se la macchina virtuale è stata crittografata al momento della creazione della copia di backup.
keyAndSecret	KeyAndSecretDetails	Dettagli necessari per il ripristino di una macchina virtuale crittografata. Applicabile solo quando IsSourceVMEncrypted è true.
objectType	string: IaasVMRecoveryPoint	Questa proprietà verrà utilizzata come discriminante per decidere i tipi specifici nella catena polimorfica di tipi.
originalStorageAccountOption	boolean	Opzione dell'account di archiviazione originale
osType	string	Tipo di sistema operativo
recoveryPointAdditionalInfo	string	Informazioni aggiuntive associate a questa copia di backup.
recoveryPointDiskConfiguration	RecoveryPointDiskConfiguration	Configurazione del disco
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	Idoneità del punto di ripristino da spostare in un altro livello
recoveryPointProperties	RecoveryPointProperties	Proprietà del punto di ripristino
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	Informazioni sul livello del punto di ripristino.
recoveryPointTime	string	Ora di creazione della copia di backup.
recoveryPointType	string	Tipo di copia di backup.
securityType	string	Tipo di sicurezza del disco
sourceVMStorageType	string	Tipo di archiviazione della macchina virtuale la cui copia di backup viene creata.
virtualMachineSize	string	Dimensioni macchina virtuale
zones	string[]	Identifica la zona della macchina virtuale al momento del backup. Applicabile solo per le macchine virtuali aggiunte alla zona

KEKDetails

KEK è la chiave di crittografia per BEK.

Nome	Tipo	Descrizione
keyBackupData	string	Dati KEK.
keyUrl	string	La chiave è KEK.
keyVaultId	string	ID dell'insieme di credenziali delle chiavi in cui è archiviata questa chiave.

KeyAndSecretDetails

BEK è la chiave bitlocker. KEK è la chiave di crittografia per BEK Se la macchina virtuale è stata crittografata, verranno archiviati i dettagli seguenti:

Secret(BEK) - URL + Backup Data + vaultId.
Key(KEK) - URL + Backup Data + vaultId.
EncryptionMechanism BEK e KEK possono avere id dell'insieme di credenziali diversi.

Nome	Tipo	Descrizione
bekDetails	BEKDetails	BEK è la chiave di crittografia bitlocker.
encryptionMechanism	string	Meccanismo di crittografia: None/ SinglePass/ DoublePass
kekDetails	KEKDetails	KEK è la chiave di crittografia per BEK.

PointInTimeRange

Fornisce informazioni dettagliate per gli intervalli di log

Nome	Tipo	Descrizione
endTime	string	Ora di fine dell'intervallo di tempo per il ripristino del log.
startTime	string	Ora di inizio dell'intervallo di tempo per il ripristino del log.

RecoveryPointDiskConfiguration

Configurazione del disco

Nome	Tipo	Descrizione
excludedDiskList	DiskInformation[]	Informazioni sui dischi esclusi dal backup
includedDiskList	DiskInformation[]	Informazioni sui dischi inclusi nel backup
numberOfDisksAttachedToVm	integer	Numero di dischi collegati alla macchina virtuale
numberOfDisksIncludedInBackup	integer	Numero di dischi inclusi nel backup

RecoveryPointMoveReadinessInfo

Nome	Tipo	Descrizione
additionalInfo	string
isReadyForMove	boolean

RecoveryPointProperties

Proprietà del punto di ripristino

Nome	Tipo	Descrizione
expiryTime	string	Ora di scadenza del punto di ripristino in formato UTC.
isSoftDeleted	boolean	Bool per indicare se rp è in stato di eliminazione temporanea o meno
ruleName	string	Nome della regola contrassegnato nel punto di ripristino che regola il ciclo di vita

RecoveryPointResource

Classe di base per le copie di backup. Le copie di backup specifiche del carico di lavoro derivano da questa classe.

Nome	Tipo	Descrizione
eTag	string	ETag facoltativo.
id	string	L'ID risorsa rappresenta il percorso completo della risorsa.
location	string	Percorso della risorsa.
name	string	Nome della risorsa associato alla risorsa.
properties	RecoveryPoint: AzureFileShareRecoveryPoint AzureWorkloadPointInTimeRecoveryPoint AzureWorkloadRecoveryPoint AzureWorkloadSAPHanaPointInTimeRecoveryPoint AzureWorkloadSAPHanaRecoveryPoint AzureWorkloadSQLPointInTimeRecoveryPoint AzureWorkloadSQLRecoveryPoint GenericRecoveryPoint IaasVMRecoveryPoint	Proprietà recoveryPointResource
tags	object	Tag di risorsa.
type	string	Tipo di risorsa rappresenta il percorso completo del modulo Spazio dei nomi/ResourceType/ResourceType/...

RecoveryPointTierInformationV2

Informazioni sul livello RecoveryPoint V2

Nome	Tipo	Descrizione
extendedInfo	object	Stato del livello del punto di ripristino.
status	RecoveryPointTierStatus	Stato del livello del punto di ripristino.
type	RecoveryPointTierType	Tipo di livello del punto di ripristino.

RecoveryPointTierStatus

Stato del livello del punto di ripristino.

Nome	Tipo	Descrizione
Deleted	string
Disabled	string
Invalid	string
Rehydrated	string
Valid	string

RecoveryPointTierType

Tipo di livello del punto di ripristino.

Nome	Tipo	Descrizione
ArchivedRP	string
HardenedRP	string
InstantRP	string
Invalid	string

RestorePointType

Tipo di punto di ripristino

Nome	Tipo	Descrizione
Differential	string
Full	string
Incremental	string
Invalid	string
Log	string
SnapshotCopyOnlyFull	string
SnapshotFull	string

SQLDataDirectory

Informazioni su SQLDataDirectory

Nome	Tipo	Descrizione
logicalName	string	Nome logico del file
path	string	Percorso file
type	SQLDataDirectoryType	Tipo di mapping della directory dati

SQLDataDirectoryType

Tipo di mapping della directory dati

Nome	Tipo	Descrizione
Data	string
Invalid	string
Log	string

Condividi tramite