Compartilhar 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 de URI

Nome Em Obrigató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 em que o cofre dos serviços de recuperação está presente.
subscriptionId
 path True

string

A ID da assinatura.
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

Nome Tipo Description
200 OK

RecoveryPointResource

OKEY
Other Status Codes

CloudError

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

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 represente sua conta de usuário.

Exemplos

Get Azure Vm Recovery Point Details

Solicitação de exemplo

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

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

Nome 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

O ponto de recuperação específico da carga de trabalho encapsula especificamente o ponto de recuperação full/diff
AzureWorkloadSAPHanaPointInTimeRecoveryPoint

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

O ponto de recuperação específico do SAPHana encapsula especificamente pontos de recuperação full/diff
AzureWorkloadSQLPointInTimeRecoveryPoint

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

O ponto de recuperação específico do SQL encapsula especificamente o ponto de recuperação full/diff, juntamente com informações estendidas
AzureWorkloadSQLRecoveryPointExtendedInfo

Detalhes da classe de informações estendidas
BEKDetails

BEK é a chave de criptografia do bitlocker.
CloudError

Uma resposta de erro do serviço instância de contêiner.
CloudErrorBody

Uma resposta de erro do serviço instância de contêiner.
DiskInformation

Informações de disco
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ExtendedLocation

O local estendido do ponto de recuperação em que 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 do bitlocker. KEK é 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 ter IDs de cofre diferentes.
PointInTimeRange

Fornece detalhes para intervalos de logs
RecoveryPointDiskConfiguration

Configuração de disco
RecoveryPointMoveReadinessInfo
RecoveryPointProperties

Propriedades do ponto de recuperação
RecoveryPointResource

Classe base para cópias de backup. 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 restauração
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.

Nome Tipo Description
fileShareSnapshotUri

string

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

AzureFileShareRecoveryPoint

Essa propriedade será usada como discriminatória 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 essa cópia de backup foi criada.
recoveryPointType

string

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

AzureWorkloadPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime

Nome Tipo Description
objectType string:

AzureWorkloadPointInTimeRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
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 logs
type

RestorePointType

Tipo de ponto de restauração

AzureWorkloadRecoveryPoint

O ponto de recuperação específico da carga de trabalho encapsula especificamente o ponto de recuperação full/diff

Nome Tipo Description
objectType string:

AzureWorkloadRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
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 restauração

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

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

Nome Tipo Description
objectType string:

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
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 logs
type

RestorePointType

Tipo de ponto de restauração

AzureWorkloadSAPHanaRecoveryPoint

O ponto de recuperação específico do SAPHana encapsula especificamente pontos de recuperação full/diff

Nome Tipo Description
objectType string:

AzureWorkloadSAPHanaRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
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 restauração

AzureWorkloadSQLPointInTimeRecoveryPoint

Ponto de recuperação específico para PointInTime

Nome Tipo Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Informações Estendidas que fornecem detalhes do diretório de dados. Será populado em dois casos: quando um ponto de recuperação específico for acessado usando GetRecoveryPoint ou quando ListRecoveryPoints for chamado para RP de log somente com filtro de consulta ExtendedInfo
objectType string:

AzureWorkloadSQLPointInTimeRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
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 logs
type

RestorePointType

Tipo de ponto de restauração

AzureWorkloadSQLRecoveryPoint

O ponto de recuperação específico do SQL encapsula especificamente o ponto de recuperação full/diff, juntamente com informações estendidas

Nome Tipo Description
extendedInfo

AzureWorkloadSQLRecoveryPointExtendedInfo

Informações Estendidas que fornecem detalhes do diretório de dados. Será populado em dois casos: quando um ponto de recuperação específico for acessado usando GetRecoveryPoint ou quando ListRecoveryPoints for chamado para RP de log somente com filtro de consulta ExtendedInfo
objectType string:

AzureWorkloadSQLRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
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 restauração

AzureWorkloadSQLRecoveryPointExtendedInfo

Detalhes da classe de informações estendidas

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

Nome Tipo Description
secretData

string

Dados BEK.
secretUrl

string

O segredo é BEK.
secretVaultId

string

ID do Key Vault em que esse segredo é armazenado.

CloudError

Uma resposta de erro do serviço instância de contêiner.

Nome Tipo Description
error

CloudErrorBody

O objeto de erro.

CloudErrorBody

Uma resposta de erro do serviço instância de contêiner.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.
message

string

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

string

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

DiskInformation

Informações de disco

Nome Tipo Description
lun

integer

name

string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome 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 em que a VM estava presente.

Nome Tipo Description
name

string

Nome do local estendido.
type

string

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

GenericRecoveryPoint

Cópia de backup genérica.

Nome Tipo Description
friendlyName

string

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

GenericRecoveryPoint

Essa propriedade será usada como discriminatória para decidir os tipos específicos na cadeia polimórfica de tipos.
recoveryPointAdditionalInfo

string

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

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTime

string

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

string

Tipo da cópia de backup.

IaasVMRecoveryPoint

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

Nome Tipo Description
extendedLocation

ExtendedLocation

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

boolean

É a sessão para recuperar itens dessa cópia de backup ainda 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 for true.
objectType string:

IaasVMRecoveryPoint

Essa propriedade será usada como discriminatória 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 sistema operacional
recoveryPointAdditionalInfo

string

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

RecoveryPointDiskConfiguration

Configuração de disco
recoveryPointMoveReadinessInfo

<string,  RecoveryPointMoveReadinessInfo>

Qualificação de RP a ser movida para outra camada
recoveryPointProperties

RecoveryPointProperties

Propriedades do ponto de recuperação
recoveryPointTierDetails

RecoveryPointTierInformationV2[]

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

string

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

string

Tipo da 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 somente para VMs fixadas por zona

KEKDetails

KEK é a chave de criptografia para BEK.

Nome Tipo Description
keyBackupData

string

Dados KEK.
keyUrl

string

A chave é KEK.
keyVaultId

string

ID do Key Vault em que essa chave é armazenada.

KeyAndSecretDetails

BEK é a chave do bitlocker. KEK é 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 ter IDs de cofre diferentes.
Nome Tipo Description
bekDetails

BEKDetails

BEK é a chave de criptografia do bitlocker.
encryptionMechanism

string

Mecanismo de criptografia: None/ SinglePass/ DoublePass
kekDetails

KEKDetails

KEK é a chave de criptografia para BEK.

PointInTimeRange

Fornece detalhes para intervalos de logs

Nome 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 de disco

Nome 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 anexados à VM
numberOfDisksIncludedInBackup

integer

Número de discos incluídos no backup

RecoveryPointMoveReadinessInfo

Nome Tipo Description
additionalInfo

string

isReadyForMove

boolean

RecoveryPointProperties

Propriedades do ponto de recuperação

Nome Tipo Description
expiryTime

string

Hora de expiração do ponto de recuperação em UTC.
isSoftDeleted

boolean

Bool para indicar se RP está no estado de exclusão reversível 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. Cópias de backup específicas da carga de trabalho são derivadas dessa classe.

Nome Tipo Description
eTag

string

ETag opcional.
id

string

A ID do recurso representa o caminho completo para o recurso.
location

string

Local do recurso.
name

string

Nome do recurso associado ao recurso.
properties RecoveryPoint:

Propriedades recoveryPointResource
tags

object

Marcas de recurso.
type

string

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

RecoveryPointTierInformationV2

Informações da camada do RecoveryPoint V2

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

Nome Tipo Description
Deleted

string

Disabled

string

Invalid

string

Rehydrated

string

Valid

string

RecoveryPointTierType

Tipo de camada de ponto de recuperação.

Nome Tipo Description
ArchivedRP

string

HardenedRP

string

InstantRP

string

Invalid

string

RestorePointType

Tipo de ponto de restauração

Nome Tipo Description
Differential

string

Full

string

Incremental

string

Invalid

string

Log

string

SnapshotCopyOnlyFull

string

SnapshotFull

string

SQLDataDirectory

Informações do SQLDataDirectory

Nome Tipo Description
logicalName

string

Nome lógico do arquivo
path

string

Caminho do arquivo
type

SQLDataDirectoryType

Tipo de mapeamento de diretório de dados

SQLDataDirectoryType

Tipo de mapeamento de diretório de dados

Nome Tipo Description
Data

string

Invalid

string

Log

string