Disk Restore Point - Get

Serviço:: Compute

Versão da API:: 2025-01-02

Obter recurso de restauração 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 do URI

Name	Em	Necessário	Tipo	Description
diskRestorePointName	path	True	string	O nome do DiskRestorePoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
restorePointCollectionName	path	True	string	O nome da coleção de pontos de restauração à qual pertence o ponto de restauração do disco.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
vmRestorePointName	path	True	string	O nome do ponto de restauração vm ao qual pertence o ponto de restauração do disco de disco.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	DiskRestorePoint	Operação do Azure concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

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.

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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
  }
}

Definições

Name	Description
ApiError	Erro de api.
ApiErrorBase	Base de erro da api.
Architecture	Arquitetura de CPU suportada por um disco do sistema operacional.
CloudError	Uma resposta de erro do serviço de computação.
createdByType	O tipo de identidade que criou o recurso.
DiskPurchasePlan	Usado para estabelecer o contexto de compra de qualquer artefato de 3ª Parte através do MarketPlace.
DiskRestorePoint	Propriedades do ponto de restauração do disco
DiskSecurityProfile	Contém as informações relacionadas à segurança do recurso.
DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável apenas a discos do SO.
Encryption	Configurações de criptografia em repouso para disco ou instantâneo
EncryptionType	O tipo de chave usada para criptografar os dados do disco.
HyperVGeneration	A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.
InnerError	Detalhes do erro interno.
NetworkAccessPolicy	Política para aceder ao disco através da rede.
OperatingSystemTypes	O tipo de sistema operacional.
PublicNetworkAccess	Política para controlar a exportação no disco.
SupportedCapabilities	Lista de recursos suportados persistiu no recurso de disco para uso da VM.
SupportedSecurityOption	Refere-se ao recurso de segurança do disco suportado para criar uma inicialização confiável ou VM confidencial
systemData	Metadados referentes à criação e última modificação do recurso.

ApiError

Object

Erro de api.

Name	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro Api
innererror	InnerError	O erro interno da Api
message	string	A mensagem de erro.
target	string	O alvo do erro específico.

ApiErrorBase

Object

Base de erro da api.

Name	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O alvo do erro específico.

Architecture

Enumeração

Arquitetura de CPU suportada por um disco do sistema operacional.

Valor	Description
x64
Arm64

CloudError

Object

Uma resposta de erro do serviço de computação.

Name	Tipo	Description
error	ApiError	Erro de api.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Object

Usado para estabelecer o contexto de compra de qualquer artefato de 3ª Parte através do MarketPlace.

Name	Tipo	Description
name	string	O ID do plano.
product	string	Especifica o produto da imagem do mercado. Este é o mesmo valor que Offer sob o elemento imageReference.
promotionCode	string	O código promocional da oferta.
publisher	string	O ID do editor.

DiskRestorePoint

Object

Propriedades do ponto de restauração do disco

Name	Tipo	Description
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.completionPercent	number (float)	Porcentagem concluída para a cópia em segundo plano do ponto de restauração do disco quando o recurso de origem é de uma região diferente.
properties.diskAccessId	string	ID ARM do recurso DiskAccess para usar pontos de extremidade privados em discos.
properties.encryption	Encryption	A propriedade de criptografia pode ser usada para criptografar dados em repouso com chaves gerenciadas pelo cliente ou chaves gerenciadas pela plataforma.
properties.familyId	string	id da família MIS do instantâneo de suporte
properties.hyperVGeneration	HyperVGeneration	A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.
properties.logicalSectorSize	integer (int32)	Tamanho do setor lógico em bytes para pontos de restauração de disco de UltraSSD_LRS e PremiumV2_LRS discos. Os valores suportados são 512 e 4096. 4096 é o padrão.
properties.networkAccessPolicy	NetworkAccessPolicy	Política para aceder ao disco através da rede.
properties.osType	OperatingSystemTypes	O tipo de sistema operacional.
properties.publicNetworkAccess	PublicNetworkAccess	Política para controlar a exportação no disco.
properties.purchasePlan	DiskPurchasePlan	Informações do plano de compra para a imagem a partir da qual o disco do SO foi criado.
properties.replicationState	string	Estado de replicação do ponto de restauração do disco quando o recurso de origem é de uma região diferente.
properties.securityProfile	DiskSecurityProfile	Contém as informações relacionadas à segurança do recurso.
properties.sourceResourceId	string	ID do ARM do disco de origem ou do ponto de restauração do disco de origem.
properties.sourceResourceLocation	string	Localização do disco de origem ou do ponto de restauração do disco de origem quando o recurso de origem é de uma região diferente.
properties.sourceUniqueId	string	ID de encarnação exclusiva do disco de origem
properties.supportedCapabilities	SupportedCapabilities	Lista de recursos suportados para a imagem a partir da qual o disco do sistema operacional foi criado.
properties.supportsHibernation	boolean	Indica que o SO num disco suporta a hibernação.
properties.timeCreated	string (date-time)	O carimbo de data/hora da criação do restorePoint
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Object

Contém as informações relacionadas à segurança do recurso.

Name	Tipo	Description
secureVMDiskEncryptionSetId	string	ResourceId do conjunto de criptografia de disco associado ao disco suportado por VM confidencial criptografado com chave gerenciada pelo cliente
securityType	DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável apenas a discos do SO.

DiskSecurityTypes

Enumeração

Especifica o SecurityType da VM. Aplicável apenas a discos do SO.

Valor	Description
TrustedLaunch	O Trusted Launch fornece recursos de segurança, como inicialização segura e vTPM (Trusted Platform Module) virtual
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Indica disco confidencial da VM com apenas o estado do convidado da VM criptografado
ConfidentialVM_DiskEncryptedWithPlatformKey	Indica o disco confidencial da VM com o disco do sistema operacional e o estado do convidado da VM criptografados com uma chave gerenciada pela plataforma
ConfidentialVM_DiskEncryptedWithCustomerKey	Indica o disco confidencial da VM com o disco do SO e o estado do convidado da VM encriptados com uma chave gerida pelo cliente
ConfidentialVM_NonPersistedTPM	Indica disco VM confidencial com um vTPM efêmero. O estado vTPM não é persistido nas reinicializações da VM.

Encryption

Object

Configurações de criptografia em repouso para disco ou instantâneo

Name	Tipo	Description
diskEncryptionSetId	string	ResourceId do conjunto de criptografia de disco a ser usado para habilitar a criptografia em repouso.
type	EncryptionType	O tipo de chave usada para criptografar os dados do disco.

EncryptionType

Enumeração

O tipo de chave usada para criptografar os dados do disco.

Valor	Description
EncryptionAtRestWithPlatformKey	O disco é criptografado em repouso com a chave gerenciada da plataforma. É o tipo de criptografia padrão. Este não é um tipo de encriptação válido para conjuntos de encriptação de disco.
EncryptionAtRestWithCustomerKey	O disco é criptografado em repouso com a chave gerenciada pelo cliente que pode ser alterada e revogada por um cliente.
EncryptionAtRestWithPlatformAndCustomerKeys	O disco é encriptado em repouso com 2 camadas de encriptação. Uma das chaves é gerida pelo Cliente e a outra chave é gerida pela Plataforma.

HyperVGeneration

Enumeração

A geração do hipervisor da máquina virtual. Aplicável apenas a discos do SO.

Valor	Description
V1
V2

InnerError

Object

Detalhes do erro interno.

Name	Tipo	Description
errordetail	string	A mensagem de erro interna ou despejo de exceção.
exceptiontype	string	O tipo de exceção.

NetworkAccessPolicy

Enumeração

Política para aceder ao disco através da rede.

Valor	Description
AllowAll	O disco pode ser exportado ou carregado a partir de qualquer rede.
AllowPrivate	O disco pode ser exportado ou carregado usando os pontos de extremidade privados de um recurso do DiskAccess.
DenyAll	O disco não pode ser exportado.

OperatingSystemTypes

Enumeração

O tipo de sistema operacional.

Valor	Description
Windows
Linux

PublicNetworkAccess

Enumeração

Política para controlar a exportação no disco.

Valor	Description
Enabled	Você pode gerar um URI SAS para acessar os dados subjacentes do disco publicamente na Internet quando NetworkAccessPolicy estiver definido como AllowAll. Você pode acessar os dados por meio do URI SAS somente de sua VNET confiável do Azure quando NetworkAccessPolicy estiver definido como AllowPrivate.
Disabled	Não é possível acessar os dados subjacentes do disco publicamente na Internet, mesmo quando NetworkAccessPolicy está definido como AllowAll. Você pode acessar os dados por meio do URI SAS somente de sua VNET confiável do Azure quando NetworkAccessPolicy estiver definido como AllowPrivate.

SupportedCapabilities

Object

Lista de recursos suportados persistiu no recurso de disco para uso da VM.

Name	Tipo	Description
acceleratedNetwork	boolean	True se a imagem a partir da qual o disco do SO é criado suportar redes aceleradas.
architecture	Architecture	Arquitetura de CPU suportada por um disco do sistema operacional.
diskControllerTypes	string	Os controladores de disco suportados por um disco do SO. Se definido, pode ser SCSI ou SCSI, NVME ou NVME, SCSI.
supportedSecurityOption	SupportedSecurityOption	Refere-se ao recurso de segurança do disco suportado para criar uma inicialização confiável ou VM confidencial

SupportedSecurityOption

Enumeração

Refere-se ao recurso de segurança do disco suportado para criar uma inicialização confiável ou VM confidencial

Valor	Description
TrustedLaunchSupported	O disco suporta a criação de VMs de Inicialização Confiável.
TrustedLaunchAndConfidentialVMSupported	O disco suporta a criação de VMs Confiáveis e Confidenciais.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

Disk Restore Point - Get

Parâmetros do URI

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

get an incremental disk restorePoint resource.

Pedido de amostra

Resposta da amostra

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

Pedido de amostra

Resposta da amostra

Definições

ApiError

ApiErrorBase

Architecture

CloudError

createdByType

DiskPurchasePlan

DiskRestorePoint

DiskSecurityProfile

DiskSecurityTypes

Encryption

EncryptionType

HyperVGeneration

InnerError

NetworkAccessPolicy

OperatingSystemTypes

PublicNetworkAccess

SupportedCapabilities

SupportedSecurityOption

systemData