Disk Restore Point - Get

Servicio:: Compute

Versión de la API:: 2025-01-02

Obtención del recurso restorePoint de disco

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
diskRestorePointName	path	True	string	El nombre de DiskRestorePoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
restorePointCollectionName	path	True	string	Nombre de la colección de puntos de restauración a la que pertenece el punto de restauración del disco.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
vmRestorePointName	path	True	string	Nombre del punto de restauración de la máquina virtual al que pertenece el punto de restauración del disco del disco.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	DiskRestorePoint	La operación de Azure se completó correctamente.
Other Status Codes	CloudError	Una respuesta de error inesperada.

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 an incremental disk restorePoint resource.

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

get an incremental disk restorePoint resource.

Solicitud de ejemplo

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=2025-01-02

Respuesta de muestra

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

Solicitud de ejemplo

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=2025-01-02

Respuesta de muestra

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

Definiciones

Nombre	Description
ApiError	Error de API.
ApiErrorBase	Base de errores de API.
Architecture	Arquitectura de CPU compatible con un disco del sistema operativo.
CloudError	Una respuesta de error del servicio de proceso.
createdByType	Tipo de identidad que creó el recurso.
DiskPurchasePlan	Se utiliza para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.
DiskRestorePoint	Propiedades del punto de restauración del disco
DiskSecurityProfile	Contiene la información relacionada con la seguridad del recurso.
DiskSecurityTypes	Especifica securityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.
Encryption	Configuración de cifrado en reposo para disco o instantánea
EncryptionType	Tipo de clave que se usa para cifrar los datos del disco.
HyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.
InnerError	Detalles del error interno.
NetworkAccessPolicy	Directiva para acceder al disco a través de la red.
OperatingSystemTypes	Tipo de sistema operativo.
PublicNetworkAccess	Directiva para controlar la exportación en el disco.
SupportedCapabilities	Lista de funcionalidades admitidas que se conservan en el recurso de disco para el uso de la máquina virtual.
SupportedSecurityOption	Hace referencia a la capacidad de seguridad del disco admitido para crear un inicio seguro o una máquina virtual confidencial
systemData	Metadatos relativos a la creación y última modificación del recurso.

ApiError

Objeto

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de la API
innererror	InnerError	El error interno de la API
message	string	El mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Objeto

Base de errores de API.

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error concreto.

Architecture

Enumeración

Arquitectura de CPU compatible con un disco del sistema operativo.

Valor	Description
x64
Arm64

CloudError

Objeto

Una respuesta de error del servicio de proceso.

Nombre	Tipo	Description
error	ApiError	Error de API.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Objeto

Se utiliza para establecer el contexto de compra de cualquier artefacto de terceros a través de MarketPlace.

Nombre	Tipo	Description
name	string	Identificador del plan.
product	string	Especifica el producto de la imagen de Marketplace. Este es el mismo valor que Offer en el elemento imageReference.
promotionCode	string	El código de promoción de la oferta.
publisher	string	Identificador del publicador.

DiskRestorePoint

Objeto

Propiedades del punto de restauración del disco

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Ej: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso
properties.completionPercent	number (float)	Porcentaje completado para la copia en segundo plano del punto de restauración del disco cuando el recurso de origen es de una región diferente.
properties.diskAccessId	string	Identificador de ARM del recurso DiskAccess para usar puntos de conexión privados en discos.
properties.encryption	Encryption	La propiedad de cifrado se puede usar para cifrar los datos en reposo con claves administradas por el cliente o claves administradas por la plataforma.
properties.familyId	string	id de la familia MIS de la instantánea de respaldo
properties.hyperVGeneration	HyperVGeneration	Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.
properties.logicalSectorSize	integer (int32)	Tamaño del sector lógico en bytes para los puntos de restauración de disco de UltraSSD_LRS y PremiumV2_LRS discos. Los valores admitidos son 512 y 4096. 4096 es el valor predeterminado.
properties.networkAccessPolicy	NetworkAccessPolicy	Directiva para acceder al disco a través de la red.
properties.osType	OperatingSystemTypes	Tipo de sistema operativo.
properties.publicNetworkAccess	PublicNetworkAccess	Directiva para controlar la exportación en el disco.
properties.purchasePlan	DiskPurchasePlan	Información del plan de compra para la imagen desde la que se creó el disco del sistema operativo.
properties.replicationState	string	Estado de replicación del punto de restauración del disco cuando el recurso de origen es de una región diferente.
properties.securityProfile	DiskSecurityProfile	Contiene la información relacionada con la seguridad del recurso.
properties.sourceResourceId	string	ID de ARM del disco de origen o punto de restauración del disco de origen.
properties.sourceResourceLocation	string	Ubicación del disco de origen o punto de restauración del disco de origen cuando el recurso de origen es de una región diferente.
properties.sourceUniqueId	string	ID de encarnación único del disco de origen
properties.supportedCapabilities	SupportedCapabilities	Lista de funcionalidades admitidas para la imagen desde la que se creó el disco del sistema operativo.
properties.supportsHibernation	boolean	Indica que el sistema operativo de un disco admite la hibernación.
properties.timeCreated	string (date-time)	La marca de tiempo de la creación de restorePoint
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Objeto

Contiene la información relacionada con la seguridad del recurso.

Nombre	Tipo	Description
secureVMDiskEncryptionSetId	string	ResourceId del conjunto de cifrado de disco asociado al disco compatible con la máquina virtual confidencial cifrada con la clave administrada por el cliente
securityType	DiskSecurityTypes	Especifica securityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.

DiskSecurityTypes

Enumeración

Especifica securityType de la máquina virtual. Solo se aplica a los discos del sistema operativo.

Valor	Description
TrustedLaunch	Trusted Launch proporciona características de seguridad como arranque seguro y módulo de plataforma segura virtual (vTPM)
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Indica disco de máquina virtual confidencial con solo el estado de invitado de máquina virtual cifrado
ConfidentialVM_DiskEncryptedWithPlatformKey	Indica disco de máquina virtual confidencial con disco del sistema operativo y estado de invitado de máquina virtual cifrado con una clave administrada por la plataforma
ConfidentialVM_DiskEncryptedWithCustomerKey	Indica disco de máquina virtual confidencial con disco del sistema operativo y estado de invitado de máquina virtual cifrado con una clave administrada por el cliente
ConfidentialVM_NonPersistedTPM	Indica un disco de máquina virtual confidencial con un vTPM efímero. El estado de vTPM no se conserva en los reinicios de la máquina virtual.

Encryption

Objeto

Configuración de cifrado en reposo para disco o instantánea

Nombre	Tipo	Description
diskEncryptionSetId	string	ResourceId del conjunto de cifrado de disco que se va a usar para habilitar el cifrado en reposo.
type	EncryptionType	Tipo de clave que se usa para cifrar los datos del disco.

EncryptionType

Enumeración

Tipo de clave que se usa para cifrar los datos del disco.

Valor	Description
EncryptionAtRestWithPlatformKey	El disco se cifra en reposo con la clave administrada de la plataforma. Es el tipo de cifrado predeterminado. Este no es un tipo de cifrado válido para conjuntos de cifrado de disco.
EncryptionAtRestWithCustomerKey	El disco se cifra en reposo con una clave administrada por el cliente que un cliente puede cambiar y revocar.
EncryptionAtRestWithPlatformAndCustomerKeys	El disco se cifra en reposo con 2 capas de cifrado. Una de las claves es administrada por el cliente y la otra clave es administrada por la plataforma.

HyperVGeneration

Enumeración

Generación del hipervisor de la máquina virtual. Solo se aplica a los discos del sistema operativo.

Valor	Description
V1
V2

InnerError

Objeto

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	El mensaje de error interno o el volcado de excepción.
exceptiontype	string	El tipo de excepción.

NetworkAccessPolicy

Enumeración

Directiva para acceder al disco a través de la red.

Valor	Description
AllowAll	El disco se puede exportar o cargar desde cualquier red.
AllowPrivate	El disco se puede exportar o cargar mediante los puntos de conexión privados de un recurso de DiskAccess.
DenyAll	El disco no se puede exportar.

OperatingSystemTypes

Enumeración

Tipo de sistema operativo.

Valor	Description
Windows
Linux

PublicNetworkAccess

Enumeración

Directiva para controlar la exportación en el disco.

Valor	Description
Enabled	Puede generar un URI de SAS para tener acceso a los datos subyacentes del disco públicamente en Internet cuando NetworkAccessPolicy se establece en AllowAll. Puede acceder a los datos a través del URI de SAS solo desde la red virtual de Azure de confianza cuando NetworkAccessPolicy está establecido en AllowPrivate.
Disabled	No puede tener acceso a los datos subyacentes del disco públicamente en Internet, incluso cuando NetworkAccessPolicy está establecido en AllowAll. Puede acceder a los datos a través del URI de SAS solo desde la red virtual de Azure de confianza cuando NetworkAccessPolicy está establecido en AllowPrivate.

SupportedCapabilities

Objeto

Lista de funcionalidades admitidas que se conservan en el recurso de disco para el uso de la máquina virtual.

Nombre	Tipo	Description
acceleratedNetwork	boolean	True si la imagen desde la que se crea el disco del sistema operativo admite redes aceleradas.
architecture	Architecture	Arquitectura de CPU compatible con un disco del sistema operativo.
diskControllerTypes	string	Controladores de disco que admite un disco del sistema operativo. Si se establece, puede ser SCSI o SCSI, NVME o NVME, SCSI.
supportedSecurityOption	SupportedSecurityOption	Hace referencia a la capacidad de seguridad del disco admitido para crear un inicio seguro o una máquina virtual confidencial

SupportedSecurityOption

Enumeración

Hace referencia a la capacidad de seguridad del disco admitido para crear un inicio seguro o una máquina virtual confidencial

Valor	Description
TrustedLaunchSupported	El disco admite la creación de máquinas virtuales de inicio seguro.
TrustedLaunchAndConfidentialVMSupported	El disco admite la creación de máquinas virtuales confidenciales y de inicio seguro.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Disk Restore Point - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

get an incremental disk restorePoint resource.

Solicitud de ejemplo

Respuesta de muestra

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

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ApiError

ApiErrorBase

Architecture

CloudError

createdByType

DiskPurchasePlan

DiskRestorePoint

DiskSecurityProfile

DiskSecurityTypes

Encryption

EncryptionType

HyperVGeneration

InnerError

NetworkAccessPolicy

OperatingSystemTypes

PublicNetworkAccess

SupportedCapabilities

SupportedSecurityOption

systemData