Partager via

Recovery Points - Get

  • Référence
Service:
Recovery Services - Backup
Version d'API:
2024-10-01

Fournit les informations des données sauvegardées identifiées à l’aide de RecoveryPointID. Il s’agit d’une opération asynchrone. Pour connaître l’état de l’opération, appelez 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

Paramètres URI

Nom Dans Obligatoire Type Description
containerName
 path True

string

Nom du conteneur associé à l’élément sauvegardé.
fabricName
 path True

string

Nom de l’infrastructure associé à l’élément sauvegardé.
protectedItemName
 path True

string

Nom de l’élément sauvegardé dont les données de sauvegarde doivent être récupérées.
recoveryPointId
 path True

string

RecoveryPointID représente les données sauvegardées à extraire.
resourceGroupName
 path True

string

Nom du groupe de ressources où se trouve le coffre Recovery Services.
subscriptionId
 path True

string

ID d’abonnement.
vaultName
 path True

string

Nom du coffre Recovery Services.
api-version
 query True

string

Version de l’API cliente.

Réponses

Nom Type Description
200 OK

RecoveryPointResource

D’ACCORD
Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation empruntez l’identité de votre compte d’utilisateur.

Exemples

Get Azure Vm Recovery Point Details

Exemple de requête

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

Exemple de réponse

Code d’état:
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
  }
}

Définitions

Nom Description
AzureFileShareRecoveryPoint

Copie de sauvegarde spécifique à la charge de travail du partage de fichiers Azure.
AzureWorkloadPointInTimeRecoveryPoint

Point de récupération spécifique à PointInTime
AzureWorkloadRecoveryPoint

Point de récupération spécifique à la charge de travail, encapsule spécifiquement le point de récupération complet/diff
AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Point de récupération spécifique à PointInTime dans SAPHana
AzureWorkloadSAPHanaRecoveryPoint

Point de récupération spécifique SAPHana, encapsule spécifiquement des points de récupération complets/différents
AzureWorkloadSQLPointInTimeRecoveryPoint

Point de récupération spécifique à PointInTime
AzureWorkloadSQLRecoveryPoint

Le point de récupération spécifique à SQL encapsule spécifiquement le point de récupération complet/diff ainsi que les informations étendues
AzureWorkloadSQLRecoveryPointExtendedInfo

Détails de la classe d’informations étendues
BEKDetails

BEK est une clé de chiffrement bitlocker.
CloudError

Réponse d’erreur du service Container Instance.
CloudErrorBody

Réponse d’erreur du service Container Instance.
DiskInformation

Informations sur le disque
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ExtendedLocation

Emplacement étendu du point de récupération où la machine virtuelle était présente.
GenericRecoveryPoint

Copie de sauvegarde générique.
IaasVMRecoveryPoint

Copie de sauvegarde spécifique à la charge de travail de machine virtuelle IaaS.
KEKDetails

KEK est une clé de chiffrement pour BEK.
KeyAndSecretDetails

BEK est une clé bitlocker. KEK est une clé de chiffrement pour BEK Si la machine virtuelle a été chiffrée, nous allons stocker les détails suivants :

  1. Secret(BEK) : URL + Données de sauvegarde + vaultId.
  2. Key(KEK) : URL + Données de sauvegarde + vaultId.
  3. EncryptionMechanism BEK et KEK peuvent potentiellement avoir différents ID de coffre.
PointInTimeRange

Fournit des détails pour les plages de journaux
RecoveryPointDiskConfiguration

Configuration du disque
RecoveryPointMoveReadinessInfo
RecoveryPointProperties

Propriétés du point de récupération
RecoveryPointResource

Classe de base pour les copies de sauvegarde. Les copies de sauvegarde spécifiques à la charge de travail sont dérivées de cette classe.
RecoveryPointTierInformationV2

Informations de niveau RecoveryPoint V2
RecoveryPointTierStatus

État du niveau de point de récupération.
RecoveryPointTierType

Type de niveau de point de récupération.
RestorePointType

Type de point de restauration
SQLDataDirectory

Informations SQLDataDirectory
SQLDataDirectoryType

Type de mappage de répertoire de données

AzureFileShareRecoveryPoint

Copie de sauvegarde spécifique à la charge de travail du partage de fichiers Azure.

Nom Type Description
fileShareSnapshotUri

string

Contient l’URL de l’instantané du partage de fichiers, le cas échéant
objectType string:

AzureFileShareRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointSizeInGB

integer

Contient la taille du point de récupération
recoveryPointTime

string

Heure à laquelle cette copie de sauvegarde a été créée.
recoveryPointType

string

Type de copie de sauvegarde. Spécifie s’il s’agit d’une sauvegarde cohérente en cas d’incident ou de cohérence d’application.

AzureWorkloadPointInTimeRecoveryPoint

Point de récupération spécifique à PointInTime

Nom Type Description
objectType string:

AzureWorkloadPointInTimeRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTimeInUTC

string

Heure UTC à laquelle le point de récupération a été créé
timeRanges

PointInTimeRange[]

Liste des plages de journaux
type

RestorePointType

Type de point de restauration

AzureWorkloadRecoveryPoint

Point de récupération spécifique à la charge de travail, encapsule spécifiquement le point de récupération complet/diff

Nom Type Description
objectType string:

AzureWorkloadRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTimeInUTC

string

Heure UTC à laquelle le point de récupération a été créé
type

RestorePointType

Type de point de restauration

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Point de récupération spécifique à PointInTime dans SAPHana

Nom Type Description
objectType string:

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTimeInUTC

string

Heure UTC à laquelle le point de récupération a été créé
timeRanges

PointInTimeRange[]

Liste des plages de journaux
type

RestorePointType

Type de point de restauration

AzureWorkloadSAPHanaRecoveryPoint

Point de récupération spécifique SAPHana, encapsule spécifiquement des points de récupération complets/différents

Nom Type Description
objectType string:

AzureWorkloadSAPHanaRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTimeInUTC

string

Heure UTC à laquelle le point de récupération a été créé
type

RestorePointType

Type de point de restauration

AzureWorkloadSQLPointInTimeRecoveryPoint

Point de récupération spécifique à PointInTime

Nom Type Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Informations étendues qui fournissent des détails de répertoire de données. Sera rempli dans deux cas : lorsqu’un point de récupération spécifique est accessible à l’aide de GetRecoveryPoint ou lorsque ListRecoveryPoints est appelé pour le rp de journal uniquement avec le filtre de requête ExtendedInfo
objectType string:

AzureWorkloadSQLPointInTimeRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTimeInUTC

string

Heure UTC à laquelle le point de récupération a été créé
timeRanges

PointInTimeRange[]

Liste des plages de journaux
type

RestorePointType

Type de point de restauration

AzureWorkloadSQLRecoveryPoint

Le point de récupération spécifique à SQL encapsule spécifiquement le point de récupération complet/diff ainsi que les informations étendues

Nom Type Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Informations étendues qui fournissent des détails de répertoire de données. Sera rempli dans deux cas : lorsqu’un point de récupération spécifique est accessible à l’aide de GetRecoveryPoint ou lorsque ListRecoveryPoints est appelé pour le rp de journal uniquement avec le filtre de requête ExtendedInfo
objectType string:

AzureWorkloadSQLRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTimeInUTC

string

Heure UTC à laquelle le point de récupération a été créé
type

RestorePointType

Type de point de restauration

AzureWorkloadSQLRecoveryPointExtendedInfo

Détails de la classe d’informations étendues

Nom Type Description
dataDirectoryPaths

SQLDataDirectory[]

Liste des chemins d’accès au répertoire de données lors de l’opération de restauration.
dataDirectoryTimeInUTC

string

Heure UTC à laquelle les informations de répertoire de données ont été capturées

BEKDetails

BEK est une clé de chiffrement bitlocker.

Nom Type Description
secretData

string

Données BEK.
secretUrl

string

Le secret est BEK.
secretVaultId

string

ID du coffre de clés dans lequel ce secret est stocké.

CloudError

Réponse d’erreur du service Container Instance.

Nom Type Description
error

CloudErrorBody

Objet d’erreur.

CloudErrorBody

Réponse d’erreur du service Container Instance.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details

CloudErrorBody[]

Liste des détails supplémentaires sur l’erreur.
message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

DiskInformation

Informations sur le disque

Nom Type Description
lun

integer

name

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ExtendedLocation

Emplacement étendu du point de récupération où la machine virtuelle était présente.

Nom Type Description
name

string

Nom de l’emplacement étendu.
type

string

Type de l’emplacement étendu. Les valeurs possibles sont les suivantes : « EdgeZone »

GenericRecoveryPoint

Copie de sauvegarde générique.

Nom Type Description
friendlyName

string

Nom convivial de la copie de sauvegarde.
objectType string:

GenericRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
recoveryPointAdditionalInfo

string

Informations supplémentaires associées à cette copie de sauvegarde.
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTime

string

Heure à laquelle cette copie de sauvegarde a été créée.
recoveryPointType

string

Type de copie de sauvegarde.

IaasVMRecoveryPoint

Copie de sauvegarde spécifique à la charge de travail de machine virtuelle IaaS.

Nom Type Description
extendedLocation

ExtendedLocation

L’emplacement étendu du point de récupération de machine virtuelle doit être null si la machine virtuelle se trouve dans le cloud public
isInstantIlrSessionActive

boolean

Session pour récupérer les éléments de cette copie de sauvegarde toujours actif.
isManagedVirtualMachine

boolean

Indique si la machine virtuelle est avec des disques managés
isPrivateAccessEnabledOnAnyDisk

boolean

Cet indicateur indique si l’un des disques de la machine virtuelle utilise le paramètre réseau d’accès privé
isSourceVMEncrypted

boolean

Identifie si la machine virtuelle a été chiffrée lors de la création de la copie de sauvegarde.
keyAndSecret

KeyAndSecretDetails

Détails requis pour la récupération d’une machine virtuelle chiffrée. Applicable uniquement lorsque IsSourceVMEncrypted a la valeur true.
objectType string:

IaasVMRecoveryPoint

Cette propriété sera utilisée comme discriminateur pour décider des types spécifiques dans la chaîne polymorphe de types.
originalStorageAccountOption

boolean

Option de compte de stockage d’origine
osType

string

Type de système d’exploitation
recoveryPointAdditionalInfo

string

Informations supplémentaires associées à cette copie de sauvegarde.
recoveryPointDiskConfiguration

RecoveryPointDiskConfiguration

Configuration du disque
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Éligibilité du fournisseur de ressources à déplacer vers un autre niveau
recoveryPointProperties

RecoveryPointProperties

Propriétés du point de récupération
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informations de niveau de point de récupération.
recoveryPointTime

string

Heure à laquelle cette copie de sauvegarde a été créée.
recoveryPointType

string

Type de copie de sauvegarde.
securityType

string

Type de sécurité du disque
sourceVMStorageType

string

Type de stockage de la machine virtuelle dont la copie de sauvegarde est créée.
virtualMachineSize

string

Taille de la machine virtuelle
zones

string[]

Identifie la zone de la machine virtuelle au moment de la sauvegarde. Applicable uniquement pour les machines virtuelles épinglées dans une zone

KEKDetails

KEK est une clé de chiffrement pour BEK.

Nom Type Description
keyBackupData

string

Données KEK.
keyUrl

string

La clé est KEK.
keyVaultId

string

ID key Vault où cette clé est stockée.

KeyAndSecretDetails

BEK est une clé bitlocker. KEK est une clé de chiffrement pour BEK Si la machine virtuelle a été chiffrée, nous allons stocker les détails suivants :

  1. Secret(BEK) : URL + Données de sauvegarde + vaultId.
  2. Key(KEK) : URL + Données de sauvegarde + vaultId.
  3. EncryptionMechanism BEK et KEK peuvent potentiellement avoir différents ID de coffre.
Nom Type Description
bekDetails

BEKDetails

BEK est une clé de chiffrement bitlocker.
encryptionMechanism

string

Mécanisme de chiffrement : None/ SinglePass/ DoublePass
kekDetails

KEKDetails

KEK est une clé de chiffrement pour BEK.

PointInTimeRange

Fournit des détails pour les plages de journaux

Nom Type Description
endTime

string

Heure de fin de l’intervalle de temps pour la récupération du journal.
startTime

string

Heure de début de l’intervalle de temps pour la récupération du journal.

RecoveryPointDiskConfiguration

Configuration du disque

Nom Type Description
excludedDiskList

DiskInformation[]

Informations sur les disques exclus de la sauvegarde
includedDiskList

DiskInformation[]

Informations sur les disques inclus dans la sauvegarde
numberOfDisksAttachedToVm

integer

Nombre de disques attachés à la machine virtuelle
numberOfDisksIncludedInBackup

integer

Nombre de disques inclus dans la sauvegarde

RecoveryPointMoveReadinessInfo

Nom Type Description
additionalInfo

string

isReadyForMove

boolean

RecoveryPointProperties

Propriétés du point de récupération

Nom Type Description
expiryTime

string

Heure d’expiration du point de récupération au format UTC.
isSoftDeleted

boolean

Bool pour indiquer si le fournisseur de ressources est dans un état de suppression réversible ou non
ruleName

string

Nom de règle marqué sur le point de récupération qui régit le cycle de vie

RecoveryPointResource

Classe de base pour les copies de sauvegarde. Les copies de sauvegarde spécifiques à la charge de travail sont dérivées de cette classe.

Nom Type Description
eTag

string

ETag facultatif.
id

string

L’ID de ressource représente le chemin d’accès complet à la ressource.
location

string

Emplacement des ressources.
name

string

Nom de la ressource associé à la ressource.
properties RecoveryPoint:

Propriétés RecoveryPointResource
tags

object

Balises de ressource.
type

string

Le type de ressource représente le chemin d’accès complet du formulaire Namespace/ResourceType/ResourceType/...

RecoveryPointTierInformationV2

Informations de niveau RecoveryPoint V2

Nom Type Description
extendedInfo

object

État du niveau de point de récupération.
status

RecoveryPointTierStatus

État du niveau de point de récupération.
type

RecoveryPointTierType

Type de niveau de point de récupération.

RecoveryPointTierStatus

État du niveau de point de récupération.

Nom Type Description
Deleted

string

Disabled

string

Invalid

string

Rehydrated

string

Valid

string

RecoveryPointTierType

Type de niveau de point de récupération.

Nom Type Description
ArchivedRP

string

HardenedRP

string

InstantRP

string

Invalid

string

RestorePointType

Type de point de restauration

Nom Type Description
Differential

string

Full

string

Incremental

string

Invalid

string

Log

string

SnapshotCopyOnlyFull

string

SnapshotFull

string

SQLDataDirectory

Informations SQLDataDirectory

Nom Type Description
logicalName

string

Nom logique du fichier
path

string

Chemin d’accès au fichier
type

SQLDataDirectoryType

Type de mappage de répertoire de données

SQLDataDirectoryType

Type de mappage de répertoire de données

Nom Type Description
Data

string

Invalid

string

Log

string