Partilhar via

Recovery Points - Get

  • Referência
Serviço:
Recovery Services - Backup
Versão da API:
2024-10-01

Fornece as informações dos dados de backup identificados usando RecoveryPointID. Esta é uma operação assíncrona. Para saber o status da operação, chame a 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

Parâmetros do URI

Name Em Necessário Tipo Description
containerName
 path True

string

Nome do contêiner associado ao item de backup.
fabricName
 path True

string

Nome da malha associado ao item de backup.
protectedItemName
 path True

string

Nome do item de backup cujos dados de backup precisam ser buscados.
recoveryPointId
 path True

string

RecoveryPointID representa os dados de backup a serem buscados.
resourceGroupName
 path True

string

O nome do grupo de recursos onde o cofre de serviços de recuperação está presente.
subscriptionId
 path True

string

O ID da subscrição.
vaultName
 path True

string

O nome do cofre dos serviços de recuperação.
api-version
 query True

string

Versão da API do cliente.

Respostas

Name Tipo Description
200 OK

RecoveryPointResource

OK
Other Status Codes

CloudError

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name Description
user_impersonation Personifique a sua conta de utilizador.

Exemplos

Get Azure Vm Recovery Point Details

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
AzureFileShareRecoveryPoint

Cópia de backup específica da carga de trabalho do Compartilhamento de Arquivos do Azure.
AzureWorkloadPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime
AzureWorkloadRecoveryPoint

Ponto de recuperação específico da carga de trabalho, encapsulando especificamente o ponto de recuperação completo/diferencial
AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime no SAPHana
AzureWorkloadSAPHanaRecoveryPoint

Ponto de recuperação específico do SAPHana, encapsula especificamente pontos de recuperação completos/diff
AzureWorkloadSQLPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime
AzureWorkloadSQLRecoveryPoint

Ponto de recuperação específico do SQL, encapsula especificamente o ponto de recuperação completo/diff junto com informações estendidas
AzureWorkloadSQLRecoveryPointExtendedInfo

Detalhes estendidos da classe de informações
BEKDetails

BEK é a chave de criptografia bitlocker.
CloudError

Uma resposta de erro do serviço de Instância de Contêiner.
CloudErrorBody

Uma resposta de erro do serviço de Instância de Contêiner.
DiskInformation

Informações do disco
ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.
ExtendedLocation

O local estendido do ponto de recuperação onde a VM estava presente.
GenericRecoveryPoint

Cópia de backup genérica.
IaasVMRecoveryPoint

Cópia de backup específica da carga de trabalho da VM IaaS.
KEKDetails

KEK é a chave de criptografia para BEK.
KeyAndSecretDetails

BEK é a chave bitlocker. KEK é a chave de criptografia para BEK Se a VM foi criptografada, armazenaremos os seguintes detalhes:

  1. Secret(BEK) - url + dados de backup + vaultId.
  2. Key(KEK) - url + dados de backup + vaultId.
  3. EncryptionMechanism BEK e KEK podem potencialmente ter IDs de cofre diferentes.
PointInTimeRange

Fornece detalhes para intervalos de log
RecoveryPointDiskConfiguration

Configuração do disco
RecoveryPointMoveReadinessInfo
RecoveryPointProperties

Propriedades do ponto de recuperação
RecoveryPointResource

Classe base para cópias de backup. As cópias de backup específicas da carga de trabalho são derivadas dessa classe.
RecoveryPointTierInformationV2

Informações da camada do RecoveryPoint V2
RecoveryPointTierStatus

Status da camada de ponto de recuperação.
RecoveryPointTierType

Tipo de camada de ponto de recuperação.
RestorePointType

Tipo de ponto de restauro
SQLDataDirectory

Informações do SQLDataDirectory
SQLDataDirectoryType

Tipo de mapeamento de diretório de dados

AzureFileShareRecoveryPoint

Cópia de backup específica da carga de trabalho do Compartilhamento de Arquivos do Azure.

Name Tipo Description
fileShareSnapshotUri

string

Contém Url para o instantâneo do compartilhamento de arquivos, se aplicável
objectType string:

AzureFileShareRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointSizeInGB

integer

Contém o tamanho do ponto de recuperação
recoveryPointTime

string

Hora em que esta cópia de backup foi criada.
recoveryPointType

string

Tipo de cópia de backup. Especifica se é um backup consistente com falhas ou um aplicativo consistente.

AzureWorkloadPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime

Name Tipo Description
objectType string:

AzureWorkloadPointInTimeRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTimeInUTC

string

Hora UTC em que o ponto de recuperação foi criado
timeRanges

PointInTimeRange[]

Lista de intervalos de log
type

RestorePointType

Tipo de ponto de restauro

AzureWorkloadRecoveryPoint

Ponto de recuperação específico da carga de trabalho, encapsulando especificamente o ponto de recuperação completo/diferencial

Name Tipo Description
objectType string:

AzureWorkloadRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTimeInUTC

string

Hora UTC em que o ponto de recuperação foi criado
type

RestorePointType

Tipo de ponto de restauro

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime no SAPHana

Name Tipo Description
objectType string:

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTimeInUTC

string

Hora UTC em que o ponto de recuperação foi criado
timeRanges

PointInTimeRange[]

Lista de intervalos de log
type

RestorePointType

Tipo de ponto de restauro

AzureWorkloadSAPHanaRecoveryPoint

Ponto de recuperação específico do SAPHana, encapsula especificamente pontos de recuperação completos/diff

Name Tipo Description
objectType string:

AzureWorkloadSAPHanaRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTimeInUTC

string

Hora UTC em que o ponto de recuperação foi criado
type

RestorePointType

Tipo de ponto de restauro

AzureWorkloadSQLPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime

Name Tipo Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Informações estendidas que fornecem detalhes do diretório de dados. Será preenchido em dois casos: Quando um ponto de recuperação específico é acessado usando GetRecoveryPoint Ou quando ListRecoveryPoints é chamado para Log RP somente com filtro de consulta ExtendedInfo
objectType string:

AzureWorkloadSQLPointInTimeRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTimeInUTC

string

Hora UTC em que o ponto de recuperação foi criado
timeRanges

PointInTimeRange[]

Lista de intervalos de log
type

RestorePointType

Tipo de ponto de restauro

AzureWorkloadSQLRecoveryPoint

Ponto de recuperação específico do SQL, encapsula especificamente o ponto de recuperação completo/diff junto com informações estendidas

Name Tipo Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Informações estendidas que fornecem detalhes do diretório de dados. Será preenchido em dois casos: Quando um ponto de recuperação específico é acessado usando GetRecoveryPoint Ou quando ListRecoveryPoints é chamado para Log RP somente com filtro de consulta ExtendedInfo
objectType string:

AzureWorkloadSQLRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTimeInUTC

string

Hora UTC em que o ponto de recuperação foi criado
type

RestorePointType

Tipo de ponto de restauro

AzureWorkloadSQLRecoveryPointExtendedInfo

Detalhes estendidos da classe de informações

Name Tipo Description
dataDirectoryPaths

SQLDataDirectory[]

Lista de caminhos de diretório de dados durante a operação de restauração.
dataDirectoryTimeInUTC

string

Hora UTC em que as informações do diretório de dados foram capturadas

BEKDetails

BEK é a chave de criptografia bitlocker.

Name Tipo Description
secretData

string

Dados BEK.
secretUrl

string

O segredo é BEK.
secretVaultId

string

ID do Cofre da Chave onde este Segredo está armazenado.

CloudError

Uma resposta de erro do serviço de Instância de Contêiner.

Name Tipo Description
error

CloudErrorBody

O objeto de erro.

CloudErrorBody

Uma resposta de erro do serviço de Instância de Contêiner.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.
message

string

Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
target

string

O alvo do erro específico. Por exemplo, o nome da propriedade em erro.

DiskInformation

Informações do disco

Name Tipo Description
lun

integer

name

string

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ExtendedLocation

O local estendido do ponto de recuperação onde a VM estava presente.

Name Tipo Description
name

string

Nome do local estendido.
type

string

Tipo de local estendido. Os valores possíveis incluem: 'EdgeZone'

GenericRecoveryPoint

Cópia de backup genérica.

Name Tipo Description
friendlyName

string

Nome amigável da cópia de backup.
objectType string:

GenericRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointAdditionalInfo

string

Informações adicionais associadas a esta cópia de backup.
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTime

string

Hora em que esta cópia de backup foi criada.
recoveryPointType

string

Tipo de cópia de backup.

IaasVMRecoveryPoint

Cópia de backup específica da carga de trabalho da VM IaaS.

Name Tipo Description
extendedLocation

ExtendedLocation

O local estendido do ponto de recuperação da VM deve ser nulo se a VM estiver na nuvem pública
isInstantIlrSessionActive

boolean

A sessão para recuperar itens desta cópia de backup ainda está ativa.
isManagedVirtualMachine

boolean

Se a VM está com discos gerenciados
isPrivateAccessEnabledOnAnyDisk

boolean

Esse sinalizador indica se algum dos discos na VM está usando a configuração de rede de acesso privado
isSourceVMEncrypted

boolean

Identifica se a VM foi criptografada quando a cópia de backup é criada.
keyAndSecret

KeyAndSecretDetails

Detalhes necessários para recuperar uma VM criptografada. Aplicável somente quando IsSourceVMEncrypted é true.
objectType string:

IaasVMRecoveryPoint

Esta propriedade será usada como o discriminador para decidir os tipos específicos na cadeia polimórfica de tipos.
originalStorageAccountOption

boolean

Opção de conta de armazenamento original
osType

string

Tipo de SO
recoveryPointAdditionalInfo

string

Informações adicionais associadas a esta cópia de backup.
recoveryPointDiskConfiguration

RecoveryPointDiskConfiguration

Configuração do disco
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Elegibilidade do PR para ser transferido para outro nível
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

Informações da camada de ponto de recuperação.
recoveryPointTime

string

Hora em que esta cópia de backup foi criada.
recoveryPointType

string

Tipo de cópia de backup.
securityType

string

Tipo de segurança do disco
sourceVMStorageType

string

Tipo de armazenamento da VM cuja cópia de backup é criada.
virtualMachineSize

string

Tamanho da máquina virtual
zones

string[]

Identifica a zona da VM no momento do backup. Aplicável apenas para Vms fixadas por zona

KEKDetails

KEK é a chave de criptografia para BEK.

Name Tipo Description
keyBackupData

string

Dados KEK.
keyUrl

string

A chave é KEK.
keyVaultId

string

ID do Cofre da Chave onde esta chave está armazenada.

KeyAndSecretDetails

BEK é a chave bitlocker. KEK é a chave de criptografia para BEK Se a VM foi criptografada, armazenaremos os seguintes detalhes:

  1. Secret(BEK) - url + dados de backup + vaultId.
  2. Key(KEK) - url + dados de backup + vaultId.
  3. EncryptionMechanism BEK e KEK podem potencialmente ter IDs de cofre diferentes.
Name Tipo Description
bekDetails

BEKDetails

BEK é a chave de criptografia bitlocker.
encryptionMechanism

string

Mecanismo de criptografia: Nenhum / SinglePass / DoublePass
kekDetails

KEKDetails

KEK é a chave de criptografia para BEK.

PointInTimeRange

Fornece detalhes para intervalos de log

Name Tipo Description
endTime

string

Hora de término do intervalo de tempo para recuperação de log.
startTime

string

Hora de início do intervalo de tempo para recuperação de log.

RecoveryPointDiskConfiguration

Configuração do disco

Name Tipo Description
excludedDiskList

DiskInformation[]

Informações de discos excluídos do backup
includedDiskList

DiskInformation[]

Informações de discos incluídos no backup
numberOfDisksAttachedToVm

integer

Número de discos conectados à VM
numberOfDisksIncludedInBackup

integer

Número de discos incluídos no backup

RecoveryPointMoveReadinessInfo

Name Tipo Description
additionalInfo

string

isReadyForMove

boolean

RecoveryPointProperties

Propriedades do ponto de recuperação

Name Tipo Description
expiryTime

string

Tempo de expiração do Ponto de Recuperação em UTC.
isSoftDeleted

boolean

Bool para indicar se o RP está no estado de exclusão suave ou não
ruleName

string

Nome da regra marcado no Ponto de Recuperação que rege o ciclo de vida

RecoveryPointResource

Classe base para cópias de backup. As cópias de backup específicas da carga de trabalho são derivadas dessa classe.

Name Tipo Description
eTag

string

ETag opcional.
id

string

Resource Id representa o caminho completo para o recurso.
location

string

Localização do recurso.
name

string

Nome do recurso associado ao recurso.
properties RecoveryPoint:

Propriedades RecoveryPointResource
tags

object

Tags de recursos.
type

string

Tipo de recurso representa o caminho completo do formulário Namespace/ResourceType/ResourceType/...

RecoveryPointTierInformationV2

Informações da camada do RecoveryPoint V2

Name Tipo Description
extendedInfo

object

Status da camada de ponto de recuperação.
status

RecoveryPointTierStatus

Status da camada de ponto de recuperação.
type

RecoveryPointTierType

Tipo de camada de ponto de recuperação.

RecoveryPointTierStatus

Status da camada de ponto de recuperação.

Name Tipo Description
Deleted

string

Disabled

string

Invalid

string

Rehydrated

string

Valid

string

RecoveryPointTierType

Tipo de camada de ponto de recuperação.

Name Tipo Description
ArchivedRP

string

HardenedRP

string

InstantRP

string

Invalid

string

RestorePointType

Tipo de ponto de restauro

Name Tipo Description
Differential

string

Full

string

Incremental

string

Invalid

string

Log

string

SnapshotCopyOnlyFull

string

SnapshotFull

string

SQLDataDirectory

Informações do SQLDataDirectory

Name Tipo Description
logicalName

string

Nome lógico do ficheiro
path

string

Caminho do arquivo
type

SQLDataDirectoryType

Tipo de mapeamento de diretório de dados

SQLDataDirectoryType

Tipo de mapeamento de diretório de dados

Name Tipo Description
Data

string

Invalid

string

Log

string