Disk Restore Point - Get

Serviço:: Compute

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

Obter recurso de ponto 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 de URI

Nome	Em	Obrigató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 o ponto de restauração de disco pertence.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
vmRestorePointName	path	True	string	O nome do ponto de restauração da vm ao qual o ponto de restauração do disco pertence.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

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.

Solicitação de exemplo

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 de exemplo

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

Solicitação de exemplo

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 de exemplo

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

Nome	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros da API.
Architecture	Arquitetura de CPU compatível com um disco do sistema operacional.
CloudError	Uma resposta de erro do serviço Compute.
createdByType	O tipo de identidade que criou o recurso.
DiskPurchasePlan	Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.
DiskRestorePoint	Propriedades do ponto de restauração de disco
DiskSecurityProfile	Contém as informações relacionadas à segurança do recurso.
DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.
Encryption	Configurações de criptografia em repouso para disco ou instantâneo
EncryptionType	O tipo de chave usado para criptografar os dados do disco.
HyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.
InnerError	Detalhes do erro interno.
NetworkAccessPolicy	Política para acessar o disco por meio da rede.
OperatingSystemTypes	O tipo de sistema operacional.
PublicNetworkAccess	Política para controlar a exportação no disco.
SupportedCapabilities	Lista de recursos com suporte persistidos no recurso de disco para uso da VM.
SupportedSecurityOption	Refere-se à capacidade de segurança do disco com suporte para criar uma inicialização confiável ou uma VM confidencial
systemData	Metadados relativos à criação e última modificação do recurso.

ApiError

Objeto

Erro de API.

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

ApiErrorBase

Objeto

Base de erros da API.

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

Architecture

Enumeração

Arquitetura de CPU compatível com um disco do sistema operacional.

Valor	Description
x64
Arm64

CloudError

Objeto

Uma resposta de erro do serviço Compute.

Nome	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

Objeto

Usado para estabelecer o contexto de compra de qualquer artefato de terceiros por meio do MarketPlace.

Nome	Tipo	Description
name	string	A ID do plano.
product	string	Especifica o produto da imagem do marketplace. Esse é o mesmo valor que Offer no elemento imageReference.
promotionCode	string	O código de promoção da oferta.
publisher	string	A ID do editor.

DiskRestorePoint

Objeto

Propriedades do ponto de restauração de disco

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada 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 do 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 snapshot de backup
properties.hyperVGeneration	HyperVGeneration	A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.
properties.logicalSectorSize	integer (int32)	Tamanho do setor lógico em bytes para pontos de restauração de disco de discos UltraSSD_LRS e PremiumV2_LRS discos. Os valores com suporte são 512 e 4096. 4096 é o padrão.
properties.networkAccessPolicy	NetworkAccessPolicy	Política para acessar o disco por meio 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 da qual o disco do sistema operacional 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	Local 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 exclusivo do disco de origem
properties.supportedCapabilities	SupportedCapabilities	Lista de recursos com suporte para a imagem da qual o disco do sistema operacional foi criado.
properties.supportsHibernation	boolean	Indica que o sistema operacional em um disco dá suporte à hibernação.
properties.timeCreated	string (date-time)	O carimbo de data/hora da criação de restorePoint
systemData	systemData	Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Objeto

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

Nome	Tipo	Description
secureVMDiskEncryptionSetId	string	ResourceId do conjunto de criptografia de disco associado ao disco com suporte de VM confidencial criptografado com chave gerenciada pelo cliente
securityType	DiskSecurityTypes	Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

DiskSecurityTypes

Enumeração

Especifica o SecurityType da VM. Aplicável somente para discos do sistema operacional.

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 de VM confidencial com apenas o estado de convidado da VM criptografado
ConfidentialVM_DiskEncryptedWithPlatformKey	Indica disco de VM confidencial com disco do sistema operacional e estado de convidado da VM criptografados com uma chave gerenciada pela plataforma
ConfidentialVM_DiskEncryptedWithCustomerKey	Indica disco de VM confidencial com disco do sistema operacional e estado de convidado da VM criptografados com uma chave gerenciada pelo cliente
ConfidentialVM_NonPersistedTPM	Indica o disco de VM confidencial com um vTPM efêmero. O estado do vTPM não é mantido nas reinicializações da VM.

Encryption

Objeto

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

Nome	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 usado para criptografar os dados do disco.

EncryptionType

Enumeração

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

Valor	Description
EncryptionAtRestWithPlatformKey	O disco é criptografado em repouso com a chave gerenciada pela plataforma. É o tipo de criptografia padrão. Esse não é um tipo de criptografia válido para conjuntos de criptografia 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 é criptografado em repouso com 2 camadas de criptografia. Uma das chaves é gerenciada pelo cliente e a outra é gerenciada pela plataforma.

HyperVGeneration

Enumeração

A geração do hipervisor da Máquina Virtual. Aplicável somente a discos do sistema operacional.

Valor	Description
V1
V2

InnerError

Objeto

Detalhes do erro interno.

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

NetworkAccessPolicy

Enumeração

Política para acessar o disco por meio da rede.

Valor	Description
AllowAll	O disco pode ser exportado ou carregado 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	Você não pode 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

Objeto

Lista de recursos com suporte persistidos no recurso de disco para uso da VM.

Nome	Tipo	Description
acceleratedNetwork	boolean	True se a imagem da qual o disco do sistema operacional é criado dá suporte à rede acelerada.
architecture	Architecture	Arquitetura de CPU compatível com um disco do sistema operacional.
diskControllerTypes	string	Os controladores de disco compatíveis com um disco do sistema operacional. Se ele puder ser SCSI ou SCSI, NVME ou NVME, SCSI.
supportedSecurityOption	SupportedSecurityOption	Refere-se à capacidade de segurança do disco com suporte para criar uma inicialização confiável ou uma VM confidencial

SupportedSecurityOption

Enumeração

Refere-se à capacidade de segurança do disco com suporte para criar uma inicialização confiável ou uma VM confidencial

Valor	Description
TrustedLaunchSupported	O disco dá suporte à criação de VMs de Inicialização Confiável.
TrustedLaunchAndConfidentialVMSupported	O disco dá suporte à criação de VMs de Início Confiável e Confidenciais.

systemData

Objeto

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

Nome	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.

Compartilhar via

Disk Restore Point - Get

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

get an incremental disk restorePoint resource.

Solicitação de exemplo

Resposta de exemplo

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

Solicitação de exemplo

Resposta de exemplo

Definições

ApiError

ApiErrorBase

Architecture

CloudError

createdByType

DiskPurchasePlan

DiskRestorePoint

DiskSecurityProfile

DiskSecurityTypes

Encryption

EncryptionType

HyperVGeneration

InnerError

NetworkAccessPolicy

OperatingSystemTypes

PublicNetworkAccess

SupportedCapabilities

SupportedSecurityOption

systemData