Disk Restore Point - Get

Service:

Compute

Version d’API:

2026-03-02

Obtenir la ressource RestorePoint de disque

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}/restorePoints/{vmRestorePointName}/diskRestorePoints/{diskRestorePointName}?api-version=2026-03-02

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
diskRestorePointName	path	True	string	Le nom de DiskRestorePoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
restorePointCollectionName	path	True	string	Nom de la collection de points de restauration à laquelle appartient le point de restauration de disque.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
vmRestorePointName	path	True	string	Nom du point de restauration de la machine virtuelle auquel appartient le point de restauration du disque de disque.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	DiskRestorePoint	Opération Azure terminée avec succès.
Other Status Codes	CloudError	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

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

Étendues

Nom	Description
user_impersonation	Usurper l’identité de votre compte utilisateur

Exemples

get a ConfidentialVM incremental disk restorePoint resource with confidentialVMVersion.

get a disk restorePoint resource with InstantAccess snapshotAccessState.

get an incremental disk restorePoint resource.

get an incremental disk restorePoint when source resource is from a different region

get a ConfidentialVM incremental disk restorePoint resource with confidentialVMVersion.

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/myConfidentialDisk_c4bc27e0-ccf6-494e-a740-af34de775527?api-version=2026-03-02

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/myConfidentialDisk_c4bc27e0-ccf6-494e-a740-af34de775527",
  "name": "myConfidentialDisk_c4bc27e0-ccf6-494e-a740-af34de775527",
  "properties": {
    "timeCreated": "2026-03-02T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myConfidentialDisk",
    "osType": "Windows",
    "hyperVGeneration": "V2",
    "familyId": "f22e934b-c768-447f-8c44-ada4b40224ec",
    "sourceUniqueId": "d633885d-d102-4481-901e-5b2413d1a7be",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithPlatformKey",
      "confidentialVMVersion": "V2"
    },
    "logicalSectorSize": 4096
  }
}

get a disk restorePoint resource with InstantAccess snapshotAccessState.

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee_5c1528-43e2-4c77-9c55-a78bf5a5fc88?api-version=2026-03-02

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee_5c1528-43e2-4c77-9c55-a78bf5a5fc88",
  "name": "TestDisk45ceb03433006d1baee_5c1528-43e2-4c77-9c55-a78bf5a5fc88",
  "properties": {
    "timeCreated": "2026-03-02T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee",
    "osType": "Windows",
    "hyperVGeneration": "V2",
    "familyId": "f22e934b-c768-447f-8c44-ada4b40224ec",
    "sourceUniqueId": "d633885d-d102-4481-901e-5b2413d1a7be",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "completionPercent": 100,
    "logicalSectorSize": 4096,
    "snapshotAccessState": "InstantAccess"
  }
}

get an incremental disk restorePoint resource.

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745?api-version=2026-03-02

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "properties": {
    "timeCreated": "2020-09-16T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
    "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "logicalSectorSize": 4096
  }
}

get an incremental disk restorePoint when source resource is from a different region

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745?api-version=2026-03-02

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "properties": {
    "timeCreated": "2020-09-16T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
    "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "replicationState": "Succeeded",
    "completionPercent": 100,
    "sourceResourceLocation": "eastus2",
    "logicalSectorSize": 4096
  }
}

Définitions

Nom	Description
ApiError	Erreur d’API.
ApiErrorBase	Base d’erreurs d’API.
Architecture	Architecture du processeur prise en charge par un disque de système d’exploitation.
CloudError	Réponse d’erreur du service de calcul.
ConfidentialVMVersion	Indique la version de la VM confidentielle pour la ressource.
createdByType	Type d’identité qui a créé la ressource.
DiskPurchasePlan	Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace.
DiskRestorePoint	Propriétés du point de restauration de disque
DiskSecurityProfile	Contient les informations relatives à la sécurité de la ressource.
DiskSecurityTypes	Spécifie le SecurityType de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.
Encryption	Paramètres de chiffrement au repos pour le disque ou l’instantané
EncryptionType	Type de clé utilisé pour chiffrer les données du disque.
HyperVGeneration	Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.
InnerError	Détails de l’erreur interne.
NetworkAccessPolicy	Stratégie d’accès au disque via le réseau.
OperatingSystemTypes	Type de système d’exploitation.
PublicNetworkAccess	Stratégie de contrôle de l’exportation sur le disque.
SnapshotAccessState	État de l’instantané qui détermine la disponibilité de l’accès à l’instantané.
SupportedCapabilities	Liste des fonctionnalités prises en charge persistantes sur la ressource de disque pour l’utilisation de la machine virtuelle.
SupportedSecurityOption	Fait référence à la capacité de sécurité du disque pris en charge pour créer un lancement approuvé ou une machine virtuelle confidentielle
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

ApiError

Objet

Erreur d’API.

Nom	Type	Description
code	string	Code d’erreur.
details	ApiErrorBase[]	Détails de l’erreur api
innererror	InnerError	Erreur interne de l’API
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

ApiErrorBase

Objet

Base d’erreurs d’API.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur.
target	string	Cible de l’erreur particulière.

Architecture

Énumération

Architecture du processeur prise en charge par un disque de système d’exploitation.

Valeur	Description
x64
Arm64

CloudError

Objet

Réponse d’erreur du service de calcul.

Nom	Type	Description
error	ApiError	Erreur d’API.

ConfidentialVMVersion

Énumération

Indique la version de la VM confidentielle pour la ressource.

Valeur	Description
V1	V1 indique que la ressource ne possède pas de métadonnées de machine virtuelle associées.
V2	V2 indique que la ressource possède une métadonnée de machine virtuelle associée.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Objet

Utilisé pour établir le contexte d’achat d’un artefact tiers via MarketPlace.

Nom	Type	Description
name	string	ID du plan.
product	string	Spécifie le produit de l’image à partir de la Place de marché. Il s’agit de la même valeur que Offer sous l’élément imageReference.
promotionCode	string	Code de promotion de l’offre.
publisher	string	ID de l’éditeur.

DiskRestorePoint

Objet

Propriétés du point de restauration de disque

Nom	Type	Description
id	string	Identifiant de ressource entièrement qualifié pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nom de la ressource.
properties.completionPercent	number (float)	Pourcentage terminé pour la copie en arrière-plan du point de restauration de disque lorsque la ressource source provient d’une autre région.
properties.diskAccessId	string	ID ARM de la ressource DiskAccess pour l’utilisation de points de terminaison privés sur des disques.
properties.encryption	Encryption	La propriété de chiffrement peut être utilisée pour chiffrer les données au repos avec des clés gérées par le client ou des clés gérées par la plateforme.
properties.familyId	string	id de la famille MIS de l’instantané de sauvegarde
properties.hyperVGeneration	HyperVGeneration	Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.
properties.logicalSectorSize	integer (int32)	Taille du secteur logique en octets pour les points de restauration de disque de UltraSSD_LRS et de disques PremiumV2_LRS. Les valeurs prises en charge sont 512 et 4096. 4096 est la valeur par défaut.
properties.networkAccessPolicy	NetworkAccessPolicy	Stratégie d’accès au disque via le réseau.
properties.osType	OperatingSystemTypes	Type de système d’exploitation.
properties.publicNetworkAccess	PublicNetworkAccess	Stratégie de contrôle de l’exportation sur le disque.
properties.purchasePlan	DiskPurchasePlan	Informations sur le plan d’achat de l’image à partir de laquelle le disque du système d’exploitation a été créé.
properties.replicationState	string	État de réplication du point de restauration de disque lorsque la ressource source provient d’une autre région.
properties.securityProfile	DiskSecurityProfile	Contient les informations relatives à la sécurité de la ressource.
properties.snapshotAccessState	SnapshotAccessState	État de l’instantané qui détermine la disponibilité de l’accès à l’instantané.
properties.sourceResourceId	string	id arm du disque source ou du point de restauration de disque source.
properties.sourceResourceLocation	string	Emplacement du disque source ou du point de restauration de disque source lorsque la ressource source provient d’une autre région.
properties.sourceUniqueId	string	ID d’incarnation unique du disque source
properties.supportedCapabilities	SupportedCapabilities	Liste des fonctionnalités prises en charge pour l’image à partir de laquelle le disque du système d’exploitation a été créé.
properties.supportsHibernation	boolean	Indique que le système d’exploitation sur un disque prend en charge la mise en veille prolongée.
properties.timeCreated	string (date-time)	L’horodatage de la création de restorePoint
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

DiskSecurityProfile

Objet

Contient les informations relatives à la sécurité de la ressource.

Nom	Type	Description
confidentialVMVersion	ConfidentialVMVersion	Indique la version de la VM confidentielle pour la ressource.
secureVMDiskEncryptionSetId	string	ResourceId du jeu de chiffrement de disque associé à une machine virtuelle confidentielle prise en charge par disque chiffré avec une clé gérée par le client
securityType	DiskSecurityTypes	Spécifie le SecurityType de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

DiskSecurityTypes

Énumération

Spécifie le SecurityType de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

Valeur	Description
TrustedLaunch	Trusted Launch fournit des fonctionnalités de sécurité telles que le démarrage sécurisé et le module de plateforme sécurisée (vTPM)
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Indique le disque de machine virtuelle confidentielle avec uniquement l’état invité de la machine virtuelle chiffré
ConfidentialVM_DiskEncryptedWithPlatformKey	Indique le disque de machine virtuelle confidentielle avec le disque du système d’exploitation et l’état invité de la machine virtuelle chiffrés avec une clé gérée par la plateforme
ConfidentialVM_DiskEncryptedWithCustomerKey	Indique le disque de machine virtuelle confidentielle avec le disque du système d’exploitation et l’état invité de la machine virtuelle chiffrés avec une clé gérée par le client
ConfidentialVM_NonPersistedTPM	Indique le disque de machine virtuelle confidentielle avec un vTPM éphémère. L’état vTPM n’est pas conservé entre les redémarrages de machine virtuelle.

Encryption

Objet

Paramètres de chiffrement au repos pour le disque ou l’instantané

Nom	Type	Description
diskEncryptionSetId	string	ResourceId du jeu de chiffrement de disque à utiliser pour activer le chiffrement au repos.
type	EncryptionType	Type de clé utilisé pour chiffrer les données du disque.

EncryptionType

Énumération

Type de clé utilisé pour chiffrer les données du disque.

Valeur	Description
EncryptionAtRestWithPlatformKey	Le disque est chiffré au repos avec la clé gérée par la plateforme. Il s’agit du type de chiffrement par défaut. Il ne s’agit pas d’un type de chiffrement valide pour les jeux de chiffrement de disque.
EncryptionAtRestWithCustomerKey	Le disque est chiffré au repos avec la clé gérée par le client qui peut être modifiée et révoquée par un client.
EncryptionAtRestWithPlatformAndCustomerKeys	Le disque est chiffré au repos avec 2 couches de chiffrement. L’une des clés est gérée par le client et l’autre clé est gérée par la plateforme.

HyperVGeneration

Énumération

Génération d’hyperviseur de la machine virtuelle. Applicable uniquement aux disques du système d’exploitation.

Valeur	Description
V1
V2

InnerError

Objet

Détails de l’erreur interne.

Nom	Type	Description
errordetail	string	Message d’erreur interne ou vidage d’exception.
exceptiontype	string	Type d'exception.

NetworkAccessPolicy

Énumération

Stratégie d’accès au disque via le réseau.

Valeur	Description
AllowAll	Le disque peut être exporté ou chargé vers n’importe quel réseau.
AllowPrivate	Le disque peut être exporté ou chargé à l’aide des points de terminaison privés d’une ressource DiskAccess.
DenyAll	Impossible d’exporter le disque.

OperatingSystemTypes

Énumération

Type de système d’exploitation.

Valeur	Description
Windows
Linux

PublicNetworkAccess

Énumération

Stratégie de contrôle de l’exportation sur le disque.

Valeur	Description
Enabled	Vous pouvez générer un URI SAP pour accéder aux données sous-jacentes du disque publiquement sur Internet lorsque NetworkAccessPolicy est défini sur AllowAll. Vous pouvez accéder aux données via l’URI SAP uniquement à partir de votre réseau virtuel Azure approuvé lorsque NetworkAccessPolicy est défini sur AllowPrivate.
Disabled	Vous ne pouvez pas accéder aux données sous-jacentes du disque publiquement sur Internet même si NetworkAccessPolicy est défini sur AllowAll. Vous pouvez accéder aux données via l’URI SAP uniquement à partir de votre réseau virtuel Azure approuvé lorsque NetworkAccessPolicy est défini sur AllowPrivate.

SnapshotAccessState

Énumération

État de l’instantané qui détermine la disponibilité de l’accès à l’instantané.

Valeur	Description
Unknown	Valeur par défaut.
Pending	L’instantané ne peut pas être utilisé pour la restauration, la copie ou le téléchargement hors connexion.
Available	L’instantané peut être utilisé pour la restauration, la copie dans une autre région et le téléchargement hors connexion.
InstantAccess	L’instantané peut être utilisé pour restaurer des disques avec des performances rapides, mais ne peut pas être copié ou téléchargé.
AvailableWithInstantAccess	Le snapshot peut être utilisé pour restaurer des disques aux performances rapides, copiés et téléchargés.

SupportedCapabilities

Objet

Liste des fonctionnalités prises en charge persistantes sur la ressource de disque pour l’utilisation de la machine virtuelle.

Nom	Type	Description
acceleratedNetwork	boolean	True si l’image à partir de laquelle le disque du système d’exploitation est créé prend en charge la mise en réseau accélérée.
architecture	Architecture	Architecture du processeur prise en charge par un disque de système d’exploitation.
diskControllerTypes	string	Contrôleurs de disque pris en charge par un disque de système d’exploitation. S’il peut être défini sur SCSI ou SCSI, NVME ou NVME, SCSI.
supportedSecurityOption	SupportedSecurityOption	Fait référence à la capacité de sécurité du disque pris en charge pour créer un lancement approuvé ou une machine virtuelle confidentielle

SupportedSecurityOption

Énumération

Fait référence à la capacité de sécurité du disque pris en charge pour créer un lancement approuvé ou une machine virtuelle confidentielle

Valeur	Description
TrustedLaunchSupported	Le disque prend en charge la création de machines virtuelles Trusted Launch.
TrustedLaunchAndConfidentialVMSupported	Le disque prend en charge la création de VM de lancement approuvé et de machines virtuelles confidentielles.

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.